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

Information Stored

The following table describes the available integration tasks and stored data.

Available Integration Tasks

Integration Task

Information Stored

Application Roster

User ID
Email
First Name
Last Name
Active Date

Application Access

User ID
Last Active

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 Permissions Required

Minimum API required permissions are based on the Scopes Required and User Role .

Scopes Required

Scopes Required

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

User Role

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.

Authentication Method

OAuth2 with Authorize Flow. For details, refer to the Slack instructions Using OAuth 2.0.

Credentials Required

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.

API Endpoints

Application Roster

https://api.slack.com/scim/v1/Users

Application Access

https://slack.com/api/admin.analytics.getFile