Skip to main content

Python wrapper for Tenable SecurityCenter API.

Project description

A powerful wrapper around the SecurityCenter API. Manages authentication, building requests, and interpreting responses. Supports the full, unpublished API, above the limited API officially documented. The “module::action” pattern of the API is represented as dotted access to attributes and methods on the client.

Install:

$ pip install SecurityCenter

Use:

>>> from securitycenter import Client
>>> client = Client('https://localhost:443', 'user', 'password', 'cert_file.crt')
>>> scan_results = client.scan_result.init()

Many actions return more than the specifically requested data. For example, scanResult::init returns information including users and scanners as well. Many methods are configured to extract the most common value (in the example, the scan results). If a method extracts a value by default, pass _key=None to return the full response instead.

>>> response = client.scan_result.init(_key=None)
>>> response.keys()  # all keys returned by method

Some actions return chunks of results. The library standardizes how paginated requests are made to always use page and page_size arguments, and the results become a special pagination object that can iterate over subsequent pages.

>>> p3 = client.scan_result.get_page(page=3, page_size=10)  # 3rd page, where each page has 10 items
>>> p3  # list of items on current page
>>> p4 = p1.next_page()  # make request for next page
>>> pages = list(p1.iter_pages())  # all pages
>>> items = list(p1.iter_items())  # all items

Note

Only the modules and actions that I actually use in my own projects have been implemented. I’m willing to implement or accept patches to support other methods, but won’t be proactive about implementing them. Please open an issue on the BitBucket repo to request or add more methods.

Project details


Release history Release notifications

This version
History Node

1.0.5

History Node

1.0.4

History Node

1.0.3

History Node

1.0.2

History Node

1.0.1

History Node

1.0

History Node

1.0.dev0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
SecurityCenter-1.0.5-py2.py3-none-any.whl (16.2 kB) Copy SHA256 hash SHA256 Wheel 3.4 Sep 16, 2015
SecurityCenter-1.0.5.tar.gz (12.0 kB) Copy SHA256 hash SHA256 Source None Sep 16, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page