Slack (for Enterprise Grid)
Slack is a cloud-based proprietary instant messaging platform developed by Slack Technologies.
These integration instructions are for users integrating with Slack using the Enterprise Grid.
| • | Information Stored |
| • | Minimum Permissions Required |
| • | Authentication Method |
| • | Credentials Required |
| • | Integrating Slack (for Enterprise Grid) with SaaS Management |
| • | API Endpoints |
The following table describes the available integration tasks and stored data.
|
Integration Task |
Information Stored |
|||||||||||||||
|
Application Roster |
|
|||||||||||||||
|
Application Access |
|
Note:The information stored is subject to change as enhancements are made to the product. Application Access data is available after 3 days. Therefore, the data in the Slack Portal may not match the data in SaaS Management for application access.
Minimum API required permissions are based on the Scopes Required and User Role .
|
Scopes Required |
Description |
Integration Task Name |
|
Admin |
It allows access to SCIM API. For details, refer to Slack’s Scopes and Permissions. |
Application Roster |
|
users:read |
This scope is required to retrieve all the users from Slack Enterprise Grid. For details, refer to Slack’s Scopes and Permissions. |
Application Roster |
|
admin.analytics:read |
This scope is required to view analytics information about members of enterprise grid workspaces. For details, refer to Slack’s admin.analytics:read documentation. |
Application Access |
|
User Role |
Description |
|
Org Owner |
Org owner permission is required to grant the above scopes during the Integration authorize flow. The app requesting this scope must be installed by an Org Owner of an Enterprise Grid organization. In addition, the app must be installed on the entire org, not on an individual workspace. For details, refer to Slack’s admin.analytics:read documentation. |
OAuth2 with Authorize Flow. For details, refer to the Slack instructions Using OAuth 2.0.
| • | Workspace URL |
| • | Username |
| • | Password |
Note:Username and Password are required only for authorization. These values are not stored in SaaS Management.
Integrating Slack (for Enterprise Grid) with SaaS Management
To integrate Slack (for Enterprise Grid) with SaaS Management, obtain the following.
To integrate Slack (for Enterprise Grid) with SaaS Management, obtain the following:
| 1. | Obtain your Slack Workspace URL, which is the same URL you use to sign in to your Slack account. You can also find the Workspace URL from your portal. |
| a. | Sign in to your Slack account as a Workspace Admin. |
| b. | Click the drop-down menu beside the organization name. The field with the format XYZ.slack.com gives the Workspace URL. |
| 2. | In SaaS Management, add the Slack Enterprise Grid application. Refer to Adding an Application. |
| 3. | Click Authorize, which redirects you to the Slack portal. |
| 4. | In the Slack portal, enter your Workspace URL. |
| 5. | Sign in with Org Owner credentials. |
| 6. | In the Slack (for Enterprise Grid) Permissions requested window, click Allow to authorize. |
Application Roster
https://api.slack.com/scim/v1/Users
Application Access
https://slack.com/api/admin.analytics.getFile