Configuration

Slack Configuration

Set up 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 the app ID and signing secret to the Secret Server configuration:

    1. In Secret Server, navigate to Settings.

    2. In the upper-right corner of the All settings page, enter Slack into the search box.

    3. In the search results, select Slack integration.

    4. Select Slack Integration to open the Slack Integration page.

    5. On the Slack Integration page, select Edit and configure the following settings:

      • Enable Secret Interactions and Enable Inbox Notifications: Select these checkboxes.

      • App Id: Enter the app ID that you specified for the Slack app.

      • Signature Key: Enter the signing secret that you specified for the Slack app.

      • Bot Token: Leave this box empty unless you entered a deprecated verification token.

    6. To save the integration settings, select Save.

  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.