Slack Integration with SMARTFENSE

This article details the procedure to integrate a Slack Workspace with the SMARTFENSE platform using a configuration manifest.

Initial Setup in Slack

1. Go to https://api.slack.com/apps/new/.

2. Select the option From an app manifest.

3. Choose the Slack Workspace you want to integrate with SMARTFENSE.

Configuration Manifest

Copy the following content and paste it into the configuration mode shown in Slack:

display_information:

  name: Demo INSTANCE

  description: Information Security Awareness

features:

  bot_user:

    display_name: Demo INSTANCE

    always_online: false

oauth_config:

  scopes:

    bot:

      - chat:write

      - users:read

      - users:read.email

settings:

  org_deploy_enabled: false

  socket_mode_enabled: false

  token_rotation_enabled: false

Press the Create button to generate the Slack app.

App Configuration in Slack

1. In the newly created Slack App, go to the Interactivity & Shortcuts section.

   • Paste the following value into the Request URL field:
     https://instancename.takesecurity.com/slack-webhook/

2. Then, go to the Install App section.

   • Copy the value of Bot User OAuth Token.

3. Paste the Bot User OAuth Token into the SMARTFENSE platform to complete the integration.

💡 Best Practices

• Verify that the selected Workspace is correct before creating the app.

• Ensure you have administrative permissions in Slack to perform the installation.

• Keep the Bot User OAuth Token in a secure environment and do not share it with third parties.

• If changes are made to the manifest, reinstall the app for them to take effect.