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
andconnector_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
analyzer-healthcheck Send healthcheck request for an analyzer...
config Set or view config variables
connector-healthcheck Send healthcheck request for a connector
get-analyzer-config Get current state of `analyzer_config.json` from...
get-connector-config Get current state of `connector_config.json` from...
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>", "optional<proxies>")
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-4.4.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3c2c3010951f1b4f4b504a717858919b403fa2da9967c11a393ac2f76cc41d70 |
|
MD5 | cd385848d6897617c4cebbbf876e17c8 |
|
BLAKE2b-256 | aa28437a11a44a34b88b11fc6063dd82c1ca5e0a232e955230f24bd3b7eefbcd |