Qualys Cloud Platform
  • 3 minutes to read
  • Print
  • Share
  • Dark
    Light

Qualys Cloud Platform

  • Print
  • Share
  • Dark
    Light

Qualys Cloud Platform monitors customers' global security and compliance posture using sensors. This adapter connects to the Qualys Cloud Platform service to import information about devices and vulnerabilities.

Parameters

  1. Qualys Cloud Platform Domain (required) - The hostname of the Qualys API (e.g., qualysapi.apps.qualys.com)
  2. User Name and Password (required) - The credentials for a user account that has the Required Permissions to fetch assets.
  3. Verify SSL (required, default: False) - Verify the SSL certificate offered by the value supplied in Hostname or IP Address. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the value supplied in Qualys Cloud Platform Domain will be verified against the CA database inside of Axonius. If the SSL certificate can not be validated against the CA database inside of Axonius, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the value supplied in Qualys Cloud Platform Domain will not be verified against the CA database inside of Axonius.
  4. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in Qualys Cloud Platform Domain.
    • If supplied, Axonius will utilize the proxy when connecting to the value supplied in Qualys Cloud Platform Domain.
    • If not supplied, Axonius will connect directly to the value supplied in Qualys Cloud Platform Domain.
  5. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.


    image.png

Advanced Settings

  1. Request timeout (required, default: 200) - Specify how many seconds all connections for this adapter will wait for a response before considering the request as timed out.
  2. Chunk size (required, default: 50) - Specify the number of parallel requests all connections for this adapter will send to Qualys.
  3. Devices per page (optional, default: 1) - Set the number of results per page received for a given query to Qualys API, to gain better control on the performance of all connections of for this adapter.
  4. Intervals between retries (seconds) (optional, default: 3) - Specify how many seconds all connections for this adapter will wait in between each retry when the Qualys API returns a response with an error.
    • If supplied, Axonius will wait for the specified number of seconds before resending the request to the Qualys API.
    • If not supplied, Axonius will immediately resend the request to the Qualys API.
      The default value for this field is 3.
  5. Number of retries (optional, default: 3) - Specify how many times all connections for this adapter will retry a request when the Qualys API returns a response with an error.
    • If supplied, upon an error response from Qualys API, up to the specified number, Axonius will resend the request to the Qualys API.
    • If not supplied, upon an error response from Qualys API, Axonius will not resend the request to the Qualys API.
  6. Qualys tags whitelist (optional, default: empty) - Specify a comma-separated list of Qualys tags.
    • If supplied, all connections for this adapter will only fetch devices tagged in Qualys with the tags provided in this list.
    • If not supplied, all connections for this adapter will fetch all devices from Qualys Cloud Platform.

image.png

Required Permissions

The value supplied in User Name must have the following permissions:

  • Managers with full scope
  • Other users with the following permissions:
    • Access to the API.
    • Asset Management permission: "Read Asset".


To enable user access to the API:

  1. From Qualys, click the user button next to the Logout -> User Profile.

    image.png

  2. The Edit User screen opens. Click User Role -> select the API checkbox to enable API Access.
    image.png

  3. Save changes.

Was this article helpful?