Python library and command line tool for interacting with the ThreatFox API provided by abuse.ch.
Project description
ThreatFox API
Python library and CLI tool for interacting with the ThreatFox API.
Massive thanks to abuse.ch for all the work they do!
Install
This python library requires python3.7 or greater. Ideally, python3.9 or greater.
pip install threatfox
CLI Tool
$ threatfox -h
usage: threatfox [-h] [-d] [--api-key API_KEY] [--save-api-key SAVE_API_KEY] {ioc,i,malware,m,tag,t,submit,s} ...
Tool for interacting with the ThreatFox API.
positional arguments:
{ioc,i,malware,m,tag,t,submit,s}
ioc (i) ThreatFox IOC API interface.
malware (m) Interact with ThreatFox Malware APIs.
tag (t) ThreatFox tag operations.
submit (s) Submit IOCs to ThreatFox.
optional arguments:
-h, --help show this help message and exit
-d, --debug Turn on debug logging.
--api-key API_KEY An ThreatFox API key to use.
--save-api-key SAVE_API_KEY
Save an ThreatFox API key to use as the default.
Configure
You can supply your API Key to the CLI tool with the --api-key
option. For repeated use by the current user, you can save the API key with threatfox --save-api-key
. This will store the key at ~/.threatfox/config.ini
. If you want all users on a system to share an API key, you can add your API Key to a config like the following at /etc/threatfox/config.ini
:
[default]
api_key =
Proxy settings can be configured for current user or system wide with the following option supplied to the default
section.
proxy = http://user:pass@proxy_address:proxy_port
Questions
If you have any questions at all or run into a bug, please let me know by opening an issue.
Also, if there is interest I can document all of the various ways you could use this tool via the CLI and as a python library.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for threatfox-0.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fed2189ad5b22dc5d1883a66eb42df4bb1256a7850fa001c746da9a08858b3d0 |
|
MD5 | b610c2c553840e3795b6809f62c14c45 |
|
BLAKE2b-256 | 2f56ef2a1672551e51ff1f5b94f60c73d8e5484a110821bf591ba1a13c0e5354 |