Skip to main content

Configure Slack to receive alerts from Striim

Before Slack can receive alerts from Striim, you must create and install a Slack app.

  1. Log in to api.slack.com and select Create New App > From scratch.

  2. For App Name, enter SlackAlertAdapter.

  3. From Pick a workspace to develop your app in, select a workspace, then click Create App.

  4. In the Features section on the left navigation bar, click OAuth & Permissions

  5. In the Scopes section, configure the scopes for the bot token and user token as follows:

    • Bot: chat:write, chat:write.public

    • User: chat:write

  6. In the Settings section, click Install App.

  7. Click Allow.

  8. Save the OAuth token securely for later use.

To maintain authentication, you can use the OAuth token or a refresh token. The UI provides an option to enable or disable the use of refresh tokens for authentication renewal. When refresh tokens are disabled, use OAuth tokens. Striim recommends using refresh tokens.

Maintaining authentication with refresh tokens

Exchange the OAuth token for an access token and a refresh token. Access tokens have a set expiration time. Refresh tokens do not expire and can be exchanged for a new access token and another refresh token.

  1. In the Flow Designer, stop and undeploy your app.

  2. Select the app.

    The app configuration panel at the right side of the Flow Designer opens.

  3. In the app configuration panel, click Show Advanced Settings then toggle REFRESHTOKENRENEWAL.

    The Refresh Token, Client ID, and Client Secret fields appear.

  4. Paste the Client ID and Client Secret values into their respective fields.

    The Slack API Applications page enables you to copy these values to the clipboard.

  5. Open the Slack API app page. In Features > OAuth and Permissions, in the Advanced token security via token rotation section, click Opt In.

    A confirmation dialog box displays.

  6. In the confirmation dialog box, click Opt In.

  7. From a terminal command line, issue the following curl command.

    curl --location 'https://slack.com/api/oauth.v2.access' \
--data-urlencode 'client_id=<client ID value>' \ 
--data-urlencode 'client_secret=<client secret value>' \ 
--data-urlencode 'token=<token value>'

    The curl command returns a JSON object that contains several key/value pairs.

  8. Enter the value of the refresh_token key from the JSON object in the Striim Flow Designer UI.

    The Striim app uses this information to refresh the expiring access tokens.

Note

When you export the application with REFRESHTOKENRENEWAL toggled to the active position, the exported refresh token in the resulting TQL is already expired.