Hybrid Analysis
App Vendor: Hybrid Analysis
App Category: Data Enrichment & Threat Intelligence, Forensics & Malware Analysis
Connector version: 1.2.0
API Version: 2.0.0
About App
Hybrid Analysis is a cloud-based sandboxing solution. In Orchestrate, Hybrid Analysis allows the users to analyze the files and identify the malicious nature of the file that is uploaded to the service in a virtual sandbox environment. Users can also lookup file hash to get details about the API key or malware samples.
The Hybrid Analysis app is configured with the Orchestrate application to perform the following actions:
Action Name | Description |
---|---|
Quick File Scan | This action performs a Quick File Scan using the path of the file and scan type provided by the hybrid analysis sandbox application. |
Quick URL Scan | This action performs a Quick URL Scan using URL and additional fields from the hybrid analysis sandbox application. |
Get Report Status of Sandbox Submission | This action obtains the report status of a sandbox submission. |
Get a Report of Sandbox Submission | This action obtains a report summary of the sandbox submission. |
File Submission for Sandbox Analysis | This action submits a file for sandbox analysis. |
Get Historical Hash from URL | This action determines a SHA256 that an online file or URL submission will have when being processed by the system. |
URL Submission for Sandbox Analysis | This action submits a URL for scanning in sandbox analysis. |
Search Hash Details | This action searches for hash details and the summary of a file hash. |
Get Hash Overview | This action obtains an overview of the SHA256 hash. |
Get the Summary of Hash | This action obtains the summary of the SHA256 hash. |
Get the Result of a Quick Scan | This action obtains the result of a quick scan using scan ID. |
Get Latest Feeds | This action retrieves a list of feeds. Retrieves the recent 250 reports logged in the last 24 hours. |
Submit File Content for Sandbox Analysis | This action submits a file content for sandbox analysis. |
Configuration Parameters
The following configuration parameters are required for the Hybrid Analysis app to communicate with the Hybrid Analysis enterprise application. The parameters can be configured by creating instances in the app.
This URL must be whitelisted to use Hybrid Analysis from a proxied environment. https://www.hybrid-analysis.com/api/v2.
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
API Key | Enter the hybrid analysis sandbox API key. | Text | Required |
Action: Quick File Scan
This action performs a quick file scan using URL and additional fields from the hybrid analysis sandbox application.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
File path | Enter the file path. Example: "/home/anna/statusReport" | Text | Required | |
Scan type | Enter the scan type. | Text | Optional | Allowed values:
Default value: all |
Additional fields | Enter the additional fields | Key Value | Optional | Allowed values:
|
Example Request
{ "file_path": "/home/anna/statusReport", "scan_type": "all", "additional_fields": {} }
Action: Quick URL Scan
This action performs a quick URL scan using URL and additional fields from the hybrid analysis sandbox application.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
URL | Enter the URL. Example: "www.google.com" | Text | Required | |
Scan type | Enter the scan type. | Text | Optional | Allowed values:
|
Additional fields | Enter the additional fields. | Key Value | Optional | Allowed values:
|
Example Request
{ "url": "trenz.pl.com", "scan_type": "all", "extra_params": {} }
Action: Get Report Status of Sandbox Submission
This action obtains the report status of a sandbox submission.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
Job ID | Enter the job ID. Example: "5e9dbc86193b8430af5fbb1b" | Text | Required | You can generate the Job ID using the "File sub for sandbox analysis" and "URL sub for sandbox analysis" action. |
Example Request
{ "job_id": "5e9dbc86193b8430af5fbb1b" }
Action: Get a Report of Sandbox Submission
This action obtains a report summary of the sandbox submission.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
Job ID | Enter the job ID. Example: "5f48d6650286fb07773753d2" | Text | Required | You can generate the Job ID using the "File sub for sandbox analysis" and "URL sub for sandbox analysis" action. |
Example Request
{ "job_id": "5f48d6650286fb07773753d2" }
Action: File Submission for Sandbox Analysis
This action submits a file for sandbox analysis.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
File path | Enter the file path with the file extension. Example: "/tmp/0ce98d6d-be4c-47dd-a3e0-8cd41d992e61/Kaspersky_Endpoint_Security_for_Enterprise.pdf" | Text | Required | |
Environment ID | Enter the environment ID. | Integer | Optional | Allowed values:
|
Additional fields | Enter the additional fields. | Key Value | Optional | Allowed values:
|
Example Request
{ "file_path": "/tmp/0ce98d6d-be4c-47dd-a3e0-8cd41d992e61/Kaspersky_Endpoint_Security_for_Enterprise.pdf", "extra_params": { “no_share_third_party”: false, “no_hash_lookup”: false, “tor_enabled_analysis“: false, “no_hash_lookup“: false } }
Action: Get Historical Hash from URL
This action determines a SHA256 that an online file or URL submission will have when being processed by the system.
Note: This action is useful when the user looks up URL analysis.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
URL | Enter the URL. Example: "http://jusdermas.com/jessie%20l%20campbell/mazon/" | Text | Required |
Example Request
{ "url": "http://jusdermas.com/Jessie L Campbell/amazon/" }
Action: URL Submission for Sandbox Analysis
This action submits a URL for scanning in sandbox analysis.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
URL | Enter the URL. Example: "trenz.pl.com" | Text | Required | |
Environment ID | Enter the environment ID. | Integer | Optional | Allowed values:
Default value: 100; ‘Windows 7 32 bit’. |
Additional fields | Enter the additional fields. | Key Value | Optional | Allowed values:
|
Example Request
{ "url": "trenz.pl.com", "extra_params": {}, "environment_id": 110 }
Action: Search Hash Details
This action searches for hash details and the summary of the file hash.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
File hash | Enter the file hash. Example: "83d965138a2fc05f5a403d43c994c64037f0f848467e22" | Text | Required | Allowed value types:
|
Example Request
{ "file_hash": "83d965138a2fc05f5a403d43c9425afc1360eb793b3d94c64037f0f848467e22" }
Action: Get a Hash Overview
This action obtains an overview of the SHA256 hash.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
SHA256 | Enter the SHA256 hash. Example: "83d965138a2fc05f5a403d43c9425afc1360eb793b3d94c64037f0f848467e22" | Text | Required |
Example Request
[ { "SHA256": "83d965138a2fc05f5a403d43c9425afc1360eb793b3d94c64037f0f848467e22" } ]
Action: Get the Summary of Hash
This action obtains the summary of SHA256 hash.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
SHA256 | Enter the SHA256 hash. Example: "d4e8e1248fb1ff3d8f69eabb18199fb1c6cbd7f6fab3465593e0daa44525c3ef" | Text | Required |
Example Request
[ { "SHA256": "83d965138a2fc05f5a403d43c9425afc1360eb793b3d94c64037f0f848467e22" } ]
Action: Get the Result of a Quick Scan
This action obtains the result of a quick scan using scan ID.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
---|---|---|---|---|
Scan ID | Enter the scan ID. Example: "5f51b7034f95ba26df08fbbc" | Text | Required | You can generate a Scan ID using the Quick file scan and Quick URL scan action. |
Example Request
{ "scan_id": "5f4bdb83b23d773af8721296" }
Action: Get the Latest Feeds
This action retrieves a list of feeds. Retrieves the recent 250 reports logged in the last 24 hours.
Action Input Parameters
This action does not require any input parameter.
Action: Submit File Content for Sandbox Analysis
This action submits a file content for Sandbox analysis.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
File Content | Enter the file content Example: "123.33.33.33\\n22.22.22.22\\n" | Text | Required | |
Environment ID | Enter the Environment ID. Example: 120 | Integer | Optional | Default value: 100: indicates Windows 7 32 bit Allowed values:
|
Additional Fields | Enter the additional fields. | Key Value | Optional | Allowed values: -
For more information on additional fields, see Additional Fields |
Example Request
[ { "file_content": "123.33.33.33\\n22.22.22.22\\n", "environment_id": 120 } ]