Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Channels

A channel is a configured destination where Odin Scan delivers notifications. Each channel has a type (Slack or email), a name, and the configuration details needed to reach that destination.

You can create multiple channels and assign them to different alert policies. For example, a #security-critical Slack channel for urgent findings and an email channel for weekly summaries sent to the whole team.

Channel Fields

FieldDescription
NameA human-readable label for the channel (e.g., “Security Team Slack”)
TypeEither Slack or Email
ConfigurationWebhook URL for Slack, or recipient email addresses for email
EnabledWhether the channel is active and available for alert policies

Setting Up a Slack Channel

Slack notifications use incoming webhooks. You create a webhook in your Slack workspace and paste the URL into Odin Scan.

Step 1: Create a Slack App

  1. Go to api.slack.com/apps and sign in to your workspace.
  2. Click Create New App.
  3. Select From scratch.
  4. Enter a name for the app (e.g., “Odin Scan Alerts”) and select the workspace where you want notifications to appear.
  5. Click Create App.

Step 2: Enable Incoming Webhooks

  1. In the app settings sidebar, click Incoming Webhooks.
  2. Toggle the Activate Incoming Webhooks switch to On.
  3. Click Add New Webhook to Workspace at the bottom of the page.
  4. Select the Slack channel where you want notifications posted (e.g., #security-alerts).
  5. Click Allow.
  6. Copy the generated webhook URL. It looks like https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX.

Step 3: Add the Channel in Odin Scan

  1. In the Odin Scan dashboard, navigate to Alerts > Channels.
  2. Click New Channel.
  3. Select Slack as the channel type.
  4. Paste the webhook URL you copied from Slack.
  5. Enter a descriptive name (e.g., “Security Team Slack”).
  6. Click Save.
  7. Click Test to send a test notification and verify the webhook is working.

If the test message appears in your Slack channel, the setup is complete.

Setting Up an Email Channel

Email channels send styled HTML notifications to one or more recipients.

  1. In the Odin Scan dashboard, navigate to Alerts > Channels.
  2. Click New Channel.
  3. Select Email as the channel type.
  4. Enter one or more recipient email addresses.
  5. Enter a descriptive name (e.g., “Dev Team Email”).
  6. Click Save.
  7. Click Test to send a test notification and verify delivery.

Check recipient inboxes (and spam folders) to confirm the test email arrived.

Slack Message Format

Slack notifications use Block Kit formatting for a structured, readable layout:

  • Header – the repository name and branch that was analyzed.
  • Finding counts – color-coded severity indicators showing the number of Critical, High, Medium, Low, and Informational findings.
  • View Report button – a direct link to the full analysis report in the Odin Scan dashboard.

The message is designed to give you an at-a-glance summary without leaving Slack.

Email Format

Email notifications are sent as styled HTML with the following structure:

  • Subject line – includes the repository name and a brief summary (e.g., “Odin Scan: 2 Critical findings in myorg/contracts”).
  • Severity breakdown table – a table showing finding counts for each severity level with visual indicators.
  • View Full Report button – a prominent link to the full report in the dashboard.
  • Footer – a link to manage notification preferences.

Managing Channels

From the Alerts > Channels view, you can:

  • Edit – update the channel name, webhook URL, or email recipients.
  • Enable / Disable – toggle a channel on or off without deleting it. Disabled channels are skipped during notification dispatch.
  • Delete – permanently remove a channel. Any alert policies referencing the deleted channel are automatically disabled.

Next Steps