What is Slack? #
Slack is a messaging app for business that includes chat and collaboration tools.
Why Should You Use the Slack Connector? #
The Slack connector provides visibility into the assets in your environment. You can use this visibility to:
-
ensure assets are managed per your security policies
-
derive relationships between assets, users, applications, and data
How Does This Connector Work? #
Lucidum executes read-only requests to the Slack REST API and ingests only meta-data about Slack devices. Lucidum does not retrieve any data stored on your assets.
Configuring the Connector in Lucidum #
Field |
Description |
Example |
---|---|---|
URL |
The base URL for the slack service. |
https://slack.com |
API token |
An API token for a new Slack app with read access to API data. |
************ |
Source Documentation #
Creating an API Token #
Before configuring the Slack connector in Lucidum, you must first create a slack app and an API token for the app. Lucidum will use the API token to access the Slack API.
If you are using the Slack Enterprise Grid Organization solution:
-
Go to https://api.slack.com/apps and create a new application.
-
From the left pane, select OAuth & Permissions.
-
In the OAuth & Permissions page, scroll down to the Scopes pane.
-
In the Scopes pane, go to Token Scopes and add the following:
-
admin.teams:read
-
admin.user:read
-
user:read
-
users:read.email
-
-
Generate an authentication token. Steps are described here (after the Arguments section)
If you are NOT using the Slack Enterprise Grid Organization solution:
-
Go to https://api.slack.com/apps and create a new application.
-
From the left pane, select OAuth & Permissions.
-
In the OAuth & Permissions page, scroll down to the Scopes pane.
-
In the Scopes pane, go to User Token Scopes and add the following:
-
user:read
-
users:read.email
-
-
Scroll back up to the OAuth Tokens for Your Workspace pane. Click Install to Workspace.
-
When prompted, click Allow.
-
In the OAuth Tokens for Your Workspace pane, you will find the User OAuth Token. Copy this. The Lucidum connector will use this Token to communicate with Slack.
Required Permissions #
Contact your Lucidum Sales Representative for help with permissions.
If you are using Slack Enterprise Grid Organization:
Object |
Permissions |
---|---|
User Token Scope > OAuth Scope |
admin.teams:read |
User Token Scope > OAuth Scope |
admin.users:read |
User Token Scope > OAuth Scope |
users:read |
User Token Scope > OAuth Scope |
users.read:email |
If you are NOT using Slack Enterprise Grid Organization:
Object |
Permissions |
---|---|
User Token Scope > OAuth Scope |
users:read |
User Token Scope > OAuth Scope |
users.read:email |