Welcome to pyTenable’s documentation!
pyTenable is intended to be a pythonic interface into the Tenable application APIs. Further by providing a common interface and a common structure between all of the various applications, we can ease the transition from the vastly different APIs between some of the products.
Issue Tracker: https://github.com/tenable/pyTenable/issues
Github Repository: https://github.com/tenable/pyTenable
Installation
To install the most recent published version to pypi, its simply a matter of installing via pip:
pip install pytenableIf you’re looking for bleeding-edge, then feel free to install directly from the github repository like so:
pip install git+git://github.com/tenable/pytenable.git#egg=pytenableGetting Started
Lets assume that we want to get the list of scans that have been run on our Tenable.io application. Performing this action is as simple as the following:
from tenable.io import TenableIO
tio = TenableIO(access_key='TIO_ACCESS_KEY', secret_key='TIO_SECRET_KEY')
for scan in tio.scans.list():
print('{status}: {id}/{uuid} - {name}'.format(**scan))Getting started with Tenable.sc is equally as easy:
from tenable.sc import TenableSC
sc = TenableSC(url='https://SC_URL', access_key='AKEY', secret_key='SKEY')
for vuln in sc.analysis.vulns():
print('{ip}:{pluginID}:{pluginName}'.format(**vuln))For more detailed information on whats available, please refer to the pyTenable Documentation
Logging
Enabling logging for pyTenable is a simple matter of enabling debug logs through the python logging package. An easy example is detailed here:
import logging
logging.basicConfig(level=logging.DEBUG)License
The project is licensed under the MIT license.
2 maintainers
Metadata
2 maintainers
Release files for pyTenable 26.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pytenable-26.10.1.tar.gz | 314.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pytenable-26.10.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 745.2 kB
Release files / pytenable-26.10.1.tar.gz
| Download URL | pytenable-26.10.1.tar.gz |
|---|---|
| Size | 314.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
65b29ab0ad5b5ccfa43eab2d8418e5ff0389402ad1371fe1b2fa60fb011c281e
|
|
BLAKE2b-256 checksum How to use checksums |
86b9498daca1856632827edb10d83ed9c77433cbd00d7dae5b055262652134ef
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / pytenable-26.10.1-py3-none-any.whl
| Download URL | pytenable-26.10.1-py3-none-any.whl |
|---|---|
| Size | 430.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ec12854fe5991dfbafa0034e2a71fa4e37a6e81eca3b4cc7c8e9cb651cd1cd5f
|
|
BLAKE2b-256 checksum How to use checksums |
018ab1aa456b423a0d92ea08cc6d7899e0dc0e2176f5ab0aa067dbe84f67e977
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
