tenable-was 0.3.0

Python client for Tenable Web Application Scanning (WAS) API

tenable-was

A Python client library for interacting with Tenable's Web Application Scanning (WAS) APIs, simplifying tasks like searching configurations, scans, and exporting scan reports.

Installation

Install via pip:

pip install tenable-was

Usage

Initialize the Client

Create a client instance with your Tenable API keys:

from tenable_was import TenableClient

client = TenableClient(
    access_key="YOUR_ACCESS_KEY",
    secret_key="YOUR_SECRET_KEY",
    base_url="https://fedcloud.tenable.com"  # Optional, this is the default
)

Search Configurations

Retrieve scan configurations:

configs = client.search_configs(limit=10)
print(configs)

Search Scans

Find completed scans for a specific configuration:

scans = client.search_scans(config_id="your-config-id", limit=10)
print(scans)

Export Scan Reports

Generate and download a scan report:

report = client.export_scan(scan_id="your-scan-id")
print(report)

You can also specify the content type:

# Get report in JSON (default)
json_report = client.export_scan(scan_id="your-scan-id", content_type="application/json")

# Or get report in other formats
pdf_report = client.export_scan(scan_id="your-scan-id", content_type="application/pdf")

Requirements

• Python 3.11+
• Requests 2.32.3+

Authors

• Alec Meyer - [e-mail]
• Megha Patel - [e-mail]

Building and Publishing

Building with uv

uv build

Publishing with uv

uv publish --token YOUR_PYPI_TOKEN_HERE