# Slack

In this guide, you will create an API token in Slack to pull Slack user IDs and send messages to users. These messages will allow users to respond to suspicious login alerts to understand if they have been impacted.

At the end of this configuration, you will provide Radiant Security with these values:

* **Access Token** (Bot User OAuth Token) (for example `xoxb-123123123321-529...`)

### Generate the Bot User OAuth Token

1. Sign into [Slack](https://slack.com/oauth/v2/authorize?client_id=2179644537937.5282173714550\&scope=chat:write,im:read,im:write,users:read,users:read.email,chat:write.customize\&user_scope=).
2. If your Slack Workspace requires admin approval for adding apps, then you will submit a request for installation to Slack. If not, then skip to step 3.\
    ![](https://2439665791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsFulb2ZOtSPcRSc2rXE%2Fuploads%2FA0AgnJwv3DMH2YTD2S0e%2FSlack_01.png?alt=media\&token=916fde96-97d6-484e-bd08-7646efebfeee)
3. After your request to install has been approved, you will receive a Slack notification that will allow you to continue the installation. 

<figure><img src="https://2439665791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsFulb2ZOtSPcRSc2rXE%2Fuploads%2FNBQQNHyvRV6rKlvhF7e8%2FSlack_02.png?alt=media&#x26;token=593ce53f-0f97-4c28-ad66-a826bc2643dd" alt=""><figcaption></figcaption></figure>

3. Click **Allow** to allow Radiant Security access to the workspace. If you are a part of multiple workspaces, you will be asked to select and log into the one you choose.
4. You will be redirected to a page that contains the Bot User OAuth Token required for the configuration of the Radiant Security Slack connector. Ensure that you save the **Bot User OAuth Token** as you will need it for the upcoming step.

   <figure><img src="https://2439665791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsFulb2ZOtSPcRSc2rXE%2Fuploads%2F3B3GXpW98amv7QasC8lH%2FSlack_03.png?alt=media&#x26;token=eb744f6d-5248-4d5d-9c74-bf3116701ba5" alt=""><figcaption></figcaption></figure>

### Add the credentials in Radiant Security

1. Log in to [Radiant Security](https://app.radiantsecurity.ai/).
2. From the navigation menu, select **Settings** > **Credentials** and click **+ Add Credential**.
3. Select the **Slack** vendor from the list and click **Configure Credential.**
4. Under **Credential Name**, give the credential an identifiable name (e.g. `Slack Credentials`).
5. Under **Required** **Credentials**, add the **Bot User OAuth Token** that you copied from the previous step.
6. Click **Add Credential** to save the changes.

### Review app management settings

In Slack's **App Management Settings**, toggle **Off** the **Only allow apps from the Slack App Directory** settin&#x67;**.** This will add The Radiant app to the workspace.

<div align="left"><figure><img src="https://2439665791-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsFulb2ZOtSPcRSc2rXE%2Fuploads%2FizPNR1JMkQ76mS89flte%2FSlack_04.png?alt=media&#x26;token=f7e9d7b9-a6fb-48f8-8b5c-a5a3632e3a51" alt="" width="375"><figcaption></figcaption></figure></div>

### Approve for this workspace

Once the app is installed, now it also will require to be approved to be added to the Slack workspace. Go to **Slack Admin Page > Configure Apps**, and select **Approve for this workspace**.