https://github.com/richlamdev/tio
Command line interface for Tenable.io written in Python
https://github.com/richlamdev/tio
api python python3 tenable tenableio
Last synced: 7 months ago
JSON representation
Command line interface for Tenable.io written in Python
- Host: GitHub
- URL: https://github.com/richlamdev/tio
- Owner: richlamdev
- Created: 2020-04-25T20:22:39.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-04-25T20:30:53.000Z (almost 6 years ago)
- Last Synced: 2025-08-31T05:49:00.570Z (7 months ago)
- Topics: api, python, python3, tenable, tenableio
- Language: Python
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# tio
````tio```` is a simple and limited CLI to Tenable.IO, written in Python.
Basic usage:
````python3 tio.py [command] [flags]````
## Features:
1) Show scan configuration and history of each configured scan.
2) Export specific scan to local disk in csv/pdf/html/nessus.
Note: PDF & HTML option only available within 90 days of the scan.
3) Show server information.
4) Foundational work to expand features in the future.
## Dependencies to run this script are:
1) Linux or Unix Operating System. Will not work on Windows in present form.
2) Python 3
3) PyTenable Python module
Install by using:
pip3 install pytenable
## API Requirement:
Script automatically checks for the presence of API keys at ~/.tio/client.json.
If API keys are not present, the user is prompted for keys on first use and saved.
Note: Secure your keys! In present form they will be stored unencypted on your local drive.
## Examples:
````python3 tio.py info````
````python3 tio.py info -s 1337````
Note, syntax uses history_id to be consistent with Pytenable API documentation, despite returned information is displayed as "id".
````python3 tio.py export -s 1337 -hid 12345678 latest_scan pdf html nessus csv````
````python3 tio.py server````
## To Do:
1) Add color!
2) Provide user friendly error message when pdf or html format is requested for scan older than 90 days.
Tenable.io will not generate pdf/html for scans older than 90 days.
## Reference:
https://pytenable.readthedocs.io/en/stable/
https://github.com/tenable/pyTenable