Document toolboxDocument toolbox

Cuckoo

Cuckoo is an open-source automated malware analysis system. It's used to automatically run and analyze files and collect comprehensive analysis results that outline what the malware does while running inside an isolated operating system.

Connect Cuckoo with Devo SOAR

  1. Navigate to Automations > Integrations.

  2. Search for Cuckoo.

  3. Click Details, then the + icon. Enter the required information in the following fields.

  4. Label: Enter a connection name.

  5. Reference Values: Define variables here to templatize integration connections and actions. For example, you can use https://www.{{hostname}}.com where, hostname is a variable defined in this input. For more information on how to add data, see 'Add Data' Input Type for Integrations.

  6. Verify SSL: Select option to verify connecting server's SSL certificate (Default is Verify SSL Certificate).

  7. Remote Agent: Run this integration using the Devo SOAR Remote Agent.

  8. Server URL: The URL of your Cuckoo instance.

  9. After you've entered all the details, click Connect.

Actions for Cuckoo

Analyze and Wait

Analyze and wait submits a file and waits for the analysis to be completed.

Input Field

Input Name

Description

Required

Input Name

Description

Required

Column Name

Select the column name from parent table to lookup value for.

Required

Output

A JSON object containing multiple rows of result:

  • result: Completes the analysis of the file.

``` {json}{ "has_error": true, "error": "No result available as File ID is empty." }

## Analyze Submits a file for analysis. ### Input Field Choose a connection that you have previously created and then fill in the necessary information in the following input fields to complete the connection. | Input Name | Description | Required | | :---------- | :------------------------------------------------------------ | :------- | | Column Name | Select the column name from parent table to lookup value for. | Required | ### Output A JSON object containing multiple rows of result: - result: Analyzes the file. ``` {json}{ "has_error": true, "error": "No result available as File ID is empty." }

Release Notes

  • v2.0.0 - Updated architecture to support IO via filesystem

  • v1.0.8 - Added documentation link in the automation library.