Links
📧

Self-Hosted Slack Integration

You can use Slack to get notified about anomalies in your Kubernetes cluster using alerts.
While Ddosify Cloud allows you to integrate your Slack workspace into Ddosify seamlessly, you need to follow some steps to do the same on Ddosify Self-Hosted. Here’s how you can do so:
Note: This doc is only applicable to Ddosify Self-Hosted Enterprise Edition. Ddosify Self-Hosted Community Edition does not support alerts and integrations.

Creating A Slack App

To create a Slack integration for Ddosify Self-Hosted, you need to create a Slack application. Go to Slack Apps. You need to sign in to your Slack workspace.
  1. 1.
    Click on “Create New App”.
Slack app creation
  1. 2.
    Choose “From scratch”.
Slack app creation
  1. 3.
    Give it a name (you can type in Ddosify) and choose a workspace you already logged in.
  2. 4.
    Click on “Create App”.
  3. 5.
    Go to “OAuth & Permissions” from the tabs on the left.
Slack app management tabs
  1. 6.
    Scroll down to “Scopes”.
Empty bot token scopes
  1. 7.
    Click on “Add an OAuth Scope” in the “Bot Token Scopes” part.
  2. 8.
    Add the following permissions:
  • channels:join
  • channels:read
  • chat:write
  • groups:read
  • im:read
  • mpim:read
  1. 9.
    After that, your “Bot Token Scopes” should look like this:
Correct bot token scopes
  1. 10.
    Then click on “Install to Workspace” under the section “OAuth Tokens for Your Workspace”
The button to add the slack app to workspace
  1. 11.
    You will be redirected to a Slack page asking for permissions on your selected workspace. Click on “Allow” to continue.
Slack workspace permission page
  1. 12.
    Then, in the “OAuth Tokens for your Workspace” section, you will see a “Bot User OAuth Token”. Copy it and paste it on Slack integration creation in Ddosify.
An example bot user OAuth token
Congratulations!
🎉
You've successfully configured your Slack app. Now there remain only a few steps to connect it to Ddosify.

Setting Up The Slack App in Ddosify

  1. 1.
    After you create your Slack application, go to the integrations section in Ddosify Self-Hosted EE. You can find it here:
Ddosify Self-Hosted pages
  1. 2.
    After that, click on “Add Integration”. A pop-up will show up:
Slack app pop-up
  1. 2.
    Here, provide a name for your integration, paste the Bot User OAuth Token you copied from the earlier step, and click on “Make Integration”. This will take you to the channel selection page.
Note: If your Bot Token is correct, you will be able to see the channels present in your Slack workspace. If your token is invalid, this channel dropdown will be stuck at loading. In that case, you can delete the integration and retry.
Slack channel selection dropdown
  1. 3.
    After you choose a channel and click on “Save Channel”, your slack app will join that channel and will be able to send messages there.
  2. 4.
    Once successful, you can test your integration by clicking “Test Integration”. If you are able to see the test message sent to your selected Slack channel, that means you've successfully set up your Slack app and you can start to use this integration in your alerts.
Test integration button
This is what you will see if your integration works successfully:
Example Slack test message
If you require assistance with setting up Slack integration for Ddosify Self-Hosted, you can join our Discord or send an email to [email protected].