Corgea’s Slack integration allows you to receive notifications in your Slack workspace when a scan is completed using Slack’s Workflow Builder.

​
Prerequisites

Before setting up the integration, ensure you have:

  • Administrative access to your Corgea account
  • Appropriate permissions in your Slack workspace

​
Setting Up Slack Workflow Builder

This method provides flexibility by allowing you to create custom workflows that can route notifications to different channels or trigger other automated actions.

1

Create a Workflow

  1. In Slack, click on your workspace name
  2. Select “Tools” → “Workflow Builder”
  3. Click “Create” to start a new workflow
  4. Select “Webhook” as the trigger
  5. Give your workflow a name and click “Next”
2

Configure Workflow Steps

  1. After creating the webhook, copy the provided Webhook URL
  2. Add steps to your workflow (e.g., “Send a message”)
  3. Configure the message format using variables from the webhook payload

Here’s an example payload that Corgea would send over.

      {
    "title": "🐕 Corgea scan is complete!",
    "user": "john@example.com",
    "project": "My Project",
    "num_issues": 10,
    "severity_counts": {
      "HIGH": 2,
      "MEDIUM": 3,
      "LOW": 5
    },
    "scan_url": "https://corgea.app/scan/?scan_id=123",
    "message": "The Corgea scan for project My Project has completed with 10 issues found.\n🔴 - 2 high severity issues\n🟠 - 3 medium severity issues\n🟡 - 5 low severity issues\n\nView full scan details at: https://corgea.app/scan/?scan_id=123"
  }

You can use our canned message or create your own using variables.

  1. Click “Add a Step” and then select “Finish Up”
    • Sending messages to multiple channels
    • Creating reminders
    • Updating channel topics
    • Integrating with other Slack apps
  2. Make sure the workflow details and permission are correct before publishing.
3

Configure in Corgea

  1. Log in to your Corgea account and go to “Integrations”
  2. Find the Slack section and click “Add Integration”
  3. Select “Slack Workflow”
  4. Enter a name for the integration
  5. Paste the Workflow Webhook URL
  6. Click “Save”
  7. Click “Test” to ensure the integration is working

​
Notification Content

Corgea will send the following information to your Slack workflow:

  • User who initiated the scan
  • Project name
  • Number of issues found
  • Severity breakdown
  • Direct link to scan results

​
Customization Options

With Workflow Builder, you can:

  • Create conditional logic for different types of notifications
  • Route messages to different channels based on severity
  • Trigger custom automations based on scan results
  • Integrate with other Slack workflows and apps
  • Use variables to customize message format and content

​
Additional Resources

By configuring the Workflow Builder integration, you can ensure your team stays informed about security scan results and take advantage of Slack’s automation capabilities for a more streamlined security workflow.