What You Get
Scan Complete
A summary of every scan: total findings, severity breakdown, and per-scanner counts (SAST, SCA, IaC, secrets, containers).
Zero-Day Alerts
Instant notifications when newly disclosed vulnerabilities affect packages already in your projects.
Weekly Reports
A 7-day summary of open findings, new vulnerabilities, and resolved issues per project.
Monthly Reports
A monthly rollup with severity distribution and trend indicators to share with stakeholders.
Prerequisites
- You must have Administrator or Manager privileges on the CybeDefend organization (the
manage_integrationpermission). - You must be a workspace admin in Slack, or have permission to install Slack apps in your workspace.
The Slack integration is configured at the organization level. Once connected, every project in the organization can map a channel — but each project can only target a single channel.
1. Connect Your Slack Workspace
Open Organization Integrations
From the CybeDefend dashboard, go to your Organization settings → Integrations, then click Slack.
Click Connect to Slack
A Slack authorization window opens. You will be asked to choose the workspace to install the CybeDefend app into.
Authorize the CybeDefend App
Slack will list the permissions the app needs:
chat:write— post messages in channels the app is a member ofchannels:read— list public channels in the workspacegroups:read— list private channels the app is invited to
2. Map a Channel to a Project
Each project routes its notifications to one Slack channel. The mapping is configured from the project itself.Pick a Slack Channel
Click the Slack channel selector. A searchable dropdown lists all accessible channels in the connected workspace — public channels and private channels the app has been invited to.
Private channels: The CybeDefend bot cannot auto-join private channels. You must invite it manually with
/invite @CybeDefend inside the channel before notifications can be delivered.Notification Anatomy
All CybeDefend Slack messages share a consistent layout: a colored sidebar indicating severity, a header with the project name, a compact breakdown, and an action button that deep-links into the CybeDefend dashboard.| Color | Meaning |
|---|---|
| 🔴 Red | At least one Critical finding |
| 🟠 Orange | At least one High finding |
| 🟡 Yellow | At least one Medium finding |
| 🔵 Blue | Only Low findings, or informational |
| 🟢 Green | Clean scan — no vulnerabilities |
Example: Scan Complete
Example: Zero-Day Alert
Permissions Reference
| Action | CybeDefend permission | Scope |
|---|---|---|
| Connect / disconnect Slack | manage_integration | Organization |
| List workspace channels | manage_integration | Organization |
| Map a channel to a project | manage_integration + update | Organization + Project |
| View a project’s mapped channel | start_scan | Project |
Disconnect Slack
Disconnecting Slack removes the integration and all project channel mappings in the organization.Security & Privacy
Encrypted Tokens
The Slack bot token is encrypted at rest using AES-256-GCM before being stored in CybeDefend’s database.
Least-Privilege Scopes
The integration requests only the scopes needed to list channels and post messages — no message reading, no user identity scopes.
No Code in Messages
CybeDefend never sends source code, secrets, or vulnerable file contents to Slack. Messages only include metadata (counts, severities, CVE IDs, deep links).
Revoke Anytime
Disconnecting from CybeDefend revokes the bot token. You can also remove the app directly from your Slack workspace admin panel.
Troubleshooting
No notifications are arriving
No notifications are arriving
- Verify the workspace is still Connected in Organization settings → Integrations.
- Confirm the project has a channel mapped (Project → Settings → Notifications).
- For private channels, ensure the CybeDefend bot has been invited with
/invite @CybeDefend. - Check that your organization is not in a read-only billing state — notification dispatch is gated by writability.
The channel selector is empty
The channel selector is empty
- The bot lists public channels and private channels it is already a member of. Invite the bot to any private channel you want to use.
- If even public channels are missing, try disconnecting and re-installing the Slack app to refresh the workspace token.
Installation popup closes without connecting
Installation popup closes without connecting
- Verify popups are not blocked for the CybeDefend dashboard origin.
- Make sure your Slack workspace allows installation of third-party apps. If admin approval is required, your request is pending in the Slack admin console.
`not_in_channel` error
`not_in_channel` error
The bot tried to post in a channel it is not a member of. For public channels, re-select the channel in the project settings — CybeDefend will attempt to auto-join. For private channels, invite the bot manually.
Related: Managing Vulnerabilities · Policy Management · Account Setup