{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial"]},"type":"markdown"},"seo":{"title":"Qualys VMDR - Assets Integration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide walks you through creating a new Qualys Vulnerability Management, Detection & Response (VMDR) user for the purpose of creating an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["assets"]}," integration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-new-user-options","__idx":0},"children":["Required New User Options"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Option"},"children":["Option"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Access Type"},"children":["Access Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User Role"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Reader"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retrieve host inventory and asset tags"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GUI"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Complete first login, change the default password, and accept the EULA"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["API"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Allow the account to call Qualys APIs"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Asset Groups"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All, or the groups to include"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Control which hosts the account can retrieve"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configure-a-new-user-for-the-integration","__idx":1},"children":["Configure a new user for the integration"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-log-in-to-qualys-as-an-administrator","__idx":2},"children":["1. Log in to Qualys as an administrator"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An administrator in Qualys is a user assigned the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manager"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unit Manager"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Administrator"]}," role. That admin can create additional users, including a dedicated service user tied to an email account that remains active even after an employee leaves the company. User Administrators cannot create other User Administrator accounts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["User management for Qualys VMDR is in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vulnerability Management"]}," module."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After logging in, open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Vulnerability Management"]}," (VMDR) module. In the left sidebar, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Users"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the Users interface, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["General Information"]}," on the left, provide the required details, including First Name, Last Name, Title, Phone, Email Address, Address 1, and Country."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Role"]},", assign the role and access listed in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#required-new-user-options"},"children":["Required New User Options"]}," above, including the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GUI"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API"]}," boxes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Asset Groups"]}," on the left, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add asset groups"]}," and select either ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["All"]}," or the specific asset group(s) this integration should access."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," at the far right of the modal to create the user account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Note the new user entry. Qualys assigns a random ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["username"]},"; copy it for the integration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-complete-service-account-registration","__idx":3},"children":["2. Complete service account registration"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The registered email receives a message with a secure one-time link to begin registration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the link, verify the account details, then complete first GUI login: change the default password and accept the EULA."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After you log in, go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Help"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["About"]}," and copy the platform-specific ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API server URL"]},". Use this value as the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Base URL"]}," for API endpoints (not the UI login URL)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuring-the-integration","__idx":4},"children":["Configuring the Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To configure a new Qualys integration, provide each of the values as defined below:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Integration Parameter"},"children":["Integration Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The platform-specific API server URL copied from ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Help"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["About"]}," in Step 2. Use this URL for API endpoints, not the UI login URL."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Username"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Qualys-assigned username from Step 1."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Secret"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The password set on first GUI login in Step 2."]}]}]}]}]}]},"headings":[{"value":"Required New User Options","id":"required-new-user-options","depth":2},{"value":"Configure a new user for the integration","id":"configure-a-new-user-for-the-integration","depth":2},{"value":"1. Log in to Qualys as an administrator","id":"1-log-in-to-qualys-as-an-administrator","depth":3},{"value":"2. Complete service account registration","id":"2-complete-service-account-registration","depth":3},{"value":"Configuring the Integration","id":"configuring-the-integration","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/qualys-assets-setup","seo":{"title":"Qualys VMDR - Assets Integration Guide"}},"lastModified":"2026-09-08T23:22:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/qualys-assets-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}