Slack
  • 28 May 2023
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Slack

  • Dark
    Light
  • PDF

Article Summary

This adapter fetches users and conversations from Slack using the API. It requires an authentication token associated with a user account that has read access to users. If using the Enterprise Grid Organization solution, additional permissions are required. The adapter also allows for configuring SSL verification and HTTPS proxy settings, as well as setting the number of parallel requests sent to Slack at any given time.

Slack is a chat and collaboration hub used to connect people, information, tools, and services.

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Users

Parameters

  1. Host Name or IP Address (required) - The hostname or IP address of the Slack server.
  2. Authentication Token (required) - An Authentication Token associated with a user account that has the Required Permissions to fetch assets.
  3. Enterprise Grid Organization - Select if you are using the Slack Enterprise Grid Organization solution.
    • If enabled, Axonius will fetch data from all workspaces associated with the authentication token.
    • If disabled, Axonius will fetch data from an a specific workspace associated with the authentication token.
  4. Verify SSL - Select whether to verify the SSL certificate offered by the value supplied in Host Name or IP Address. For more details, see SSL Trust & CA Settings.
  5. HTTPS Proxy (optional) - A proxy to use when connecting to the value supplied in Host Name or IP Address.
  6. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

SlackConnector

Advanced Settings

Note:

Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection, refer to ​Advanced Configuration for Adapters.

  1. Async chunks in parallel (required, default: 50) - Enter the number of parallel requests all connections for this adapter will send to the Slack server in parallel at any given point.
  2. Fetch deleted users (required, default: true) - Select to fetch deleted users. When cleared, only active users are fetched.
  3. Fetch user conversations - Select this option to fetch Slack conversations.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.


APIs

Axonius uses the Slack Web API.
To fetch conversations Axonius uses the following APIs:

Required Permissions

The value supplied in Authentication Token must have read access to users.

  • If you use the Slack Enterprise Grid Organization solution:

    1. Generate an authentication token. Steps are described here (after the Arguments section)
    2. In your app settings under OAuth & Permissions, add the following User Token Scopes:
      image.png
  • If you don't use the Slack Enterprise Grid Organization solution:

    1. In your app settings under OAuth & Permissions, add the following User Token Scopes:
      image.png
    2. Use the authentication token provided.
      image.png


    To fetch conversations the following permissions are required (for both sorts of Slack Solution):

    • channels:read
    • groups:read
    • mpim:read
    • im:read

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.