Skip to main content
Draftt reads your hosts from Qualys. Hosts that match a cloud component in Draftt are enriched with the Qualys data, and every other host is added as its own resource.
Draftt’s access is read-only. It signs in and reads the host asset list. It never changes anything in Qualys.

Prerequisites

  • A Qualys subscription with Global AssetView (GAV) or CyberSecurity Asset Management (CSAM). Qualys returns operating system lifecycle data only for subscriptions with CSAM. Without CSAM, Draftt still reads the rest of the host data.
  • Hosts that report to Qualys, for example through the Qualys Cloud Agent.
  • A Qualys Manager, or another Qualys user who can create users and edit their permissions.
  • A Draftt user with the Developer or Admin role, and access to Integrations > Qualys.
If your Qualys subscription allows connections only from listed IP addresses, contact Draftt to get Draftt’s outbound IP addresses and add them to the allowed list in Qualys.
Qualys is enabled per Draftt account. If you do not see the Qualys card on the Integrations page, contact Draftt.

Setup

1

Create a dedicated Qualys user

Draftt signs in with the username and password of a Qualys user. Create a user that only Draftt uses, so that you can scope and rotate it without affecting anyone else.
  1. In Qualys, create a new user for Draftt.
  2. Keep SAML SSO turned off for this user. The Qualys API does not accept SSO sign-in, so a user with SSO enabled cannot connect.
  3. Give the user the Global AssetView / CyberSecurity Asset Management module.
  4. Give the user API access. For a user that is not a Manager, Qualys requires two settings:
    • In the Administration module, open the user’s Quick Actions, go to Roles and Scopes, and select API Access.
    • In the VMDR module, open the same user’s Quick Actions and, under User Role, select API.
  5. Check the user’s scope. Draftt sees only the assets that this user can see in Qualys. If you limit the user to some asset tags, Draftt reads only those hosts.
Qualys password policies apply to this user too. If your subscription expires passwords, ask Qualys about the Password never expires for API access option for API-only accounts, or plan to delete the integration and create it again at each password change.
2

Find your Qualys platform

Each Qualys subscription lives on one platform, and each platform has its own API gateway URL. The address you use to sign in to Qualys tells you which platform is yours. For example, https://qualysguard.qg2.apps.qualys.eu is the EU2 platform. Qualys lists all platforms and their URLs on its platform identification page.If your platform is not in Draftt’s list (for example GOV1 or a Qualys private platform), choose Other in the next step and enter your API gateway URL. Use the API gateway URL from the Qualys page, not the API server URL.
3

Connect in Draftt

  1. In Draftt, go to Integrations and open the Qualys card.
    The Qualys card on the Integrations page in Draftt.
  2. Enter an Integration Name of at least 3 characters.
  3. In Qualys Platform, choose your platform. For Other, enter the API Gateway URL. It must start with https://.
    The Qualys integration form in Draftt with the Qualys Platform list open, showing the platforms from US1 to KSA1 and the Other option.
  4. Enter the Username and Password of the Qualys user you created.
  5. Click Create Integration.
Draftt checks the connection to Qualys before it saves the integration. If that check fails, the integration is not created and you see Failed to validate Qualys integration. See Troubleshooting.Connect each Qualys subscription only once. Two integrations that read the same subscription overwrite each other’s hosts.After the integration is created, Draftt starts the first scan. The integration appears under Integrations > Qualys with its name, API URL and username. Draftt does not show the password again.
The Qualys Integrations list in Draftt with one connected integration, showing its name, API URL, username and creation date.

What Draftt reads

Draftt reads the host asset list of Global AssetView / CSAM. For each host it keeps:
  • Identity: DNS name, IP address, Qualys asset ID and UUID, agent ID. The asset name becomes the name of a standalone host.
  • Operating system: full name, version, architecture, and the Qualys lifecycle stage with end-of-life and end-of-support dates (CSAM only).
  • Installed software: name, publisher, version, type and install date, and the Qualys lifecycle stage with end-of-life and end-of-support dates (CSAM only). Operating system packages, libraries and utilities that Qualys marks as ignored are left out.
  • Hardware: manufacturer, model, serial number, CPU count, total memory, and volumes with their size and free space.
  • Agent and scan status: tracking method, agent version, last agent check-in, last scan, last boot.
  • Cloud identity: provider, instance ID, region and account ID, when Qualys knows that the host is a cloud instance.
Draftt does not read open ports, network interfaces, services, user accounts, business applications, Qualys tags or vulnerability detections (QIDs). Draftt shows these values as Qualys reports them. When Qualys reports a lifecycle stage without dates, Draftt shows the stage only.

How Qualys hosts appear in Draftt

Draftt matches each Qualys host to your cloud inventory by its cloud instance ID.
  • Hosts that match a cloud component. When Qualys reports an AWS EC2, Azure VM or GCP Compute Engine instance ID, and Draftt already has that component from a cloud integration, Draftt adds the Qualys data to the existing resource. No second resource is created.
  • Standalone hosts. Every other host (on-premises servers, workstations, and cloud instances from accounts that are not connected to Draftt) becomes its own resource with the technology Qualys. Its type follows the operating system that Qualys identified, for example Qualys - Ubuntu or Qualys - Windows Server, and its version is the operating system release, for example 22.04 or Windows Server 2019. If you connect the cloud account of a standalone host later, Draftt adds the Qualys data to the cloud component and removes the standalone resource at the next scan. Until then you can see both.

Refresh timing

Draftt reads Qualys on every scan cycle and once right after you create the integration. See scan frequency.

Troubleshooting

Failed to validate Qualys integration

Draftt validates the connection when you create the integration. All validation failures show the same message, so check these causes one by one:
  • The username or password is wrong, or the password has expired.
  • The platform is wrong. A Qualys user exists on one platform only, so the right credentials fail on any other platform.
  • The user has SAML SSO enabled. Turn SSO off for this user in Qualys.
  • The user has no API access. Enable API Access in the Administration module and API in the VMDR user role.
  • The user does not have the Global AssetView / CSAM module.
  • The Qualys account is locked after too many failed sign-in attempts. A Manager or Unit Manager must reactivate it in Qualys.
  • Your Qualys subscription allows connections only from listed IP addresses, and Draftt’s addresses are not on the list.
  • For Other: the URL is not your API gateway URL, or Draftt cannot reach it.

No lifecycle stage or dates

Qualys returns lifecycle data only for subscriptions with CSAM. It can also report a stage without dates for some operating system versions. If you cannot resolve a problem, contact Draftt support.