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
Links
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for SecurityCenter-1.0.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 524fdac86a674bf8f7fda171f0281989d3d8f1a342b3c0120a3f31921a399fd2 |
|
MD5 | 18e7cbbde9c77a2c9d55f57fe72fb68a |
|
BLAKE2b-256 | be4a78a32e2f5e7f9d00f9d280fb336309e246e0cbf6abce67dbb914c1206366 |