Integrations

ServiceNow Qualys Integration Guide

advancedBasic Authentication with Qualys API credentialsQualys

The ServiceNow Qualys integration automates vulnerability management by importing scan results from Qualys VMDR into ServiceNow's Vulnerability Response application, creating a centralized view of security posture across your IT infrastructure. This integration solves the critical business problem of fragmented vulnerability data by consolidating Qualys findings with CMDB asset information, enabling security and IT operations teams to prioritize remediation efforts based on asset criticality and business impact. The integration supports unidirectional data flow from Qualys to ServiceNow, triggered either by scheduled imports or real-time API calls when new vulnerabilities are discovered. Primary automation patterns include automatic incident creation for critical vulnerabilities, assignment to appropriate teams based on CMDB relationships, and SLA-driven remediation workflows within the Vulnerability Response module.

Prerequisites

  • ServiceNow Quebec or later with Vulnerability Response application installed and activated
  • Integration Hub Professional license for advanced orchestration capabilities
  • Qualys VMDR subscription with API access enabled
  • Qualys Manager or Unit Manager role for API credential generation
  • ServiceNow admin role with access to Connection & Credential management
  • CMDB populated with accurate CI relationships for asset correlation
  • MID Server deployed if scanning internal network assets behind firewalls

Architecture Overview

The integration utilizes the ServiceNow IntegrationHub Qualys spoke, which provides pre-built actions for vulnerability data import and asset synchronization. Authentication is established using Qualys API credentials stored in a ServiceNow Connection & Credential Alias, which securely manages the username, password, and API endpoint URL for the Qualys platform. Data flows unidirectionally from Qualys to ServiceNow through scheduled orchestration workflows or on-demand API calls, triggered by either time-based schedules or external webhook events. A MID Server is required when importing vulnerabilities for internal assets that Qualys scans behind corporate firewalls, as the integration needs network connectivity to correlate scan results with CMDB configuration items. The Qualys API enforces rate limiting of 300 requests per hour per user account, and the integration respects these limits through built-in throttling mechanisms in the spoke actions.

Sourdough
Chrome Extension

Sourdough: ServiceNow Monitoring and Analytics

A Chrome extension for ServiceNow Admins and Developers with essential tools, analytics, graphs and monitoring features.

Instance HealthGraphs & ChartsAPI HealthDeveloper ToolsQuick SearchInstance Switcher
Add to Chrome

Free to install. Pro $5/month after a 14-day no-card trial.
Pro requires the ServiceNow admin role. Upgrade inside the extension.

Overview
Tasks
CMDB
API
Metrics
Monitor
Internals
Instance:sourdoughdev·Version:Yokohama
Instance StateONLINE
System StatusFully Operational
Session Timeout90 minutes
Logged-In Sessions2 (20 active)
Build Nameyokohama-12-18-2024_p1
IP Address10.159.128.43
Instance HealthHealth Score: 90%
🔥 5dSourdough (Chrome Plugin)Dark Mode

Implementation Steps

1

Install Qualys IntegrationHub spoke from ServiceNow Store

Navigate to System Applications > All Available Applications > All and search for 'Qualys' in the ServiceNow Store. Install the 'IntegrationHub ETL Qualys Spoke' application, which provides pre-built actions for vulnerability import and asset correlation. After installation, activate the spoke by navigating to Process Automation > Spokes and confirming the Qualys spoke shows as 'Active'. Verify the spoke includes actions like 'Get Host Assets', 'Get Vulnerabilities', and 'Get Knowledge Base' which are essential for the integration. Note that installation requires Integration Hub Professional license and may take several minutes to complete the spoke activation process.

2

Generate Qualys API credentials and configure platform access

Log into your Qualys VMDR console and navigate to Users > User Management to create a dedicated service account for the ServiceNow integration. Assign the service account 'Manager' or 'Unit Manager' role to ensure sufficient API permissions for vulnerability and asset data access. Generate API credentials and note your specific Qualys platform URL (e.g., qualysapi.qg2.apps.qualys.com for US Platform 2). Document the username, password, and API endpoint as these will be required for ServiceNow credential configuration. Verify API access by testing a simple curl command to ensure the credentials work before proceeding to ServiceNow configuration.

3

Create Connection & Credential Alias in ServiceNow

Navigate to Connections & Credentials > Connections and create a new connection record with Name 'Qualys VMDR Connection' and Connection URL set to your Qualys API endpoint. Create a corresponding credential by going to Connections & Credentials > Credentials and selecting 'Basic Auth Credentials' type. Enter your Qualys service account username and password, then associate this credential with the connection record created in the previous step. Test the connection using the 'Test Connection' button to verify successful authentication with the Qualys platform before proceeding. Ensure the connection alias name is memorable as it will be referenced in orchestration workflows.

4

Configure asset correlation rules between Qualys and CMDB

Navigate to Vulnerability Response > Administration > Data Sources and create a new Qualys data source record specifying your connection alias. Configure asset correlation rules by mapping Qualys host attributes (IP address, hostname, NetBIOS name) to CMDB CI identification fields in the 'Asset Correlation' section. Set up correlation priority rules where IP address matching takes precedence, followed by FQDN matching, then hostname matching to ensure accurate asset identification. Test asset correlation by running a sample import on a small subset of assets and verify that Qualys hosts correctly map to existing CMDB configuration items. Review the correlation results in the Data Source Import Sets to identify and resolve any mapping issues before full-scale deployment.

5

Create orchestration workflow for vulnerability data import

Navigate to Process Automation > Designer and create a new workflow named 'Qualys Vulnerability Import' with a scheduled trigger set to run daily during off-peak hours. Add the Qualys spoke action 'Get Vulnerabilities' and configure it to use your connection alias, setting appropriate date filters to import only recent vulnerabilities (e.g., last 30 days). Configure the workflow to process vulnerability data in batches of 100 records to respect API rate limits and prevent timeout issues. Add error handling logic using Try-Catch activities to manage API failures gracefully and send notifications to administrators when imports fail. Include a final action to update the data source record with the last successful import timestamp for audit and troubleshooting purposes.

ServiceNow Script
// Configure vulnerability import with date filtering
var dateFilter = new GlideDateTime();
dateFilter.addDaysLocalTime(-30);

var importParams = {
    'connection': 'Qualys VMDR Connection',
    'filters': {
        'since': dateFilter.getDisplayValue(),
        'status': 'New,Active,Fixed'
    },
    'batch_size': 100
};

// Log import parameters for troubleshooting
gs.info('Starting Qualys vulnerability import with parameters: ' + JSON.stringify(importParams));
6

Configure automated incident creation for critical vulnerabilities

Navigate to Vulnerability Response > Administration > Response Rules and create a new rule triggered when vulnerabilities with CVSS score >= 9.0 are imported from Qualys. Configure the rule action to automatically create incident records in the Security Incident table, populating fields like short description, assignment group, and priority based on vulnerability severity and affected CI attributes. Set up conditional logic to assign incidents to different teams based on the affected CI's support group or location, ensuring proper routing for remediation activities. Include vulnerability details, affected asset information, and remediation guidance in the incident work notes to provide complete context for response teams. Test the rule by importing a sample critical vulnerability and verifying that the incident is created with appropriate field values and assignments.

ServiceNow Script
// Response rule script for critical vulnerability incident creation
(function() {
    var vulnGR = new GlideRecord('sn_vul_vulnerable_item');
    vulnGR.get(current.sys_id);
    
    var incident = new GlideRecord('incident');
    incident.initialize();
    incident.short_description = 'Critical Vulnerability: ' + vulnGR.vulnerability.title;
    incident.description = 'CVSS Score: ' + vulnGR.vulnerability.cvss3_score + '\nAffected Asset: ' + vulnGR.configuration_item.name;
    incident.priority = '1';
    incident.category = 'Security';
    incident.assignment_group = vulnGR.configuration_item.support_group;
    incident.configuration_item = vulnGR.configuration_item;
    incident.insert();
    
    gs.info('Created incident ' + incident.number + ' for critical vulnerability ' + vulnGR.vulnerability.cve);
})();
7

Set up vulnerability remediation tracking and reporting

Configure vulnerability state synchronization by creating a workflow that updates Qualys vulnerability status when ServiceNow remediation tasks are completed. Navigate to Vulnerability Response > Dashboards and customize the executive dashboard to display Qualys-specific metrics including vulnerability age, CVSS score distribution, and remediation SLA performance. Create scheduled reports for security teams showing trending vulnerability counts by severity, affected asset groups, and mean time to remediation for Qualys-discovered vulnerabilities. Set up automated notifications to asset owners when new high-severity vulnerabilities are discovered on their systems, including remediation guidance and expected timeline for resolution. Configure the vulnerability aging calculation to account for Qualys discovery dates and ensure accurate SLA tracking throughout the remediation lifecycle.

ServiceNow Script
// Script to update Qualys vulnerability status after ServiceNow remediation
var updateQualys = new sn_ih_orchestration.IntegrationHub();
var qualysAction = updateQualys.getAction('Qualys', 'Update Vulnerability Status');

qualysAction.setParameter('connection_alias', 'Qualys VMDR Connection');
qualysAction.setParameter('vulnerability_id', current.external_id);
qualysAction.setParameter('status', 'FIXED');
qualysAction.setParameter('comments', 'Remediated via ServiceNow incident ' + current.incident.number);

var result = qualysAction.execute();
if (result.getStatusCode() == 200) {
    gs.info('Successfully updated Qualys vulnerability status for ' + current.vulnerability.cve);
} else {
    gs.error('Failed to update Qualys vulnerability status: ' + result.getErrorMessage());
}
8

Test integration end-to-end and implement monitoring

Execute a complete test cycle by triggering the vulnerability import workflow manually and verifying that Qualys data appears correctly in ServiceNow vulnerability records with proper asset correlation. Validate that critical vulnerabilities automatically generate incidents with appropriate assignments and that all field mappings are accurate. Set up integration monitoring by creating event rules that trigger alerts when vulnerability imports fail, API authentication errors occur, or asset correlation rates drop below acceptable thresholds. Configure dashboard widgets to display real-time integration health metrics including last successful import time, daily vulnerability counts, and API error rates. Document the integration configuration, create runbooks for common troubleshooting scenarios, and train security operations staff on the new automated workflows and reporting capabilities.

ServiceNow Script
// Integration health monitoring script
var healthCheck = new GlideRecord('u_integration_health');
healthCheck.initialize();
healthCheck.integration_name = 'Qualys VMDR';
healthCheck.last_successful_run = new GlideDateTime();

// Check for recent vulnerability imports
var vulnCount = new GlideAggregate('sn_vul_vulnerable_item');
vulnCount.addQuery('sys_created_on', '>=', gs.daysAgoStart(1));
vulnCount.addQuery('source', 'Qualys');
vulnCount.query();

healthCheck.daily_record_count = vulnCount.getRowCount();
healthCheck.status = vulnCount.getRowCount() > 0 ? 'Healthy' : 'Warning';
healthCheck.insert();

gs.info('Integration health check completed: ' + vulnCount.getRowCount() + ' vulnerabilities imported today');

Common Use Cases

Automated critical vulnerability incident creation

When Qualys discovers vulnerabilities with CVSS scores above 9.0, ServiceNow automatically creates security incidents assigned to the appropriate IT teams based on affected asset ownership. The incident includes complete vulnerability context, affected CI details, and links to Qualys remediation guidance. This automation ensures critical security issues receive immediate attention without manual intervention, reducing mean time to response from hours to minutes. Integration with CMDB data enables proper incident routing based on asset support groups and business service relationships.

Asset-based vulnerability reporting and prioritization

Security teams leverage ServiceNow's reporting capabilities to analyze Qualys vulnerability data in the context of business-critical assets and services. Reports combine vulnerability severity with asset criticality ratings from the CMDB to prioritize remediation efforts on systems supporting revenue-generating applications. Dashboard widgets display vulnerability trends by business unit, asset type, and geographic location, enabling executive-level security posture visibility. The integration correlates multiple vulnerability scanners through ServiceNow's unified data model while maintaining Qualys as the authoritative source for external network vulnerabilities.

SLA-driven vulnerability remediation workflows

ServiceNow enforces vulnerability remediation SLAs based on CVSS scores and affected asset criticality, automatically escalating overdue items to management. Qualys vulnerability data flows into ServiceNow's workflow engine, triggering automated task assignments to system administrators with appropriate skills and access. Integration with ServiceNow's approval processes ensures that system changes required for vulnerability remediation follow proper change management procedures. Automated status synchronization updates Qualys when vulnerabilities are remediated through ServiceNow processes, maintaining data consistency across platforms.

Compliance reporting and audit trail maintenance

Organizations use the integrated platform to generate compliance reports combining Qualys scan results with ServiceNow remediation evidence for audit purposes. The system maintains complete audit trails showing vulnerability discovery dates, notification timestamps, remediation activities, and verification steps. Integration enables automated compliance scoring by correlating vulnerability remediation rates with regulatory requirements like PCI DSS or SOX. ServiceNow's reporting framework aggregates Qualys data across multiple scanner deployments, providing enterprise-wide vulnerability management metrics for compliance assessments.

Cross-platform vulnerability correlation and deduplication

When organizations deploy multiple vulnerability scanners, ServiceNow serves as the central correlation engine to identify duplicate findings between Qualys and other security tools. The platform uses CMDB asset relationships and CVE identifiers to merge vulnerability records from different sources while preserving scanner-specific metadata. Automated deduplication rules prevent duplicate incident creation when the same vulnerability is detected by multiple tools, reducing alert fatigue for security teams. Integration enables comprehensive vulnerability coverage analysis by identifying scanning gaps where Qualys results differ from other security assessment tools.

Troubleshooting

Qualys API returns 401 Unauthorized errors during vulnerability import

First, verify the service account credentials are correct by testing them directly against the Qualys API using a REST client or curl command. Navigate to Connections & Credentials > Credentials and update the stored password if it has expired or been changed in Qualys. Check that the service account has sufficient permissions in Qualys by ensuring it has Manager or Unit Manager role assignment. Review the connection alias configuration to confirm the API endpoint URL matches your Qualys platform region, as authentication will fail if pointing to the wrong regional API gateway.

Asset correlation fails with high percentage of unmatched Qualys hosts

Navigate to Vulnerability Response > Data Sources and review the asset correlation rules to ensure proper field mappings between Qualys host attributes and CMDB CI identification fields. Check that CMDB configuration items have accurate IP addresses, hostnames, and FQDN values populated, as empty or incorrect data prevents successful correlation. Run discovery against the affected IP ranges to refresh CMDB asset data before re-attempting the correlation process. Consider adding additional correlation rules using MAC addresses or custom Qualys host tags if standard hostname and IP matching proves insufficient for your environment.

Vulnerability import workflow timeouts with large result sets

Reduce the batch size in the Qualys spoke action configuration from the default to smaller chunks of 50-100 vulnerabilities per API call to prevent timeout issues. Implement date-based filtering to import only recent vulnerabilities instead of full historical data, using rolling 30-day windows for regular imports. Configure the workflow timeout settings to allow longer execution times during initial data loads, then adjust to more aggressive timeouts for routine operations. Add workflow checkpointing logic to resume imports from the last successful batch in case of interruption, preventing the need to restart complete imports from the beginning.

Duplicate incident creation for the same vulnerability across multiple imports

Implement deduplication logic in your response rules by checking for existing incidents related to the same vulnerability ID and affected configuration item before creating new records. Add a business rule on the vulnerable item table that prevents multiple incident creation by maintaining a status field indicating whether an incident has already been generated. Configure the vulnerability import process to update existing records rather than creating duplicates when the same vulnerability is detected in subsequent Qualys scans. Review the Qualys external ID mapping to ensure consistent vulnerability identification across import cycles, as changing IDs can cause duplicate record creation.

API rate limit exceeded errors causing integration failures

Configure the orchestration workflow with appropriate wait steps between Qualys API calls to respect the 300 requests per hour rate limit imposed by Qualys. Implement exponential backoff logic in error handling to automatically retry failed requests after increasing delay periods when rate limits are encountered. Consider creating multiple Qualys service accounts and rotating between them for high-volume imports, though ensure each account has proper permissions and coordinate to avoid conflicts. Schedule vulnerability imports during off-peak hours and distribute large imports across multiple time windows to spread API usage throughout the day.

Missing vulnerability details or incomplete field mapping from Qualys

Review the Qualys API response structure by enabling debug logging in the spoke action configuration to identify which fields are being returned but not mapped to ServiceNow tables. Navigate to System Import Sets > Transform Maps and verify that all desired Qualys vulnerability fields have corresponding mapping rules to ServiceNow vulnerability record fields. Check for API version differences between your Qualys platform and the spoke configuration, as field names or structures may have changed requiring custom mapping adjustments. Update the spoke action parameters to request additional vulnerability details like CVSS vectors, exploit information, or remediation guidance if these fields are missing from imported records.

Pro Tips

  • Configure vulnerability import workflows to run during maintenance windows to minimize impact on system performance, and implement circuit breaker patterns that automatically disable imports if error rates exceed 10% to prevent cascade failures. Use ServiceNow's scheduled script execution monitoring to track import job performance and set up automated alerts when processing times exceed baseline metrics.
  • Leverage ServiceNow's transform map scripting capabilities to enrich Qualys vulnerability data with business context during import, such as adding asset owner information from CMDB relationships or calculating business risk scores based on service dependencies. This real-time enrichment eliminates the need for post-processing workflows and improves response team efficiency.
  • Implement sophisticated asset correlation logic that accounts for dynamic IP addressing and cloud environments by combining multiple matching criteria including MAC addresses, AWS instance IDs, and custom Qualys asset tags. Create fallback correlation rules that create placeholder CIs for orphaned vulnerabilities to ensure no security findings are lost due to correlation failures.
  • Design incident auto-assignment rules that consider current team workloads and on-call schedules by integrating with ServiceNow's workforce optimization features, preventing vulnerability remediation bottlenecks during peak periods. Include escalation paths that automatically reassign stale incidents to backup teams if primary assignees don't acknowledge critical vulnerabilities within defined SLA timeframes.
  • Set up advanced reporting dashboards that combine Qualys vulnerability trends with ServiceNow change management data to identify correlations between system modifications and new security findings. Use ServiceNow's predictive intelligence capabilities to forecast vulnerability discovery patterns and proactively adjust scanning schedules and remediation resource allocation.
  • Configure webhook-based real-time integration for critical vulnerabilities by setting up Qualys to send immediate notifications to ServiceNow when high-severity findings are discovered, bypassing scheduled import delays. Implement intelligent filtering to prevent alert fatigue while ensuring zero-day exploits and actively exploited vulnerabilities trigger immediate incident creation and notification workflows.

Known Limitations

  • The Qualys API enforces strict rate limiting of 300 requests per hour per service account, which can significantly impact large-scale vulnerability imports requiring careful batch sizing and scheduling coordination. Organizations with extensive asset inventories may need multiple service accounts or extended import windows to accommodate these restrictions without causing integration failures.
  • Asset correlation between Qualys scan results and ServiceNow CMDB depends heavily on accurate and up-to-date configuration item data, particularly IP addresses and hostnames that frequently change in dynamic cloud environments. Poor CMDB data quality can result in correlation rates below 70%, requiring significant data cleanup efforts and ongoing maintenance to achieve acceptable matching performance.
  • The integration does not support bidirectional data synchronization for vulnerability remediation verification, meaning ServiceNow cannot automatically trigger Qualys rescans or update vulnerability status in the Qualys platform without additional custom development. This limitation requires manual coordination between security teams for vulnerability lifecycle management and may impact compliance reporting accuracy.
  • ServiceNow's Vulnerability Response application requires Integration Hub Professional licensing for advanced orchestration capabilities, adding significant cost overhead for organizations that only need basic vulnerability import functionality. The spoke actions also have limited customization options without modifying the underlying IntegrationHub flow definitions.
  • Real-time integration capabilities are constrained by Qualys webhook limitations and ServiceNow's inbound processing capacity, typically introducing 5-15 minute delays between vulnerability discovery and ServiceNow record creation even in optimal configurations. High-volume environments may experience longer delays during peak scanning periods when API queues become congested.

Frequently Asked Questions

How do I handle vulnerability data for assets that exist in Qualys but not in the ServiceNow CMDB?

ServiceNow can automatically create placeholder configuration items for unmatched Qualys assets by enabling the 'Create Missing CIs' option in your data source configuration. These placeholder CIs contain basic information from the Qualys scan results like IP address, hostname, and operating system details. You should establish a regular process to review and enrich these placeholder CIs with proper CMDB attributes like ownership, location, and business service relationships. Consider integrating with ServiceNow Discovery to automatically populate detailed CI information for systems that Qualys identifies but aren't yet documented in your CMDB.

Can I customize the vulnerability severity scoring to use our organization's risk assessment instead of standard CVSS scores?

Yes, you can implement custom severity scoring by modifying the transform map scripts during vulnerability import to calculate organization-specific risk scores based on asset criticality, threat intelligence feeds, and business impact factors. Create additional fields on the vulnerability table to store both the original CVSS score and your custom risk score for comparison and reporting purposes. Use ServiceNow's scripted calculators or business rule logic to dynamically adjust severity based on factors like asset business criticality ratings from CMDB, active threat intelligence indicators, or compensating security controls. Ensure your custom scoring logic is well-documented and consistently applied across all vulnerability sources for meaningful risk prioritization.

What happens to ServiceNow vulnerability records when the corresponding vulnerabilities are fixed and no longer appear in Qualys scans?

ServiceNow handles resolved vulnerabilities through configurable lifecycle management rules that can automatically update vulnerability status to 'Fixed' when they no longer appear in subsequent Qualys imports. You can configure the data source to maintain historical vulnerability records for audit purposes while marking them as resolved based on absence from recent scans. Implement retention policies that archive old vulnerability records after defined periods while preserving remediation evidence and compliance documentation. Consider setting up validation workflows that verify vulnerability resolution through additional scanning or manual confirmation before marking items as permanently fixed, especially for critical security findings.

How can I integrate Qualys vulnerability data with ServiceNow's change management process for coordinated remediation?

Create automated workflows that generate change requests when vulnerability remediation requires system modifications, linking the change record to the originating vulnerability and affected configuration items. Configure approval workflows that route change requests to appropriate technical teams and business stakeholders based on asset criticality and service impact assessments. Use ServiceNow's impact analysis capabilities to identify downstream dependencies that might be affected by remediation activities, ensuring comprehensive change planning. Implement post-implementation validation steps that automatically update vulnerability status once changes are successfully completed and verified through follow-up scanning or manual confirmation processes.

Is it possible to configure different import schedules and processing rules for different Qualys scanner appliances or scan types?

Yes, you can create multiple data sources in ServiceNow Vulnerability Response, each configured with different connection aliases pointing to specific Qualys scanner appliances or configured to filter for particular scan types or asset groups. Configure separate orchestration workflows for each data source with customized scheduling, batch sizes, and processing logic appropriate for different scanning frequencies and priorities. Use Qualys API filtering parameters to segment imports by scan type, asset tags, or network ranges, enabling different processing rules for internal network scans versus external perimeter assessments. This approach allows optimized import schedules where critical asset scans import hourly while comprehensive network assessments import daily, matching your organization's risk management priorities.

How do I troubleshoot asset correlation issues when Qualys host names don't match CMDB configuration item names?

Start by analyzing correlation patterns in the import set tables to identify common naming convention differences between Qualys and CMDB, such as FQDN versus short hostnames or case sensitivity mismatches. Create custom correlation rules using ServiceNow's advanced matching capabilities that can handle variations like hostname truncation, domain suffix differences, or alternative naming schemes. Implement fuzzy matching logic in transform map scripts that can correlate assets based on partial string matches or regular expression patterns when exact matches fail. Consider maintaining a correlation mapping table that manually links problematic assets and leverage this during the import process to improve correlation rates while addressing underlying data quality issues in both systems.

What are the best practices for managing ServiceNow storage consumption with high-volume vulnerability imports from Qualys?

Implement intelligent data retention policies that automatically archive or delete vulnerability records older than your compliance requirements, typically 1-3 years depending on regulatory frameworks and internal audit needs. Configure import filters to exclude low-severity vulnerabilities or informational findings that don't require active remediation, focusing storage on actionable security issues. Use ServiceNow's data archiving capabilities to move historical vulnerability data to separate archive tables while maintaining reporting access for trend analysis and compliance documentation. Establish monitoring dashboards that track vulnerability table growth rates and alert administrators when storage consumption exceeds defined thresholds, enabling proactive capacity management and optimization decisions.

Test Your Knowledge

Quick 3-question quiz — see how your ServiceNow skills stack up.

Question 1 of 3Performance

A list view on a table with millions of records is slow. Best fix?

Select an answer to continue