Skip to main content

SDK for interacting with Qualys APIs, across most of modules the platform offers.

Project description

qualysdk - A Python SDK for Interacting With Qualys APIs

Logo

Code Style: black Development Status PyPI - Latest Version Python Versions GitHub Stars PyPI - Downloads

Black Formatter Status CodeQL Scan Status

This SDK attempts to make it much easier to interact with Qualys's various API endpoints, across as many modules as I can find time to code.

Uber Class Example

from qualysdk import TokenAuth, GAVUber

auth = TokenAuth(<username>, <password>, platform='qg1')
uber = GAVUber(auth)

assets = uber.get(
    "query_assets", 
    filter='operatingSystem:"Linux"', 
    lastModifiedDate="2024-06-21"
    )
>>>[AssetID(012345678), ...]

Non-Uber Class Example

from qualysdk.auth import BasicAuth
from qualysdk.vmdr import get_host_list

auth = BasicAuth(<username>, <password>, platform='qg1')

#Pull 4 pages of hosts, with "All/AGs" details & tags:
hosts = get_host_list(auth, details="All/AGs", show_tags=True, page_count=4)
>>>[VMDRHost(12345), ...]

Current Supported Modules

Head's Up!: SQL DB uploading is currently in development! 🎉

Module Status
GAV (Global AssetView)
VMDR In Progress (query_kb, get_kb_qvs, get_host_list, get_hld, get_ag_list, add/edit/remove_ag, get_ip_list, add/update_ips, get_scan_list, pause_scan, cancel_scan, resume_scan, delete_scan, launch_scan, fetch_scan, get_scanner_list, get_static_searchlists, get_report_list, launch/cancel/fetch/delete_report, get_template_list, get_scheduled_report_list, launch_scheduled_report, get_user_list, add/edit_user implemented)
PM (Patch Management) Not Started
WAS In Planning
TC (TotalCloud) Started
Connectors Not Started
Cloud Agent Not Started
CS (Container Security) Not Started
ADMIN (Administration) Not Started
Tagging Not Started

Documentation/Get Started

For more detailed information on the package, including how to get up and running, please see the documentation.

Disclaimer

This SDK tool is an independent project and is not an official product of Qualys. It has been developed and maintained solely by the names listed in the GitHub contributors list. Qualys has neither endorsed nor approved this SDK.

Users of this SDK are advised to use it at their own risk and discretion.

For official tools and support, please refer to the official Qualys resources and documentation.

TODO:

  • Multithread gav.get_all_assets.

  • Start work on TotalCloud/WAS modules.

  • Continue SQL integration.

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

qualysdk-0.1.11.tar.gz (74.2 kB view details)

Uploaded Source

Built Distribution

qualysdk-0.1.11-py3-none-any.whl (101.0 kB view details)

Uploaded Python 3

File details

Details for the file qualysdk-0.1.11.tar.gz.

File metadata

  • Download URL: qualysdk-0.1.11.tar.gz
  • Upload date:
  • Size: 74.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.5

File hashes

Hashes for qualysdk-0.1.11.tar.gz
Algorithm Hash digest
SHA256 2f845bd2d0b00a6618836ed2c4c411976b5e46bf7e5f98caa52b1778b937fa56
MD5 4ebc9ba165ff40e85c676270fdb997ab
BLAKE2b-256 b03196a6cc974e017e0030d183018c2f3298d0d935188731acbe08efec2f89cc

See more details on using hashes here.

File details

Details for the file qualysdk-0.1.11-py3-none-any.whl.

File metadata

  • Download URL: qualysdk-0.1.11-py3-none-any.whl
  • Upload date:
  • Size: 101.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.5

File hashes

Hashes for qualysdk-0.1.11-py3-none-any.whl
Algorithm Hash digest
SHA256 4a075ae2894003bd4578c0658dace552d1d4aa469c63b39c0954cd457e4c6b9e
MD5 56e25451d0ed845a4569abb97398cb7a
BLAKE2b-256 424ec43bc5e641a51ce94b98dcb86d2ff42675589c09ea568d18fcf303e7dfcc

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page