Skip to main content

Cyware Orchestrate

Palo Alto WildFire

App Vendor: Palo Alto Networks

Connector Category: Data Enrichment & Threat Intelligence | Network Security | Forensics & Malware Analysis

App Version in Orchestrate: 1.0.0

API Version: 1.0.0

About App

The Palo Alto WildFire app enables security teams to detect, analyze, and block unknown samples such as files, URLs or any links. Based on the properties and behaviour displayed of the unknown sample, WildFire determines the sample to be benign, grayware, phishing, or malicious.

The WildFire app is used to connect with the Palo Alto WildFire enterprise application to submit files, URL's and links for analysis and receive verdicts from WildFire.

Palo Alto Wildfire app is configured with the Orchestrate application to perform the following actions:

Action

Description

Get Hash Verdict

This action retrieves verdict about a hash from Palo Alto.

Get URL Verdict

This action retrieves verdict about a URL from Palo Alto.

Get Web Artifacts

This action retrieves the web artifacts found during the analysis of the specified web page URL from Palo Alto.

Get Report

This action retrieves a report from Palo Alto.

Get PCAP

This action retrieves a packet capture (PCAP) file from Palo Alto.

Get Sample

This action retrieves a file from Palo Alto based on the MD5 or SHA-256 hash value.

Submit URL

This action submits a website link to Palo Alto for analysis.

Submit Remote File

This action submits a remote file to Palo Alto for analysis.

Submit File

This action submits a local file to Palo Alto for analysis.

Get Verdict

This action retrieves a verdict from Palo Alto.

Configuration Parameters

The following configuration parameters are required for the WildFire app to communicate with the Palo Alto WildFire enterprise application. The parameters can be configured by creating instances in the app.

Parameter

Description

Field Type

Required/Optional

Comments

API Key

Enter the API key to authenticate with PaloAlto Wildfire.

Example:

XXXX972a2167c93df3372de34c2fb18bae5d319a

Password

Required

Action: Get Hash Verdict

This action retrieves verdict about a hash from Palo Alto.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Hash

Enter the hash to get the verdict from Palo Alto.

Example:

"dca86121cc7427e375fd24fe5871d727"

Text

Required

Example Request

[
    {
        "hash": "dca86121cc7427e375fd24fe5871d727"
    }
]
Action: Get URL Verdict

This action retrieves verdict about a URL from Palo Alto.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

URL

Enter the URL of the web page to get verdict from Palo Alto.

Example:

"www.sampledomain.com/samples"

Text

Required

Example Request

[
    {
        "url": "www.sampledomain.com/samples"
    }
]
Action: Get Web Artifacts

This action retrieves the web artifacts found during the analysis of the specified web page URL from Palo Alto.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

Download Type

Enter the web artifact download type.

Example:

"screenshots"

Text

Required

Allowed values:

  • screenshots

  • download_type

File Name

Enter the filename to save the response to.

Example:

"https://wildfire.testdomain.com/get/sample.pdf"

Text

Required

URL

Enter the URL of the web page to get the corresponding artifacts.

Example:

"www.sampledomain.com/samples"

Text

Required

Example Request

[
    {
        "download_type": "screenshots",
        "file_name": "https://wildfire.testdomain.com/get/sample.pdf",
        "url": "www.sampledomain.com/samples"
    }
]
Action: Get Report

This action retrieves a report from Palo Alto using the Hash value.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

File Hash

Enter the file hash [MD5/ SHA-256] to retrieve the report.

Example:

"b0cfc14687e42e2236db247f5c7d861a"

Text

Required

File Name

Enter the filename to save the response to.

Example:

"https://wildfire.testdomain.com/get/sample"

Text

Required

Download Format

Enter the format to download the report.

Example:

"pdf"

Text

Optional

Allowed values:

  • xml

  • pdf

Default value:

pdf

Example Request

[
    {
        "file_hash": "b0cfc14687e42e2236db247f5c7d86",
        "file_name": "https://wildfire.testdomain.com/get/sample",
        "download_format": "pdf"
    }
]
Action: Get PCAP

This action retrieves a packet capture (PCAP) recorded during the analysis of a particular sample from Palo Alto. Use the hash value (MD5 or SHA-256) of the sample file and also specify the platform of the desired PCAP to indicate which PCAP must be returned.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

File Hash

Enter the file hash [MD5/ SHA-256] to retrieve the packet capture information.

Example:

"b0cfc14687e42e2236db247f5c7d861a"

Text

Required

File Name

Enter the filename to save the response to.

Example:

"https://wildfire.testdomain.com/get/sample.pdf"

Text

Required

Platform ID

Enter the platform ID to receive the PCAP from.

Example:

"Windows XP"

Integer

Required

Accepted values:

[1: Windows XP, Adobe Reader 9.3.3, Office 2003, 2: Windows XP, Adobe Reader 9.4.0, Flash 10, Office 2007 , 3: Windows XP, Adobe Reader 11, Flash 11, Office 2010, 4: Windows 7 32-bit, Adobe Reader 11, Flash 11, Office 2010, 5: Windows 7 64-bit, Adobe Reader 11, Flash 11, Office 2010, 100: PDF Static Analyzer, 101: DOC/CDF Static Analyzer, 102: Java/Jar Static Analyzer, 103: Office 2007 Open XML Static Analyzer, 104: Adobe Flash Static Analyzer, 204: PE Static Analyzer, 800: Archives (RAR and 7-Zip files)]

Example Request

[
    {
        "file_hash": "b0cfc14687e42e2236db247f5c7d86",
        "file_name": "https://wildfire.testdomain.com/get/sample.pdf",
        "platform_id": "Windows XP"
    }
]
Action: Get Sample

This action retrieves and downloads the sample files from Palo Alto based on the MD5 or SHA-256 hash value.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

File Hash

Enter the file hash [MD5/ SHA-256] to retrieve the sample.

Example:

"b0cfc14687e42e2236db247f5c7d861a"

Text

Required

File Name

Enter the filename to save the response to.

Example:

"https://wildfire.testdomain.com/get/sample.pdf"

Text

Required

Example Request

[
    {
        "file_hash": "b0cfc14687e42e2236db247f5c7d861a",
        "file_name": "https://wildfire.testdomain.com/get/sample.pdf"
    }
]
Action: Submit URL

This action submits a website link to Palo Alto for analysis.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

URL

Enter the website link to submit for analysis.

Example:

"www.sampledomain.com/samples"

Text

Required

Example Request

[
    {
        "url": "www.sampledomain.com/samples"
    }
]
Action: Submit Remote File

This action submits a remote file to Palo Alto for analysis.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

URL

Enter the remote file URL to submit for analysis.

Example:

"http://www.samplefile.com/samples/pdf.pdf"

Text

Required

Example Request

[
    {
        "url": "http://www.samplefile.com/samples/pdf.pdf"
    }
]
Action: Submit File

This action submits a local file to Palo Alto for analysis.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

File Name

Enter the filename to submit for analysis.

Example:

"sample.pdf"

Text

Required

File Path

Enter the local file path to submit.

Example:

"c:\sample.pdf"

Text

Required

Example Request

[
    {
        "file_name": "sample.pdf",
        "file_path": "c:\sample.pdf"
    }
]
Action: Get Verdict

This action retrieves a verdict from Palo Alto for a sample based on the MD5 or SHA-256 hash or a web page based on the URL. The verdict indicates if the sample is benign, malware, phishing or grayware.

Action Input Parameters

Parameter

Description

Field Type

Required/Optional

Comments

File Type

Enter the file type to get verdict of.

Example:

"MD5"

Text

Required

File Value

Enter the hash value of the file to get verdict of.

Example:

"c8d9094c495e4af57c932ac413b65ef132063acc"

Text

Required

Example Request

[
    {
        "file_type": "MD5",
        "file_value": "c8d9094c495e4af57c932ac413b65ef132063acc"
    }
]