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.8.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.8.1.tar.gz | 302.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pytenable-26.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 724.7 kB
Release files / pytenable-26.8.1.tar.gz
| Download URL | pytenable-26.8.1.tar.gz |
|---|---|
| Size | 302.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
09d9c56cc4062adc4d1db052c58413810aa52e69cbaed2c4a8bfc4159f1f7ee1
|
|
BLAKE2b-256 checksum How to use checksums |
c150fb038dfa07a84d62ab1792817b3f44d5ac0ba6dc5bca9b0af14dfb0877a9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"44","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / pytenable-26.8.1-py3-none-any.whl
| Download URL | pytenable-26.8.1-py3-none-any.whl |
|---|---|
| Size | 422.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5dabc0c78cca48ac3f93ebb83fb5e674599b4b8a3a881aa3911d31996aab4cf2
|
|
BLAKE2b-256 checksum How to use checksums |
d2b5121d2a84a4c3b8bd9b401aef825b69520c7fc4166de432d2f35cd3304542
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"44","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
