Team Cymru Scout Enrich Incident

Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊

↑ Back to Content Index


This playbook will fetch and ingest IP or Domain Indicator data based on Entity mapped in Microsoft Sentinel Incident and notify to pre-defined or user customizable email id.

Attribute Value
Type Playbook
Solution Team Cymru Scout
Source View on GitHub

Logic App Connectors

This playbook uses 5 Logic App connectors / built-in actions:

Connector / Action Type Connections Actions
azureloganalyticsdatacollector Managed 1 6
azuremonitorlogs Managed 1 6
azuresentinel Managed 1 4
outlook Managed 1 2
http Built-in 0 2
Action parameters (URLs, paths, function IDs)

azureloganalyticsdatacollector (Managed)

Action Method Endpoint Other
Send_Top_Fingerprints_Data_To_Log_Analytics_Table post /api/logs —
Send_Open_Ports_Section_Data_To_Log_Analytics_Table post /api/logs —
Send_Top_Pdns_Data_To_Log_Analytics_Table post /api/logs —
Send_Whois_Data_To_Log_Analytics_Workspace post /api/logs —
Send_Insights_Data_To_Log_Analytics_Table post /api/logs —
Send_IP_Indicator_To_Live_Investigation_Indicators_Table post /api/logs —

azuremonitorlogs (Managed)

Action Method Endpoint Other
Run_Query_and_List_Results_for_Top_PDNS post /queryData —
Run_Query_and_List_Results_for_Top_Open_Ports post /queryData —
Run_Query_and_List_Results_for_Top_Fingerprints post /queryData —
Run_Query_and_List_Results_for_Whois post /queryData —
Run_Query_And_List_Insights_Data_And_Country_Code_For_Indicator post /queryData —
Run_Query_And_Check_Whether_This_is_First_Execution_Or_Not post /queryData —

azuresentinel (Managed)

Action Method Endpoint Other
Add_IP_Data_Into_Incident_Comment post /Incidents/Comment —
Add_Comment_Limit_Has_Been_Exceeded_To_100_For_Incident_ post /Incidents/Comment —
Add_Domain_Data_Into_Incident_Comment post /Incidents/Comment —
Add_Comment_Limit_Has_Been_Exceeded_For_Incident post /Incidents/Comment —

outlook (Managed)

Action Method Endpoint Other
Send_An_Email_For_IP post /v2/Mail —
Send_An_Email_For_Domain post /v2/Mail —

http (Built-in)

Action Method Endpoint Other
HTTP_Request_To_Fetch_Details_Of_IP_Indicator GET @{variables('base_url')}/api/scout/ip/@{items('For_Each_IP_Address')}/details —
HTTP_Request_To_Fetch_Details_Of_Domain_Indicator GET @{variables('base_url')}/api/scout/search —

Additional Documentation

📄 Source: TeamCymruScoutEnrichIncident/readme.md

Summary

This playbook will fetch and ingest IP or Domain Indicator data based on Entity mapped in Microsoft Sentinel Incident and notify to pre-defined or user customizable email id.

Prerequisites

  1. User should have an outlook mail account in order to use this playbook.

Deployment instructions

  1. To deploy the Playbook, click the Deploy to Azure button. This will launch the ARM Template deployment wizard.
  2. Fill in the required parameters:

Deploy to Azure Deploy to Azure

Post-Deployment instructions

a. Authorize connections

Once deployment is complete, authorize each connection.

  1. Go to your logic app → API connections → Select azureloganalyticsdatacollector connection resource
  2. Go to General → Edit API connection.
  3. Enter Workspace ID and Workspace Key of your log analytics workspace.
  4. Click Authorize
  5. Sign in.
  6. Click Save.
  7. Repeat steps for other connections.

b. Assign Role to add a comment in the incident

After authorizing each connection, assign a role to this playbook.

  1. Go to Log Analytics Workspace → your workspace → Access Control → Add
  2. Add role assignment
  3. Assignment type: Job function roles
  4. Role: Microsoft Sentinel Contributor
  5. Members: select managed identity for "assigned access to" and add your logic app as a member.
  6. Click on review+assign

Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊

↑ Back to Playbooks · Back to Team Cymru Scout