Slack

To get started setting up your alerts you'll need to create a slack webhook app, and provide us with the webhook url to start receiving your alerts. Don't worry, this will only take a minute or two.

Create Slack Application

Follow the steps on slack's website to create a new webhook application while logged into your slack account.

1. Click https://api.slack.com/apps/new
2. Click "Create New App" and "From Scratch"
3. Fill in a name like "RunReveal" and select the desired slack workspace
4. Under "Add features and functionality" select "Incoming Webhooks".
5. If necessary, select "Activate Incoming Webhooks"
6. Click "Add Webhook to workspaces" and select the channel you want.
7. Copy the webhook!

Provide us with your webhook URL

Using the CLI or the web UI, provide us with your slack webhook URL.

Alert Color

Slack renders each RunReveal alert with a colored bar down the left side of the message. The Alert Color setting on the Slack channel controls that bar.

With a color applied, the alert arrives in Slack with a matching bar down the left edge:

You have two ways to set it:

• Use detection severity — turn this toggle on to color the bar automatically based on the triggering detection's severity (Critical, High, Medium, Low). Use this when you want the bar to reflect how urgent each alert is, so a channel receiving mixed-severity detections is color-coded at a glance.
• Custom color — leave the toggle off to use a single fixed color for every alert from this channel. Enter a hex color code (for example #FF0000) in the color field, or use the swatch to pick one. Leave the field blank to fall back to the default red.

This is a per-channel setting, so you can, for example, keep one Slack channel severity-colored and give another a fixed brand color.