OpenCTI client for Python
The official OpenCTI Python client helps developers to use the OpenCTI API by providing easy to use methods and utils. This client is also used by some OpenCTI components.
Install
To install the latest Python client library, please use pip:
$ pip3 install pycti
Local development
# Fork the current repository, then clone your fork
$ git clone https://github.com/YOUR-USERNAME/opencti.git
$ cd client-python
$ git remote add upstream https://github.com/OpenCTI-Platform/opencti.git
# Create a branch for your feature/fix
$ git checkout -b [branch-name]
# Create a virtualenv
$ cd client-python
$ python3 -m venv .venv
$ source .venv/bin/activate
# Install the client-python and dependencies for the development and the documentation
$ python3 -m pip install -e .[dev,doc]
# Set up the git hook scripts
$ pre-commit install
# Create your feature/fix
# Create tests for your changes
$ pytest
# Push you feature/fix on Github
$ git add [file(s)]
$ git commit -m "[descriptive message]"
$ git push origin [branch-name]
# Open a pull request
Install the package locally
$ pip install -e .
Documentation
Client usage
To learn about how to use the OpenCTI Python client and read some examples and cases, refer to the client documentation.
API reference
To learn about the methods available for executing queries and retrieving their answers, refer to the client API Reference.
Tests
Install dependencies
$ pip install -r ./test-requirements.txt
pytest is used to launch the tests.
Launch tests
Prerequisite
Your OpenCTI API should be running. Your conftest.py should be configured with your API url, your token, and if applicable, your mTLS cert/key.
Launching
Unit tests
$ pytest ./tests/01-unit/
Integration testing
$ pytest ./tests/02-integration/
Example testing:
OpenCTI must be running
cd examples
# Configure with you local instance of OpenCTI
export OPENCTI_API_URL="http://localhost:4000"
export OPENCTI_API_TOKEN="xxxxxxxxxxxxxxxxxxxxxx"
#Run one example file
python get_indicators_of_malware.py
About
OpenCTI is a product designed and developed by the company Filigran.
1 maintainer
Release files for pycti 7.260928.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pycti-7.260928.0.tar.gz | 271.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pycti-7.260928.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 635.1 kB
Release files / pycti-7.260928.0.tar.gz
| Download URL | pycti-7.260928.0.tar.gz |
|---|---|
| Size | 271.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
43567b46acede67905d4bb973c4a3f389c29c95d3637a27a03f6789b6e41f279
|
|
BLAKE2b-256 checksum How to use checksums |
8a49ac483ea09573eaf1d38289eaf5cb5f4f8e0a6c773442c9985fd70a4e4abe
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
Release files / pycti-7.260928.0-py3-none-any.whl
| Download URL | pycti-7.260928.0-py3-none-any.whl |
|---|---|
| Size | 364.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
19e9377c0282f4f2e6aef15d7de2831fda337011849835370f739ca1f1736732
|
|
BLAKE2b-256 checksum How to use checksums |
01e43d18880e9a817b62f063a96ac6e79f47c321a2b7e9292469b9850451d2f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.15
|
