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.5-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c6cd6d04bd5c2e4344921841c3a13e93c83b23276e534a414855bd58bc332065 |
|
MD5 | 25a4a5606415b635270649097042ddff |
|
BLAKE2b-256 | af84883046e53d804b2a92e4b788662ca4ccdb873a203c0c755143a2820c2fc7 |