Qualys Cloud Platform - Add Tags to Host Asset
  • 22 Nov 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Qualys Cloud Platform - Add Tags to Host Asset

  • Dark
    Light
  • PDF

Qualys Cloud Platform - Add Tags to Host Asset adds a specified list of tags to each device entity retrieved from the saved query supplied as a trigger (or to devices selected in the asset table) that is a host asset in Qualys.

Connection Settings

  1. Use stored credentials from the Qualys Cloud Platform adapter (optional, default: empty) - Select this option to use the first connected Qualys Cloud Platform adapter credentials.
NOTE
To use this option, you must successfully configure a Qualys Cloud Platform adapter connection.
  1. Qualys Cloud Platform Domain (optional, default: empty) - The hostname of the Qualys API (for example, qualysapi.apps.qualys.com). For more details on how to determine your Qualys API URL, see Identify your Qualys platform.
NOTE
If Use stored credentials from the Qualys Cloud Platform adapter is disabled, this field is required.
  1. User name and Password (optional, default: empty) - The credentials for a user account that has the Required Permissions to add a specified list of tags to each host asset in Qualys.
NOTE
If Use stored credentials from the Qualys Cloud Platform adapter is disabled, this field is required.
  1. Verify SSL (required, default: False) - Verify the SSL certificate offered by the host supplied in Qualys Cloud Platform Domain. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the host will be verified against the CA database inside of Axonius. If it fails validation, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the host will not be verified against the CA database inside of Axonius.
  2. HTTPS proxy (optional, default: empty) - A proxy to use when connecting to Qualys Cloud Platform Domain.
    • If supplied, Axonius will utilize the proxy when connecting to the host defined for this connection.
    • If not supplied, Axonius will connect directly to the host defined for this connection.

Action Settings

  1. Tags (required, default: empty) - Specify at least one new/existing tag in Qualys to be associated with each of the host assets in Qualys. Tag name is case sensitive.

    NOTE

    If Axonius will fail to create a tag or add tags to a host asset, Axonius will roll back the entire action and will fail it.

  2. Parent tag name (optional, default: empty) - Associate a Qualys tag as a parent tag of all the specified tags. Tag name is case sensitive.

    • If supplied, Axonius will add specified tag as a parent tag of all the specified tags.
    • If not supplied, Axonius will not set any parent tag for the specified tags.
    NOTE

    The specified tag must exist in Qualys. If it does not exist in Qualys, Axonius will fail to run the action.

Required Permissions

The value supplied in User Name must be associated with one of the following user roles and with the following permissions:

  1. Managers with full scope
  2. Other roles with the following permissions:
    • Desired host assets in scope.
    • Access to the API.
    • Tag permission: "Create User Tag", "Delete User Tag"
    • Asset Management permission: "Read Asset", "Update 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.


To learn more about configuring Enforcement Sets, see Configuring Enforcement Sets.


Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.