Guillaume BOURGEOIS
239cc70672
7 commands: file/URL detonation, report summary + state, hash search, environment listing. API-key auth, stdlib-only. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
83 lines
3.2 KiB
YAML
83 lines
3.2 KiB
YAML
id: hybrid_analysis
|
|
name: Hybrid Analysis
|
|
version: 1.0.0
|
|
description: "Hybrid Analysis / CrowdStrike Falcon Sandbox (API v2) — detonate files and URLs, poll analysis state, retrieve report summaries, search by hash, and list sandbox environments. API-key authentication; stdlib-only, no extra Python dependencies."
|
|
changelog: "1.0.0 — Initial release: file/URL submission, report summary and state, hash search and environment listing."
|
|
category: enrichment
|
|
|
|
# The API key is sent in the 'api-key' header; Hybrid Analysis also requires a
|
|
# 'User-Agent: Falcon Sandbox' header (the scripts set it).
|
|
config_schema:
|
|
properties:
|
|
api_key:
|
|
type: string
|
|
description: "Hybrid Analysis API key"
|
|
x-soar-sensitive: true
|
|
required:
|
|
- api_key
|
|
|
|
commands:
|
|
- id: submit_file
|
|
name: hybrid-analysis-submit-file
|
|
description: "Submit a file (base64) for analysis in a sandbox environment. Returns a job/sha256; poll with hybrid-analysis-get-state."
|
|
inputs_schema:
|
|
properties:
|
|
file_name: { type: string, description: "File name" }
|
|
content_base64: { type: string, description: "File content, base64-encoded" }
|
|
environment_id: { type: number, description: "Sandbox environment ID (see hybrid-analysis-get-environments)" }
|
|
required: [file_name, content_base64, environment_id]
|
|
outputs_schema: { properties: {} }
|
|
- id: submit_url
|
|
name: hybrid-analysis-submit-url
|
|
description: "Submit a URL for analysis in a sandbox environment."
|
|
inputs_schema:
|
|
properties:
|
|
url: { type: string, description: "URL to detonate" }
|
|
environment_id: { type: number, description: "Sandbox environment ID" }
|
|
required: [url, environment_id]
|
|
outputs_schema: { properties: {} }
|
|
- id: get_result
|
|
name: hybrid-analysis-get-result
|
|
description: "Get the analysis report summary (verdict, threat score, signatures) by job/sha256 ID."
|
|
risk: read
|
|
inputs_schema:
|
|
properties:
|
|
job_id: { type: string, description: "Job ID or sha256:environment_id identifier" }
|
|
required: [job_id]
|
|
outputs_schema: { properties: {} }
|
|
- id: get_state
|
|
name: hybrid-analysis-get-state
|
|
description: "Get the current state of an analysis (IN_QUEUE, IN_PROGRESS, SUCCESS, ERROR)."
|
|
risk: read
|
|
inputs_schema:
|
|
properties:
|
|
job_id: { type: string, description: "Job ID or sha256:environment_id identifier" }
|
|
required: [job_id]
|
|
outputs_schema: { properties: {} }
|
|
- id: search_hash
|
|
name: hybrid-analysis-search-hash
|
|
description: "Look up existing analyses for a file hash (MD5, SHA1 or SHA256)."
|
|
risk: read
|
|
inputs_schema:
|
|
properties:
|
|
hash: { type: string, description: "File hash" }
|
|
required: [hash]
|
|
outputs_schema: { properties: {} }
|
|
- id: get_environments
|
|
name: hybrid-analysis-get-environments
|
|
description: "List the available sandbox environments and their IDs."
|
|
risk: read
|
|
inputs_schema:
|
|
properties: {}
|
|
required: []
|
|
outputs_schema: { properties: {} }
|
|
|
|
- id: test_connection
|
|
name: hybrid-analysis-test-connection
|
|
description: "Verify the API key (used by the Test button)."
|
|
risk: read
|
|
inputs_schema:
|
|
properties: {}
|
|
required: []
|
|
outputs_schema: { properties: {} }
|