Slack integration

Overview

The Slack integration allows you to receive real-time security alerts and notifications directly in your Slack channels. This enables your team to respond quickly to security incidents and stay informed about important events.

Prerequisites

• Slack workspace with admin permissions
• Bloo platform access credentials
• Webhook URL or bot token for Slack

Configuration Steps

1. Create Slack App

1. Go to api.slack.com/apps
2. Click "Create New App"
3. Choose "From scratch"
4. Enter app name and select workspace
5. Click "Create App"

2. Configure Bot Permissions

Add the following OAuth scopes:

• chat:write - Send messages to channels
• channels:read - Read channel information
• groups:read - Read private channels
• im:read - Read direct messages
• mpim:read - Read group direct messages

3. Install App to Workspace

1. Go to "OAuth & Permissions" in your app settings
2. Click "Install to Workspace"
3. Authorize the app
4. Copy the Bot User OAuth Token

4. Configure Bloo Integration

1. Log into your Bloo platform dashboard
2. Navigate to Integrations > Slack
3. Click "Configure Integration"
4. Enter your Slack Bot Token
5. Select channels for different alert types
6. Test the connection and save

Alert Configuration

Channel Mapping

Configure which channels receive different types of alerts:

• High Priority Alerts: #security-incidents
• Medium Priority Alerts: #security-alerts
• Low Priority Alerts: #security-info
• Daily Summaries: #security-daily

Message Format

Customize alert message format:

• Include severity level
• Add relevant context
• Include action buttons
• Link to Bloo dashboard

Supported Alert Types

• Security Incidents: Immediate threat notifications
• Vulnerability Alerts: New vulnerability discoveries
• Compliance Updates: Policy violations and updates
• System Status: Platform health and maintenance

Best Practices

1. Use dedicated channels for security alerts
2. Set up appropriate notification schedules
3. Configure message threading for related alerts
4. Use Slack reactions for acknowledgment
5. Regularly review and update channel configurations

Troubleshooting

Common Issues:

1. Messages not sending

   • Verify bot token is correct
   • Check bot permissions
   • Ensure bot is invited to channels

2. Permission errors

   • Review OAuth scopes
   • Check workspace permissions
   • Verify app installation

3. Rate limiting

   • Implement message queuing
   • Use appropriate delays
   • Monitor API usage