Microsoft Sentinel

Access Levels: Advanced | Enterprise

The Censys connector for Microsoft Sentinel (formerly known as Azure Sentinel) enables you to connect Attack Surface Management (ASM) logbook and risk events with Sentinel. This allows you to monitor your attack surface events in the analytics platform of your choice.

Prerequisites

Before you begin, make sure you have your Workspace ID and Primary key from Microsoft Sentinel. To find this information:

  1. Go to Microsoft Sentinel and navigate to your Log Analytics Workspace.
  2. Select the workspace, then select Agents.
  3. Click the Log Analytics agent instructions.

Configure the integration in Censys ASM

  1. Go to the Censys ASM web console, then click Integrations.
  2. Locate Microsoft Sentinel and click Set Up.
  3. Configure the following:
    1. Workspace ID: Enter the Workspace ID you obtained from your Microsoft Sentinel Log Analytics page.

    2. Primary key: Enter the Primary key you obtained from your Microsoft Sentinel Log Analytics page.

  4. Click Connect at the bottom of the page. Then, click Next Step in the upper right corner.
  5. On the Default Set Up page, select whether you want to receive logbook events, risk events, or both inside Microsoft Sentinel.
  6. Click Submit, then click Done.

Modify the integration

If you need to make changes to your integration, follow the configuration steps above.

Query examples

The integration automatically polls Censys for new events, which are sent to Microsoft Sentinel.

Risk events

Open critical risks:

Censys_Risks_CL 
| where Severity_s =~ "Critical" 
| where Risk_Event_Operation_s =~ "Open" 
| where Status_s =~ "Open" 
| sort by Last_Seen_t

Count of risks by name:

Censys_Risks_CL
| summarize Count = count() by Display_Name_s
| order by Count desc

Logbook events

Associated hosts:

Censys_Logbook_CL
| where Operation_s =~ "ASSOCIATE"

Disassociated hosts:

Censys_Logbook_CL
| where Operation_s =~ "DISSOCIATE"

Configuration Options

The following tables detail the objects sent to the custom log analytics tables.

Risk events

Censys_Risks_CIDescription
Risk Event IDThe ID of the Risk Event.
Risk Event OperationThe Operation of the Risk Event:
  • open - the item was created
  • update - something about the item was changed
  • close - the item was "closed" (generally only relevant for risk instances)
TimestampThe timestamp of the risk event.
Risk Instance IDIdentifier for a specific risk instance.
Display NameHuman-readable display name for a risk instance.
SeveritySeverity for a risk instance:
  • Critical
  • High
  • Medium
  • Low
StatusState of the risk instance:
  • Open - the risk instance is observed
  • Closed - the risk instance is no longer observed
First SeenTimestamp when the risk was first observed in the workspace.
Last SeenTimestamp when the risk was last observed in the workspace.
Impacted AssetThe asset impacted by the risk.

Logbook Events

Censys_Risks_CIDescription
Event IDThe ID of the Logbook Event.
Event TypeThe type of event from Logbook:
  • Host
OperationThe operation of the event:
  • Associate
  • Dissociate
IP AddressThe host associated with the event.
TimestampTimestamp when the event occurred.