Skip to main content
Skip table of contents

Slack

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:

  1. Go to https://api.slack.com/apps and create a new application.

  2. From the left pane, select OAuth & Permissions.

  3. In the OAuth & Permissions page, scroll down to the Scopes pane.

  4. In the Scopes pane, go to Token Scopes and add the following:

    • admin.teams:read

    • admin.user:read

    • user:read

    • users:read.email

  5. Generate an authentication token. Steps are described here (after the Arguments section)

If you are NOT using the Slack Enterprise Grid Organization solution:

  1. Go to https://api.slack.com/apps and create a new application.

  2. From the left pane, select OAuth & Permissions.

  3. In the OAuth & Permissions page, scroll down to the Scopes pane.

  4. In the Scopes pane, go to User Token Scopes and add the following:

    • user:read

    • users:read.email

  5. Scroll back up to the OAuth Tokens for Your Workspace pane. Click Install to Workspace.

  6. When prompted, click Allow.

  7. 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

API Documentation

https://api.slack.com/apis

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.