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