Configuration

Slack Configuration

Setup the Slack app within the Slack API interface.

  1. Go to Slack workspace and the Slack Apps page displays.

  2. Click Create New App and the Create a Slack App popup displays.

    alt

  3. Type Secret Server Bot in the App Name text box.

  4. Click the Development Slack Workspace dropdown list to select your workspace.

  5. Click Create App and go to the App Credentials.

    image-20210511122742087

  6. Record the App ID and Signing Secret.

    Note: You can use the deprecated verification token instead (in the Bot Token text box in Secret Server), but we strongly recommend against it.

  7. Add them to the Secret Server configuration.

    a. Log on your Secret Server instance.

    b. Go to Admin > Show All, an alphabetized menu displays.

    c. Click Slack Integration and the Slack Integration page displays.

    image-20210511114044027 d. Click Edit.

    e. Select the Enabled check box.

    image-20210511114524051

    f. Enter your App ID in the App ID field.

    g. Enter your Signing Secret in the Signature Key field.

    Leave the Bot Token text box empty unless you entered the deprecated verification token.

  8. Scroll down to the Display Information section and enter the app name and description.

  9. Right click and save the following image.

    image-20201201123850428

  10. Set the icon for the app to the saved image. The completed section looks like the following.

    image-20201201112633374

  11. Click OAuth & Permissions in the left menu and scroll down to the Scopes section.

  12. Click Add an OAuth Scope to add the following scopes to the Bot Token Scopes.

    image-20201201124510630

  13. Click Bot User in the left menu.

  14. Enable the Always Show My Bot as Online toggle.

    alt

  15. Enable the Home Tab toggle.

    alt

  16. Go to the Incoming Webhooks section to enable the Incoming Webhooks toggle.

  17. Go to the Interactivity & Shortcuts section to enable the Interactivity toggle.

    alt

  18. Enter a link to your instance of Secret Server in the Request URL text box.

    https://<Secret Server instance>/api/v1/slack/interaction

  19. In the Shortcuts section, click Create New Shortcut to add a global shortcut called "Secret search".

  20. Type secretsearch for the Callback ID.

    Skip this step to prevent secret searches within Slack.

  21. Go to the Event Subscriptions section.

  22. Enable the Enable Events toggle.

  23. Enter a link to your instance of Secret Server in the Request URL text box.

    https://<Secret Server instance>/api/v1/slack/event

    When adding this URL, Slack confirms connectivity by sending a challenge message to your server. If any firewall or network connectivity issues are present, you cannot proceed past this point until the issues are resolved.

  24. In the Subscribe to bot events section click Add Bot User Event.

    alt

  25. Click Add Workspace Event to add the app_home_opened event.

    alt

  26. Go to the Install App in the left pane and click Install to Workspace.

  27. Install the app into one of your workspace channels. You can use #general because the Secret Server Bot does not send messages to any channels. Slack needs this association.

  28. Copy the Bot User OAuth Access Token into the Secret Server configuration.