While reading over the documentation for the WildFire API, I created this Python module for it.
I hope others find it useful. All feedback is welcome.
$ sudo pip install pyldfire
from pprint import PrettyPrinter from io import BytesIO from pyldfire import WildFire printer = PrettyPrinter(indent=2) wildfire = WildFire("api-key-goes-here") # Submit a local file with open("malware", "rb") as sample_file: results = wildfire.submit_file(sample_file) printer.pprint(results) # File Hashes can be MD5,SHA1, or SHA256 file_hash = "419251150a2f77422efa1e016d605d69" # Download a sample to a file with open("sample", "wb") as sample_file: sample_file.write(wildfire.get_sample(file_hash)) # Or keep it as a file-like object in memory instead sample = BytesIO(wildfire.get_sample(file_hash)) # Same for PCAPs and PDF reports # Get a verdict verdict = wildfire.get_verdicts([file_hash]) # Get analysis results results = wildfire.get_report(file_hash) # Test your firewall wildfire.get_malware_test_file()
__init__(self, api_key, host='wildfire.paloaltonetworks.com', proxies=None, verify=True)
Initializes the WildFire class
Args: api_key (str): A WildFire API Key host (str): The hostname of the WildFire service or appliance proxies (dict): An optional dictionary containing proxy data, with https as the key, and the proxy path as the value verify (bool): Verify the certificate verify (str): A path to a CA cert bundle
Gets a unique, benign malware test file that will trigger an alert on Palo Alto Networks’ firewalls
Returns: bytes: A malware test file
get_pcap(self, file_hash, platform=None)
Gets a PCAP from a sample analysis
Args: file_hash (str): A hash of a sample platform (int): One of the following integers: 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 64bit, Adobe Reader 11, Flash 11, Office 2010 50: Mac OS X Mountain Lion 201: Android 2.3, API 10, avd2.3. Returns: bytes: The PCAP Raises: WildFireException: If an API error occurs
Gets analysis results as a PDF
Args: file_hash: A hash of a sample of a file Returns: bytes: The PDF Raises: WildFireException: If an API error occurs
Gets analysis results as structured data
Args: file_hash (str): A hash of a sample Returns: dict: Analysis results Raises: WildFireException: If an API error occurs
Gets a sample file
Args: file_hash (str): A hash of a sample Returns: bytes: The sample Raises: WildFireException: If an API error occurs
Gets the verdict for one or more samples
Args: file_hashes (list): A list of file hash strings file_hashes (str): A single file hash Returns: str: If a single file hash is passed, a string containing the verdict list: If multiple hashes a passed, a list of corresponding list of verdict strings Possible values: 'Benign' 'Malware' 'Greyware' 'Pending` 'Error' 'Not found` Raises: WildFireException: If an API error occurs
submit_file(self, file_obj, filename="sample")
Submits a file to WildFire for analysis
Args: file_obj (file): The file to send filename (str): An optional filename Returns: dict: Analysis results Raises: WildFireException: If an API error occurs
Submits a file from a remote URL for analysis
Args: url (str): The URL where the file is located Returns: dict: Analysis results Raises: WildFireException: If an API error occurs Notes: This is for submitting files located at remote URLs, not web pages. See Also: submit_urls(self, urls)
Submits one or more URLs to a web page for analysis
Args: urls (str): A single URL urls (list): A list of URLs Returns: dict: If a single URL is passed, a dictionary of analysis results list: If multiple URLs are passed, a list of corresponding dictionaries containing analysis results Raises: WildFireException: If an API error occurs
Great job! Thanks for offering up this library to the community!
pretty sad that there is no official package from PaloAlto that works.
(or splunk app for that matter)
The official package developed within Palo Alto Networks for Wildfire (and PAN-OS and Autofocus) is called pan-python:
Pan-python is lower level API access and often makes a good dependency for a higher level library like the one posted here.
The official Splunk App developed by Palo Alto Networks is here:
Hope that helps!
Thanks for the splunk and officialy python API links.
Click Accept as Solution to acknowledge that the answer to your question has been provided.
The button appears next to the replies on topics you’ve started. The member who gave the solution and all future visitors to this topic will appreciate it!
These simple actions take just seconds of your time, but go a long way in showing appreciation for community members and the Live Community as a whole!
The Live Community thanks you for your participation!