Skip to content SDK offers a scalable and safe way to integrate with the platform.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples TJS-56 Update export helper to support reading exports into memory. Oct 2, 2018
tests Skip consistently failing cs tests Mar 18, 2019
.travis.yml Update tenable.ini and travis to support LOGGING_LEVEL configuration May 23, 2017
LICENSE SDK for Python Feb 2, 2017
requirements-build.txt SDK for Python Feb 2, 2017
setup.cfg SDK for Python Feb 2, 2017 Add version info to tenable_io module Aug 30, 2017

README.rst SDK for Python SDK for Python

For you coffee lovers, check out SDK for Java.


$ pip install tenable_io

Quick Start

Quickest way to get started is to checkout the example scripts.


Access key and secret key are needed to authenticate with the Tenable Cloud API. There are three ways to supply the keys to the TenableIOClient:

Precedence Method
1 Constructor Arguments
2 INI File
3 Environment Variables

TenableIOClient Constructor Arguments

TenableIOClient(access_key='YOUR_ACCESS_KEY', secret_key='YOUR_SECRET_KEY')

INI File

A tenable_io.ini can be created in the working directory. See tenable_io.ini.example on what it should look like.
Note: The tenable_io.ini.example file is in Jinja template format.

Environment Variables

TenableIOClient looks for the environment variables TENABLEIO_ACCESS_KEY and TENABLEIO_SECRET_KEY.

Python Version

2.7, 3.4+


It is recommend to use virtualenv to setup an isolated local environment.

$ virtualenv .venv
# To use a different python bin (i.e. python3).
$ virtualenv .venv3 -p $(which python3)
# To active the virtualenv
$ source ./.venv/bin/activate

Install dependencies.

$ pip install -r ./requirements.txt
$ pip install -r ./requirements-build.txt

Run Tests

Additional configuration is needed for tests to correctly run. See the [tenable_io-test] section under tenable_io.ini.example. Such configuration can be done via the INI file tenable_io.ini or environment variables.

$ py.test


To generate/force update the RST documentations from docstrings.

$ sphinx-apidoc -f -o doc/source tenable_io

Generate HTML documentation.

$ cd doc
$ make clean && make html
You can’t perform that action at this time.