> For the complete documentation index, see [llms.txt](https://docs.sola.security/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sola.security/integrations/data-sources/slack.md).

# Slack

Connect Sola and Slack to get security insights

## Overview <a href="#overview" id="overview"></a>

The Slack integration connects data from your Slack account to your Sola workspace, making it easy to search and find answers to your specific use cases. Sola offers two integrations, Slack Enterprise+ and Slack Business+.

With the Slack integrations, you can:

* Gain full visibility into every member of your Slack organization.
* Review workspace ownership and discoverability across your Slack organization.
* See which members hold administrative roles in your organization.
* Monitor admin activity and sign-in events across your organization.
* Reconcile Slack accounts and groups against your identity provider's SCIM records.
* Track third-party apps approved, blocked, or requested in your organization.

With Slack Enterprise+, you can also:

* Gain full visibility into every member of your Slack organization.
* Review workspace ownership and discoverability across your Slack organization.
* See which members hold administrative roles in your organization.
* Monitor admin activity and active sessions across your organization.
* Track third-party apps approved, blocked, or requested in your organization.

{% hint style="info" %}
**Slack plans and integrations**

* **Slack Enterprise+ (aka Enterprise Grid):** Slack's plan for multiple workspaces managed together as one organization. Imports organization-level data, such as member security posture, admin role assignments, audit logs, and app approvals, in addition to workspace data.
* **Slack Business+:** Slack's plan for a single workspace. Imports workspace data, such as members, sign-in activity, app and integration changes, and SCIM provisioning.

Use the integration that matches your Slack plan.
{% endhint %}

{% hint style="warning" %}
**Your data can only be retrieved, never modified.**

Once connected, your data is securely stored, and access is restricted to retrieving configurations and metadata only. Authentication methods ensure secure delegation of permissions while maintaining data integrity.
{% endhint %}

## Set up Slack data source integration with Sola <a href="#set-up-wiz-data-source-integration-with-sola" id="set-up-wiz-data-source-integration-with-sola"></a>

{% columns %}
{% column width="66.66666666666666%" %}
Go to ***Integrations*** > [***Data Sources***](https://app.sola.security/integrations/data-sources) > click ***New data source*** > select ***Slack Enterprise+*** or ***Slack Business+***.

*The Sola wizard will take you through the steps.*
{% endcolumn %}

{% column width="33.33333333333334%" %} <a href="https://app.sola.security/integrations/data-sources?integration=slackenterprise" class="button primary">Set up Slack Enterprise+ -></a>

<a href="https://app.sola.security/integrations/data-sources?integration=slackbusiness" class="button primary">Set up Slack Business+ -></a>
{% endcolumn %}
{% endcolumns %}

### Connect Slack to Sola

To connect Slack, you'll need admin access to your Slack workspace or Enterprise Grid organization.

{% tabs %}
{% tab title="Slack Enterprise+ (aka Enterprise Grid)" %}
To connect Slack Enterprise+, you'll need admin access to your Slack Enterprise+ (aka Enterprise Grid) organization.

This method uses a Slack App to grant Sola scoped, permission-based access to your Slack workspace. It reduces the risks associated with user tokens and long-lived credentials by enforcing granular permission scopes and using Slack's OAuth-based authentication.

* Slack App (Recommended)\
  Install Sola's Slack App to securely and easily grant access to your organization's Slack workspace.
* Custom Slack App\
  Create and install your own Slack App for full control over permissions and configuration (see how-to guide below)

*Not sure which method to choose?* We recommend starting with the Slack App for the fastest and most reliable setup.
{% endtab %}

{% tab title="Slack Business+" %}
To connect Slack Business+, you'll need admin access to your Slack Business+ workspace.

This method uses a Slack App to grant Sola scoped, permission-based access to your Slack workspace. It reduces the risks associated with user tokens and long-lived credentials by enforcing granular permission scopes and using Slack's OAuth-based authentication.

* Slack App (Recommended)\
  Install Sola's Slack App to securely and easily grant access to your organization's Slack workspace.
* Custom Slack App\
  Create and install your own Slack App for full control over permissions and configuration (see how-to guide below)

*Not sure which method to choose?* We recommend starting with the Slack App for the fastest and most reliable setup.
{% endtab %}
{% endtabs %}

<details>

<summary>How do I set up a Slack data source using a Custom Slack App for Slack Enterprise+ (aka Enterprise Grid)?</summary>

Complete the following steps to set up and configure your Slack App to integrate Sola with Slack Enterprise+ (aka Enterprise Grid).

{% hint style="info" %}
[Learn more about creating Slack Apps](https://api.slack.com/quickstart).
{% endhint %}

#### 1. Create your Slack App

* In your Slack [apps page](https://api.slack.com/apps), click ***Create New App***, and select ***From scratch***.
* Set an ***App Name*** (Sola Integration), select a workspace, and click ***Create App***.

#### 2. Configure permissions

* Go to ***OAuth & Permissions*** > ***Scopes***.
* In the ***Bot Token Scopes*** select ***Add an OAuth Scope*** and add the following required scopes:
  * `users.profile:read` - View profile details about people in a workspace.
  * `team:read` - View the name, email domain, and icon for a workspace.
  * `users:read` - View people in a workspace.
  * `users:read.email` - View email addresses of people in a workspace.
* In the ***User Token Scopes*** select ***Add an OAuth Scope*** and add the following required scopes:
  * `users.profile:read` - View profile details about people in a workspace.
  * `team:read` - View the name, email domain, and icon for a workspace.
  * `users:read` - View people in a workspace.
  * `users:read.email` - View email addresses of people in a workspace.
  * `admin` - Administer a workspace.
  * `admin.apps:read` - View apps and app requests in a workspace.
  * `admin.roles:read` - List role assignments for your workspace.
  * `admin.teams:read` - Access information about a workspace.
  * `admin.users:read` - Access a workspace's profile information.
  * `auditlogs:read` - View events from all workspaces, channels and users (Enterprise orgs only).
  * `team:read` - View the name, email domain, and icon for workspaces your Slack app is connected to.
  * `users:read` - View people in a workspace.
  * `users:read.email` - View email addresses of people in a workspace.

#### 3. Enable org-readiness

* Go to ***Org Level Apps***, and enable the ***Enable org-readiness*** toggle.

#### 4. Install the Slack App

* Go to ***Install App***, and click ***Install to Organization***, and copy your **User OAuth Token** and **Bot User OAuth Token**.

#### 5. Paste the *Bot User OAuth Token* and *User OAuth Token* in the Sola wizard

#### 6. Install the custom app on relevant workspaces

Set up and configure your Slack App to install Sola across your Enterprise+ (aka Enterprise Grid) workspaces.

* Open the [Slack admin console](https://app.slack.com/manage/).
* Go to **Integrations** > **Installed Apps**.
* Select the option to **Add to more workspaces** on the custom slack app you created.
* Select the relevant workspaces.
* Review the permissions, and add the app.

#### 7. Click *Test Connection* to validate the details and continue

</details>

<details>

<summary>How do I set up a Slack data source using a Custom Slack App for Slack Business+?</summary>

Complete the following steps to set up and configure your Slack App to integrate Sola with Slack Business+.

{% hint style="info" %}
[Learn more about creating Slack Apps](https://api.slack.com/quickstart).
{% endhint %}

#### 1. Create your Slack App

* In your Slack [apps page](https://api.slack.com/apps), click ***Create New App***, and select ***From scratch***.
* Set an ***App Name*** (Sola Integration), select a workspace, and click ***Create App***.

#### 2. Configure permissions

* Go to ***OAuth & Permissions*** > ***Scopes***.
* In the ***Bot Token Scopes*** select ***Add an OAuth Scope*** and add the following required scopes:
  * `users.profile:read` - View profile details about people in a workspace.
  * `team:read` - View the name, email domain, and icon for workspaces your Slack app is connected to.
  * `users:read` - View people in a workspace.
  * `users:read.email` - View email addresses of people in a workspace.
* In the ***User Token Scopes*** select ***Add an OAuth Scope*** and add the following required scopes:
  * `users.profile:read` - View profile details about people in a workspace.
  * `team:read` - View the name, email domain, and icon for workspaces your Slack app is connected to.
  * `users:read` - View people in a workspace.
  * `users:read.email` - View email addresses of people in a workspace.
  * `admin` - Administer a workspace.

#### 3. **Install the Slack App**

* Go to ***Install App***, and click ***Install to Workspace***, and copy your **User OAuth Token** and **Bot User OAuth Token**.

#### 4. Paste the *Bot OAuth Token* and *User OAuth Token* in the Sola wizard

#### 5. Click *Test Connection* to validate the details and continue

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sola.security/integrations/data-sources/slack.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
