Skip to main content

Secure Slack Workspaces with Mondoo

You can configure Mondoo to continuously monitor your Slack workspace security. Mondoo scans find misconfigurations and vulnerabilities that put your organization at risk. You deploy the Mondoo Slack integration once and always get the latest security assessments.


Create an API token to give Mondoo access to the Slack workspace

To access the configuration details of your Slack workspace, Mondoo needs an API token. You create this token on the Slack website and provide it to Mondoo when you set up your integration.

  1. On the Slack API website, go to Your Apps.

  2. Select the Create an App button.

Slack Create an app dialog

  1. Select From scratch.

Slack Name app & choose workspace dialog

  1. In the App Name box, enter a name for your new app, such as mondoo-security.

  2. In the Pick a workspace to develop your app in list, choose the workspace you want to secure with Mondoo.

  3. Select the Create App button. The Basic Information page for the new app opens.

Slack app settings - Basic Information page

  1. Under Add features and functionality, select Permissions. The OAuth & Permissions page for the new app opens.

Slack app settings - OAuth and permissions page

  1. Scroll down to Scopes and locate User Token Scopes.

Slack app settings - user token scopes

  1. Add all of these permissions by repeating the tasks of (a) selecting the Add an OAuth Scope button and (b) selecting a permission:

    • channels:read

    • groups:read

    • im:read

    • mpim:read

    • team:read

    • usergroups:read

    • users:read

  2. Once you have added all the permissions, scroll up to OAuth Tokens for Your Workspace and select the Install to Workspace button. Slack confirms the permissions.

Slack app permissions confirmation

  1. Select the Allow button. The OAuth & Permissions page displays again and now there is a token under OAuth Tokens for Your Workspace.

Slack OAuth token

  1. In the User OAuth Token box, select the Copy button. You need this token in the next section; save it somewhere handy.

Set up a Slack integration

  1. Access the Integrations > Add > Slack page in one of two ways:

    • New space setup: After creating a new Mondoo account or creating a new space, the initial setup guide welcomes you. Select BROWSE INTEGRATIONS and then under SaaS, select Slack.

      Welcome to Mondoo Page

    • INTEGRATIONS page: In the side navigation bar, under INTEGRATIONS, select Add New Integration. Under SaaS, select Slack.

      Add a Slack Integration in Mondoo

  2. In the Choose an integration name box, enter a name for the integration. Make it a name that lets you easily recognize the Slack repository.

  3. In the Enter the API token box, paste the Slack token you generated in the previous section.

  4. Select the START SCANNING button.

  5. On the Recommended Policies page, enable the policies on which you want to base assessments of your Slack workspace. To learn more, read Manage Policies.

    Mondoo begins scanning your Slack workspace and, when completed, presents results on the INVENTORY page.

Learn more

For more information, explore the complete Mondoo Slack Resource Pack Reference.