Robust Python SDK and CLI for IntelOwl's API
Project description
PyIntelOwl
Robust Python SDK and Command Line Client for interacting with IntelOwl's API.
Features
- Easy one-time configuration with self documented help and hints along the way.
- Request new analysis for observables and files.
- Select which analyzers you want to run for every analysis you perform.
- Choose whether you want to HTTP poll for the analysis to finish or not.
- List all jobs or view one job in a prettified tabular form.
- List all tags or view one tag in a prettified tabular form.
- Tabular view of the
analyzer_config.json
from IntelOwl with RegEx matching capabilities.
Demo
Installation
$ pip3 install pyintelowl
For development/testing, pip3 install pyintelowl[dev]
Quickstart
As Command Line Client
On successful installation, The pyintelowl
entryscript should be directly invokable. For example,
$ pyintelowl
Usage: pyintelowl [OPTIONS] COMMAND [ARGS]...
Options:
-d, --debug Set log level to DEBUG
--version Show the version and exit.
-h, --help Show this message and exit.
Commands:
analyse Send new analysis request
config Set or view config variables
get-analyzer-config Get current state of `analyzer_config.json` from the...
jobs Manage Jobs
tags Manage tags
As a library / SDK
from pyintelowl import IntelOwl
obj = IntelOwl("<your_api_key>", "<your_intelowl_instance_url>", "optional<path_to_pem_file>")
For more comprehensive documentation, please see https://pyintelowl.readthedocs.io/.
Changelog
View CHANGELOG.md.
FAQ
Generate API key
You need a valid API key to interact with the IntelOwl server.
Keys should be created from the admin interface of IntelOwl: you have to go in the Durin section (click on Auth tokens
) and generate a key there.
Incompatibility after version 3.0
We did a complete rewrite of the PyIntelOwl client and CLI both for the version 3.0.0
. We very much recommend you to update to the latest version to enjoy all new features.
(old auth method) JWT Token Authentication
this auth was available in IntelOwl versions <1.8.0 and pyintelowl versions <2.0.0
From the admin interface of IntelOwl, you have to go in the Outstanding tokens section and generate a token there.
You can use it by pasting it into the file api_token.txt.
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 pyintelowl-3.1.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4c17491e1929ef3ca7422631c96730666c683b41a5e68603068441f9c904b546 |
|
MD5 | 049140bd1270467266efd50d3a352fb9 |
|
BLAKE2b-256 | 5b086b4b1006bb459dbaacff2483e2bd5d94551dccb346f7e2740cd01cfba38a |