Slack

Overview

Firefly integrates with Slack to provide rich notifications for various events and alerts. This integration enables teams to receive real-time updates about infrastructure changes, policy violations, drift detection, and other important events directly in their Slack channels.

When integrating an Slack, you have two primary methods:

• Slack App

• Slack Webhook

Prerequisites

• A Slack workspace with administrative access

• Appropriate permissions to install apps or create webhooks

• Channels where you want to receive Firefly notifications

Setup Procedure

Slack App (Recommended Method)

1. In Firefly, select Settings > Integrations

2. Select Add New > Slack (under messaging integrations)

3. Select Slack App from the Integration type field

4. Click to install the Firefly Slack application

5. Authorize the app in your workspace

6. Select the desired channel for notifications

7. Configure notification settings in Firefly

Slack Webhook (Legacy Method)

Note: This integration is deprecated. We recommend using the Slack App integration.

1. Generate a webhook URL for your Slack channel:

   • Visit the Incoming Webhooks page

   • Select Add to Slack

   • Choose a channel

   • Select Add Incoming Webhooks integration

   • Copy the Webhook URL

2. In Firefly, select Settings > Integrations

3. Select Add New > Slack

4. Select Slack Webhook from the Integration type field

5. Enter a descriptive name in the Nickname field

6. Paste the webhook URL

7. Select Next > Done

Features Enabled

• Real-time Notifications: Receive immediate alerts for important events

• Rich Message Formatting: Detailed, formatted messages with direct links to Firefly

• Customizable Alerts: Configure which events trigger notifications

• Channel-specific Routing: Send different types of alerts to different channels

• Interactive Messages: Click through to Firefly directly from Slack notifications

Best Practices

• Use the Slack App integration method over webhooks when possible

• Create dedicated channels for different types of notifications

• Configure notification rules to avoid alert fatigue

• Regularly review and update notification settings

• Ensure the Firefly bot is invited to all relevant channels

Troubleshooting

1. For Slack App issues:

   • Verify the app is properly authorized

   • Check if the bot user is present in the channel

   • Ensure notification settings are properly configured

2. For Webhook issues:

   • Verify the webhook URL is valid and not expired

   • Check channel permissions

   • Confirm the webhook hasn't been deactivated

3. For notification issues:

   • Review notification rules in Firefly

   • Check Slack's notification settings

   • Verify channel message permissions