1. Censys
  2. Censys Attack Surface Management
  3. ASM Integrations

Other Articles In This Section

See more

In this article

Slack Integration Guide

 

EMAdvEnterprisePLans.png

Overview

You can integrate Censys Attack Surface Management (ASM) with Slack to send Slack messages when ASM observes a new risk on the attack surface. Use these messages to support triage, prioritization, and remediation.


How to integrate Slack with Censys ASM

Prerequisites

  • You must have an active Slack subscription.
  • You will need the Channel ID for the Slack channel where these messages will be sent.
    • We recommend creating a separate channel for these messages. See Slack's documentation for instructions on creating a Slack channel.
  • You will need the Slack user and Slack API credentials for the user that will be sending the messages.
    • The username that configures the integration will be displayed as the sender for the risk notifications.

Step 1: Get your Slack channel ID

  1. In Slack, navigate to the channel you plan to use for this integration.
  2. Click the channel name to open the channel details panel. The channel ID is at the bottom of the panel:
    slack-channel-id.png
    • Save the Channel ID in a secure location, as you will need it in the next steps.

Step 2: Configure the integration in Censys ASM

  1. Log in to Censys ASM, then click Integrations at the top of the page.
  2. Locate Slack and click Set Up.
  3. On the Authentication page, configure your settings:
    • Is this a classic Slack app?: Select whether you are using a classic or modern version of Slack.
    • Custom OAuth profile: Select whether you are using a custom OAuth profile.
      SlackIntegrationStep1.png
  4. Click Connect, then click Next Step.
  5. On the Default Set Up page, configure the following:
    • Channel ID: Enter the channel ID where you want to send the Slack messages.
    • Notification Type: Select whether you want to receive an alert for every risk event in real time, and/or receive a daily Risk Digest of all new risks in your attack surface.
    • Include Assets: Select whether to show assets, such as IP addresses and domains, in the notifications.
      slack-setup.png
  6. Click Next Step.
  7. On the Filters page, select the risk severities you want to send alerts for.
  8. Click Submit, then click Close.

Modifying the integration

If you need to make changes to your integration settings:

  1. Log in to Censys ASM, then click Integrations at the top of the page.
  2. Locate Slack and click Manage.
  3. Go through the setup wizard, as described in the section above, and make any necessary changes.

Related articles