Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊
This playbook will fetch and ingest IP or Domain Indicator data based on input parameters given in the live investigation dashboard.
| Attribute | Value |
|---|---|
| Type | Playbook |
| Solution | Team Cymru Scout |
| Source | View on GitHub |
This playbook uses 3 Logic App connectors / built-in actions:
| Connector / Action | Type | Connections | Actions |
|---|---|---|---|
azuremonitorlogs |
Managed | 1 | 1 |
http |
Built-in | 0 | 28 |
workflow |
Built-in | 0 | 2 |
azuremonitorlogs (Managed)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Run_Query_And_Check_Whether_This_is_First_Execution_Or_Not | post | /queryData |
— |
http (Built-in)| Action | Method | Endpoint | Other |
|---|---|---|---|
| Send_Proto_By_IP_Sections_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('proto_by_ip_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Top_Asns_By_IP_Sections_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('top_asns_by_ip_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Top_Certs_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('certs_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Top_Country_Codes_Sections_Data_To_Log_Analytics_Table_Name | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('top_country_codes_by_ip_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Top_Fingerprints_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('fingerprints_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Open_Ports_Section_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('open_ports_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Top_Pdns_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('pdns_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Top_Services_By_IP_Sections_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('top_services_by_ip_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Top_Tags_By_IP_Sections_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('top_tags_by_ip_table_name'), '_CL?api-version=2023-01-01')} |
— |
| HTTP_Request_To_Fetch_Proto_By_IP_Sections_Data | GET | @{variables('base_url')}/api/scout/ip/@{variables('indicator_value')}/details |
— |
| HTTP_Request_To_Fetch_Top_Asns_By_IP_Sections_Data | GET | @{variables('base_url')}/api/scout/ip/@{variables('indicator_value')}/details |
— |
| HTTP_Request_To_Fetch_Top_Country_Codes_By_IP_Sections_Data | GET | @{variables('base_url')}/api/scout/ip/@{variables('indicator_value')}/details |
— |
| HTTP_Request_To_Fetch_Top_Services_By_IP_Sections_Data | GET | @{variables('base_url')}/api/scout/ip/@{variables('indicator_value')}/details |
— |
| HTTP_Request_To_Fetch_Top_Tags_By_IP_Sections_Data | GET | @{variables('base_url')}/api/scout/ip/@{variables('indicator_value')}/details |
— |
| Send_IP_Indicator_Data_To_IP_Details_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('summary_details_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Identity_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('identity_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Whois_Data_To_Log_Analytics_Workspace | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('whois_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_IP_Indicator_To_Live_Investigation_Indicators_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('ip_indicators_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Insights_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('insights_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Communication_Peers_Data_To_Log_Analytic_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('communication_peers_data_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Main_PDNS_Data_To_Log_Analytic_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('main_pdns_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Main_Open_Ports_Data_To_Log_Analytic_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('main_opn_ports_data_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Main_Fingerprints_Data_To_Log_Analytic_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('main_fingerprints_data_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Main_X509_Data_To_Log_Analytic_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('main_x509_data_table_name'), '_CL?api-version=2023-01-01')} |
— |
| HTTP_Request_To_Fetch_Details_Of_IP_Indicator | GET | @{variables('base_url')}/api/scout/ip/@{variables('indicator_value')}/details |
— |
| HTTP_Request_To_Fetch_Details_Of_Domain_Indicator | GET | @{variables('base_url')}/api/scout/search |
— |
| Send_Domain_Data_To_Log_Analytics_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('domain_details_table_name'), '_CL?api-version=2023-01-01')} |
— |
| Send_Domain_Indicator_To_Live_Investigation_Indicators_Table | POST | @{concat(parameters('dataCollectionEndpoint'), '/dataCollectionRules/', parameters('dcrImmutableId'), '/streams/Custom-', variables('domain_indicators_table_name'), '_CL?api-version=2023-01-01')} |
— |
workflow (Built-in)| Action | Method | Endpoint | Other |
|---|---|---|---|
| TeamCymruScoutCreateIncidentAndNotifyForFirstRun | — | — | workflowId=[concat('/subscriptions/', subscription().subscriptionId, '/resourceGroups/',resourceGroup().name,'/providers/Microsoft.Logic/workflows/',trim(parameters('CreateIncidentAndNotifyPlaybookName')))]triggerName= manual |
| TeamCymruScoutCreateIncidentAndNotify | — | — | workflowId=[concat('/subscriptions/', subscription().subscriptionId, '/resourceGroups/',resourceGroup().name,'/providers/Microsoft.Logic/workflows/',trim(parameters('CreateIncidentAndNotifyPlaybookName')))]triggerName= manual |
This playbook will fetch and ingest IP or Domain Indicator data based on input parameters given in the live investigation dashboard.
This playbook writes to Log Analytics through the Logs Ingestion API using its own system-assigned managed identity. The data collection endpoint, the data collection rule, the destination tables and the Monitoring Metrics Publisher role assignment are all created by the deployment template, so ingestion needs no manual authorization.
Existing workspaces only. If you deployed an earlier version of this playbook, its tables were created by the retired HTTP Data Collector API and are classic tables. Convert them once per workspace before the first run of the migrated playbook, otherwise ingestion fails:
resourceGroup="<resource-group>"
workspace="<workspace-name>"
# List the classic tables still present in the workspace
az monitor log-analytics workspace table list \
--resource-group "$resourceGroup" --workspace-name "$workspace" \
--query "[?schema.tableSubType=='Classic'].{Name:name}" -o table
# Convert each one, using the table name exactly as returned by the list
# command above (it already includes the _CL suffix, e.g. Communication_Data_CL —
# do not append _CL again)
az monitor log-analytics workspace table migrate \
--resource-group "$resourceGroup" --workspace-name "$workspace" \
--table-name "<TableName>"
The conversion cannot be undone. It is a one-way operation per table.
This playbook writes the following tables:
Communication_Data_CLDomain_Data_CLFingerprints_Data_CLIdentity_Data_CLInsights_Data_CLLive_Investigation_Domain_Indicators_CLLive_Investigation_IP_Indicators_CLOpen_Ports_Data_CLPDNS_Data_CLProto_By_IP_Data_CLSummary_Details_CLSummary_Details_Top_Certs_Data_CLSummary_Details_Top_Fingerprints_Data_CLSummary_Details_Top_Open_Ports_Data_CLSummary_Details_Top_Pdns_Data_CLTop_Asns_By_IP_Data_CLTop_Country_Codes_By_IP_Data_CLTop_Services_By_IP_Data_CLTop_Tags_By_IP_Data_CLWhois_Data_CLX509_Data_CLColumn names and types are unchanged, so existing parsers, workbooks and saved queries keep working.
Once deployment is complete, authorize each connection.
Browse: 🏠 · Solutions · Connectors · Methods · Tables · Content · Parsers · ASIM Parsers · ASIM Products · Logic Apps · 📊