I have been looking at the RESTful XML API in order to retrieve logs, and have noticed that the API returns traffic and threat logs, but it does not return wildfire logs.
To retrieve threat logs I provide type=logs and log-type=threat as parameters.
Wildfire logs show up with type=THREAT and subType=wildfire when retrieved through syslog. Shouldn't they then be return similarly through the REST API?
Solved! Go to Solution.
Wildfire logs cannot be retrieved from the API using the 'log-type=threat' option. A new 'log-type=wildfire' option is being added for this in upcoming PAN-OS 5.0.x software update.
There is a bug fix to address accessing WildFire logs via the API that is planned for the upcoming maintenance release 5.0.5, due soon.
The hash is not available within the WildFire logs on the device, but can be accessed via the WildFire API. In order to retrieve file hash (along with other WildFire forensics details), you can use the WildFire logs on the device and turn into WildFire API queries. We recently added a new WildFire API method used to query based on device id (S/N) and report ID in the WildFire reports (labeled as threat ID or "tid").
A demonstration of the API query as a CURL command is provided below:
curl -i -k -F device_id=[SERIAL NUMBER] -F report_id=[TID FROM LOG] -F format=xml https://wildfire.paloaltonetworks.com/publicapi/report
WildFire logs can be exported to provide this information using log export or log forwarding.
The full API manual (not including the above new method) is available at: https://wildfire.paloaltonetworks.com/Wildfire/Home/APIProgrammingGuide. Documentation will be updated soon to include this new API method.
Has the URI you mentioned already been valid?
I tried following command today but no luck.
$ curl -i -k -F device_id=001606000xxx -F report_id=417xxx -F format=xml https://wildfire.paloaltonetworks.com/publicapi/report
HTTP/1.1 100 Continue
HTTP/1.1 400 Bad Request
Date: Thu, 11 Jul 2013 07:22:30 GMT
Also tried with wget to check if the curl I am using is something wrong but almost same result.
$ wget --no-check-certificate --post-data 'device_id=001606000xxx&report_id=417xxx&format=xml' https://wildfire.paloaltonetworks.com/publicapi/report
--2013-07-11 08:25:46-- https://wildfire.paloaltonetworks.com/publicapi/report
Resolving wildfire.paloaltonetworks.com... 188.8.131.52
Connecting to wildfire.paloaltonetworks.com|184.108.40.206|:443... connected.
WARNING: certificate common name `*.wildfire.paloaltonetworks.com' doesn't match requested host name `wildfire.paloaltonetworks.com'.
HTTP request sent, awaiting response... 400 Bad Request
2013-07-11 08:25:47 ERROR 400: Bad Request.
Any mistakes I am making?
you are missing the apikey. I use -d in the below because you don't need a
multipart/form-data request, but -F will work also.
$ curl -i -d "apikey=$KEY" -d device_id=00xxx -d report_id=247406568 https://wildfire.paloaltonetworks.com/publicapi/report
HTTP/1.1 200 OK
Date: Sat, 13 Jul 2013 00:23:43 GMT
Content-Type: text/xml; charset=utf-8
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!