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

With the Slack integration, 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.

{% 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="75%" %}
Go to ***Integrations*** > [***Data Sources***](https://app.sola.security/integrations/data-sources) > click ***New data source*** > select ***Slack***.

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

{% column width="25%" %} <a href="https://app.sola.security/integrations/data-sources?integration=slack" class="button primary">Set up Slack -></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)" %}
Available for both Slack Enterprise+ (aka Enterprise Grid) and Slack Business+ accounts.

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

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

#### 6. 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 **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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.