ANY.RUN Sandbox - URL Enrichment - Incident Trigger

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

↑ Back to Content Index


On a Microsoft Sentinel incident, collects URL entities and submits each URL to ANY.RUN Sandbox. Adds analysis comments to the incident and uploads extracted IOCs to Microsoft Sentinel Threat Intelligence.

Attribute Value
Type Playbook
Solution ANYRUN
Source View on GitHub

Logic App Connectors

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

Connector / Action Type Connections Actions
azuresentinel Managed 1 7
keyvault Managed 1 1
http Built-in 0 4
Action parameters (URLs, paths, function IDs)

azuresentinel (Managed)

Action Method Endpoint Other
Entities_-_Get_URLs post /entities/url —
Add_comment_to_incident_-_Analysis_Started_URL post /Incidents/Comment —
Update_incident_-_Add_Tags_URL put /Incidents —
Threat_Intelligence_-Upload_Indicators_of_Compromise(V2)_-_Suspicious_IOCs_URL post /V2/ThreatIntelligence/@{encodeURIComponent(triggerBody()?['workspaceId'])}/UploadIndicators/ —
Threat_Intelligence_-Upload_Indicators_of_Compromise(V2)_-_Malicious_IOCs_URL post /V2/ThreatIntelligence/@{encodeURIComponent(triggerBody()?['workspaceId'])}/UploadIndicators/ —
Add_comment_to_incident_(V3)_-ANY.RUN_Output-_URL post /Incidents/Comment —
Add_comment_to_incident_(V3)_-_Clean_Scan_URL_ANY.RUN_Output post /Incidents/Comment —

keyvault (Managed)

Action Method Endpoint Other
Get_secret_-_ANYRUN get /secrets/@{encodeURIComponent('ANYRUN-APIKey')}/value —

http (Built-in)

Action Method Endpoint Other
HTTP-RunNewURLAnalysis POST https://api.any.run/v1/analysis —
HTTP-Full-JSON-Report_URL GET https://api.any.run/v1/analysis/@{variables('Task ID')} —
HTTP-GetIOC_URL GET https://api.any.run/report/@{variables('Task ID')}/ioc/json —
HTTP-CheckURL-Result GET https://api.any.run/v1/analysis/monitor/@{variables('Task ID')} —

Additional Documentation

📄 Source: Sandbox-URL/readme.md

ANY.RUN — Sandbox URL

ANY.RUN

Summary

When a Microsoft Sentinel incident is created, this playbook:

Prerequisites

Shared prerequisites (Key Vault secret ANYRUN-APIKey, App Registration, API permissions, and role assignments) are described in the solution README.

Additional requirements for this playbook:

Deployment

Click below to deploy Azure Logic App with Flex Consumption plan

Deploy to Azure

Enter the parameters required for deploying the Logic App and click Review + create.

logic_app_deployment

Description of the required parameters:

Parameter Description
PlaybookName Logic App name (default ANYRUN-Sandbox-URL).
Azure Tenant ID Tenant ID for authentication in connections.
Azure Client ID Client ID of the App Registration created for the solution.

Post-deployment

Authorize API connections

After deployment, open the Logic App and authorize the API connections created by the template:

Edit each connection, sign in with an account that has the required permissions, and save.

Playbook steps

  1. The playbook is triggered when a Microsoft Sentinel incident is created.
  2. It retrieves URL entities from the incident.
  3. It obtains the ANY.RUN API key from Key Vault.
  4. For each URL it sends an HTTP request to the ANY.RUN API to start analysis.
  5. It monitors the analysis until completion, then retrieves the report and IOCs.
  6. It adds a comment to the incident containing the verdict, threat score, tags, IOC table, and a link to the analysis session.
  7. Detected IOCs are uploaded to the Microsoft Sentinel Threat Intelligence portal.

The URL analysis parameters are defined in the HTTP action that starts the analysis. You can adjust them (timeout, browser, OS, interactivity, etc.) in the Logic App designer or code view. See the ANY.RUN API documentation for the full list of parameters.

Logic App configuration (Optional)

ANY.RUN Sandbox analysis parameters

ANY.RUN is an interactive online malware analysis service for dynamic and static research of most types of threats using a customizable VM environment. We offer a connector for Microsoft Sentinel, which you can independently adapt to your infrastructure and needs in just a few clicks. You can easily change the parameters used for analyzing the required URL.

Note:
You can learn more about the capabilities of ANY.RUN Sandbox by reviewing our API documentation.

The main setup and customization of the Logic App is available through the graphical editor (Development tools > Logic app designer) or the code editor (Development tools > Logic app code view).

The URL analysis parameters in ANY.RUN Sandbox are defined in the HTTP-RunNewURLAnalysis action.

analysis_action

Analysis options are specified in the HTTP request body.

analysis_parameters

Description of the default parameters:

Parameter Name Description
obj_type Specifies the type of the new task (the value "url" is required for this workflow).
opt_timeout Defines the timeout option for the analysis.
obj_ext_browser Indicates the browser name to use.
env_os Specifies the operating system.
env_bitness Defines the bitness of the operating system.
env_version Sets the version of the operating system.
opt_automated_interactivity Controls the automated interactivity (ML) option (changing this is not recommended).
auto_confirm_uac Enables automatic confirmation of Windows UAC requests (changing this is not recommended).

Note:
You can add more parameters for analysis. To see the full list of available parameters and their values, visit our API documentation.

[Content truncated...]


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

↑ Back to Playbooks · Back to ANYRUN