Slack webhook integrations vs. native Slack integrations
There are two ways to integrate Cmd with Slack: the native Slack integration enables authorization requests and standard alerts, while custom Slack integrations enable custom alerts. Here is a full comparison of the two options:
- Enables authorization requests (i.e., enables a Cmd trigger action that makes server operators wait for someone to authorize their activity via your chosen Slack channel).
- Enables alerts.
- Does not allow customization of which CQL properties Cmd sends with alerts.
- Alerts are batched, and send every 60 seconds.
- Enables alerts only—no authorization requests.
- Allows customization of which CQL properties Cmd sends with alerts.
- Alerts are not batched, and send immediately.
To learn about setting up Slack webhook integrations, see the Slack webhook documentation. To learn about setting up native Slack integrations, read on:
Instructions: Set up a native Slack integration
A global admin must first enable the Slack integration globally.
To set up a native slack integration, you will need access to:
- The Slack workspace where authorization requests will appear.
- A Cmd manager or admin account.
For testing, you will also need access to:
- An SSH session on one of your Cmd-enabled servers.
Step one: Set up the Slack project integration
- Go to app.cmd.com.
- Click the current project's name in the top-right to open the drop-down menu.
- Select Project & app settings.
- From the menu on the left, select Integrations preferences.
- Select Slack.
- In the top-right corner, click Add to Slack.
- Select which Slack channel to add to the Cmd app. This will enable you to send alerts or authorization requests to the channel. If you don't see the intended channel in the drop-down list, type its name to search for it.
Step two: Test the integration
- Go to app.cmd.com.
- Select Triggers from the upper menu.
- Click Add Trigger.
- Build a trigger that you can easily fire to test the integration. (To learn more about triggers, see the triggers documentation.)
- Under the 'Actions' section, click + Add action.
- From the 'Authorization' column, select Slack authorization.
- Select the desired integration.
- Click Save at the top of the page.
- Open a terminal on a server in the Cmd project, and fire your new trigger.
- Check Slack to confirm that an authorization request appears in the appropriate channel, and approve it with a click.
- Confirm that the following appears in the terminal:
Authentication request for [session] has been AUTHORIZED