InsightCloudSec Docs

Welcome to the InsightCloudSec Docs!

InsightCloudSec by Rapid7 (formerly DivvyCloud) is a Cloud-Native Security Platform that provides real-time analysis and automated remediation for continuous security and compliance for your multi-cloud environment.

For questions reach out to us through [email protected].

Take Me to the Docs!    Release Notes

Slack Integration


DivvyCloud's integration with Slack provides you with the ability to send notification messages to Slack channels, and is compatible with all DivvyCloud resources.

An example of the use of this integration would be to generate and send high priority security alerts through Slack to a certain channel or channels when noncompliant security group rules are provisioned, such as SSH open to the world.


Integration Overview

For general information about Integrations (editing and deleting), refer to the Integrations Overview page.


Before getting started you will need to have the following:

  • A functioning DivvyCloud installation with an admin role
  • The appropriate permissions/access/approval to generate a Slack WebHook

If you need help with this integration, contact [email protected].

Configuring Your Slack Integration

The following instructions are for the steps required to generate an Incoming Webhook for integration into your DivvyCloud platform. You can review Slack's documentation on that process here.

Otherwise refer to the steps below:

1. From your Slack application, locate and click on the Apps option to open the Apps browser.

Slack Apps sectionSlack Apps section

Slack Apps section

2. Search for Incoming WebHooks and click **Add"". Clicking on "Add" should launch a separate browser window and the Incoming WebHooks page.

Selecting Add Incoming WebHooksSelecting Add Incoming WebHooks

Selecting Add Incoming WebHooks

3. Click on Add to Slack (or in some instances "Request to Add") - this will vary based on your local Slack configuration and may require coordination with your internal administrator or IT department.

Incoming WebHooksIncoming WebHooks

Incoming WebHooks

4. Choose a channel for posting (from the drop-down menu). Once you've selected your desired channel, the "Add Incoming WebHooks Integration" button will be enabled.


Selecting a Channel For Posting

This channel can be overwritten by the channel that you set up in the Bot Action titled "Send Slack Message". We recommend selecting a general channel here and then selecting the desired channel at the Bot Action level.

Selecting a Slack Channel for your Incoming WebHookSelecting a Slack Channel for your Incoming WebHook

Selecting a Slack Channel for your Incoming WebHook

5. Click the **Add Incoming WebHooks Integration" button to generate a new WebHook. Copy the WebHook URL and save it in a safe location (you will use this in Step 7).

Copy Your New WebHookCopy Your New WebHook

Copy Your New WebHook

6. Scroll down to the lower section of the Slack WebHook configuration page. Here you should update the following:

  • Descriptive Label (optional)
  • Customize Name
  • Icon (this will make it easier to identify) (For the icon you can open and save the image below.)

When you've made the changes you want, scroll to the bottom of the page and click to Save Settings.

DivvyCloud Logo for Your WebHookDivvyCloud Logo for Your WebHook

DivvyCloud Logo for Your WebHook


Precedence of Name Settings

The Name can be also updated at the Bot Action level, which will take precedence over the settings you add here.

Updating the Custom Settings in Your WebHookUpdating the Custom Settings in Your WebHook

Updating the Custom Settings in Your WebHook

7. Open DivvyCloud and launch Integrations under "Administration --> Integrations".

  • Select and open the Slack Integration by selecting Edit on the Slack card.
  • Paste the WebHook URL you copied in Step 5 and select Save.
Adding the Slack WebHook Into DivvyCloud from Integrations PageAdding the Slack WebHook Into DivvyCloud from Integrations Page

Adding the Slack WebHook Into DivvyCloud from Integrations Page

Using Slack WebHooks for System Health Notifications

In addition to adding a Slack WebHook through the DivvyCloud Integrations page, users can also include a Slack Integration/WebHook in DivvyCloud's System Settings. This capability enables Slack notifications for System Health. Users can select a cadence for the notifications and, as with the general WebHook integration/configuration, can specify a Slack channel.

To add this WebHook, from DivvyCloud navigate to "Administration --> System Administration" on the System tab.

System Administration - System SettingsSystem Administration - System Settings

System Administration - System Settings

Scroll to the "Health Notifications" content section (lower left) at the bottom of the page.

You can add your Slack WebHook here and your selected channel will receive notifications based on the cadence you select (Daily or Hourly).

Slack WebHook for Health NotificationsSlack WebHook for Health Notifications

Slack WebHook for Health Notifications

Configuring the "Send Slack Message" Bot Action

The following are the steps required to configure a Bot to verify the configuration of your Slack Integration. Refer to the following steps.

1. Go to the BotFactory page and click Create Bot.

2. Complete the Resource Type & Groups and Filters sections.

3. In the Actions section, click Add Action and find the 'Send Slack Message' action.

Configuring the Send Slack BotConfiguring the Send Slack Bot

Configuring the Send Slack Bot

4. Type in the name of the channel where you want to post the Slack message.

5. Type in the name that will be displayed when the message gets posted in Slack, e.g., 'DivvyCloud'.

6. Type in a value if you want to dynamically assign the recipient via one or more Tags.

7. Type in a value if you want to dynamically assign the recipient via one or more Badges.

Configuring the Bot ActionConfiguring the Bot Action

Configuring the Bot Action

8. Add content to the message that will be posted to Slack. You can include actionable information with Jinja2 formatting.

For example:

A resource of type ```{{resource.get_resource_type()}}``` was discovered at
```{{resource.common.creation_timestamp}}``` without the required *owner*
or *contact-email* tags. The resource name is ```{{resource.get_resource_name()}}```.
It lives in account ```{{resource.get_organization_service_name()}}```.

Updated 2 months ago

Other Helpful Pages


Slack Integration

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.