Receptors & Integrations
      Back to home
      1. Trustero Support
      2. Trustero User Guide
      3. Receptors & Integrations

      Slack Receptor Instructions

      How to setup and configure the Trustero Slack Receptor

      The Slack receptor allows you to attach Slack messages from selected channel(s) as evidence to controls you select. 

      Slack Application Setup

      1. Create or Access Your Slack App

      • Navigate to the Slack API Apps Dashboard. (https://api.slack.com/apps/)
      • Create a new Slack App:
        • Click "Create New App" and follow the prompts to create a new app. (Suggested name: "Trustero")

      2. Add Bot Scopes

      1. Go to your app's "OAuth & Permissions" section from the left-hand menu.
      2. Scroll down to the "Scopes" section.
      3. Under the "Bot Token Scopes" subsection:
        • channels:history
        • channels:read
        • users:read

      3. Install Your App

      1. Scroll to the "OAuth Tokens for Your Workspace" section.
      2. If the app is not already installed:
        • Click the "Install App to Workspace" button.
        • You will be redirected to a permissions page. Review and approve the app's requested permissions.
      3. After installation, you will be redirected back to your app's dashboard. (The following example shows a Trustero Slack App into a Interstice Labs workspace)
      4. After allowing the application, a Bot User OAuth Token will be generated for your application

      4. Invite the Slack Application Bot To Channel(s)

      1. In your Slack workspace navigate to the channel
      2. Add the Slack Application Bot to the channel by Clicking Add People or mentioning the @Slack Application Bot in a message
        • Note: Invite the Slack Application Bot to every channel whose messages you want to retrieve using the Trustero receptor

      Best Practices

      1. Use dedicated channels to ensure that the messages within the channel address a specific control. Segregate the channels per utility / environment / control.
      2. When addressing a specific alarm, use the threads for the alarm instead of replying to the root of the channel to avoid collecting unnecessary messages on root.

       

      Control Setup Example

      IM02 Application Monitoring - Errors and Crashes

      It needs a list of alerts as evidence. These could be tracked as messages in Slack. To provide evidence for the control, simply associate it with the IM02 control in the Trustero Slack Receptor to the channel that contains the alerts sent to Slack.

      1. Map control(s) to channel(s) - Slack receptor config with IM02 mapped to Alarms Channel 

      2. Slack Conversation evidence is automatically added to control(s) - Application Alerts on IM02 from Slack Receptor

      3. (Optional) Download the Table CSV to view the whole extracted messages in the evidence