Example: Fugue Notifications in Slack

You can integrate Fugue notifications into Slack so that every time Fugue detects compliance, drift, or enforcement events in your environments, a message is sent to Slack.

_images/NotesSlack.png

Prerequisite: Create Fugue Notification

Note

If you have already set up a notification that you’d like to publish to Slack, skip ahead to Step 1: Create Slack Incoming Webhook.

  1. Create a Fugue notification. Make sure to create an SNS topic (FugueSNSTopic) if you haven’t already and specify its ARN as part of the workflow.

Step 1: Create Slack Incoming Webhook

  1. Create an incoming webhook in Slack.

Step 2: Create Lambda Function

  1. Log into AWS Lambda Management Console

  2. Select Create function (see Figure A)

    1. Select “Author from Scratch”

    2. Enter function name

    3. Select “Create a new role with basic Lambda permissions”

    4. Select “Create function” button to continue

  3. Paste lambda function code into index.js text box

  4. Enter Slack channel in line 9: '#fugue-notifications'

  5. Enter notification name in line 11: "*Dev us-west-2 Notifications*"

  6. Copy webhook URL starting from /services and paste into line 27: path: '/services/T02551234/BKG121234/kRg9RPLkdufOzYOT12345678'

Create Lambda function

Figure A: Create Lambda function

Step 3: Subscribe Lambda Function to FugueSNSTopic

  1. Log into SNS Management Console

  2. Select Subscriptions > Create subscriptions (see Figure B)

    1. Set Topic ARN to FugueSNSTopic ARN

    2. Set Protocol to AWS Lambda

    3. Set Endpoint to your Lambda function ARN

    4. Select “Create subscription” button to continue

Create Lambda function

Figure A: Create Lambda function

Step 4: Test the Integration

  1. Manually make a compliance, drift, or remediation change in your infrastructure based on how your Fugue notification is configured

  2. Initiate a scan

  3. Check your Slack channel for a post from the Fugue notification integration

Lambda Function Code

Before you paste the following code in AWS Lambda, complete the following steps:

  1. Replace #fugue-notifications with your Slack channel (line 9)

  2. Replace *Dev us-west-2 Notifications* with the name of your notification (line 11)

  3. Replace '/services/T02551234/BKG121234/kRg9RPLkdufOzYOT12345678' with your incoming webhook path (line 27)

var https = require('https');
var util = require('util');

exports.handler = function(event, context) {
    console.log(JSON.stringify(event, null, 2));
    console.log('From SNS:', event.Records[0].Sns.Message);

    var postData = {
        "channel": "#fugue-notifications",
        "username": "Fugue Notifications",
        "text": "*Dev us-west-2 Notifications*",
        "icon_emoji": ":rotating_light:"
    };

    var message = event.Records[0].Sns.Message;

    postData.attachments = [
        {
            "text": message
        }
    ];

    var options = {
        method: 'POST',
        hostname: 'hooks.slack.com',
        port: 443,
        path: '/services/T02554123/BLP5H1234/7tSULClE1hPYWBjU12345678'
    };

    var req = https.request(options, function(res) {
      res.setEncoding('utf8');
      res.on('data', function (chunk) {
        context.done(null);
      });
    });

    req.on('error', function(e) {
      console.log('problem with request: ' + e.message);
    });

    req.write(util.format("%j", postData));
    req.end();
};

Note

Code and basic instructions adapted from a Medium post from Cohealo.