Python module: haloscans

What it is:

Multi-threaded API wrapper for the CloudPassage /v1/scans endpoint. Give it API creds and talk to it like it's a generator. See example, below.

Installing:

• Clone this repository down and enter its root dir
• pip install .

Example usage:

The following example retrieves a list of all FIM scans for New Year's Day, then queries the API to enrich the basic scan metadata with scan findings. Finally, we pretty-print the scan results.

import haloscans
import pprint
search_params = {"module": "fim"}
start_timestamp = "2018-01-01"
scans = haloscans.HaloScans(key, secret, start_timestamp=start_timestamp, report_performance=True, search_params=search_params)
for scan in scans:
    if not scan["created_at"].startswith(start_timestamp):
        break
    else:
        message = "ID: %s\tTime: %s\tType: %s\n" % (scan["id"], scan["created_at"], scan["module"])
        print(message)

Testing:

py.test --cov=haloscans