Qualys ServiceNow Integration Guide

Share

Qualys ServiceNow

Introduction

Qualys ServiceNow integration connects Qualys vulnerability and security data with ServiceNow workflows so that security findings can be converted into actionable IT tasks, assigned to the right teams, tracked through remediation, and closed with evidence. In a real enterprise environment, this integration is useful when security teams operate Qualys while infrastructure, application, and service-management teams work primarily in ServiceNow.

This is primarily a Technical / Integration Topic because the implementation involves API communication, authentication, vulnerability-data mapping, incident or security-response workflows, synchronization, error handling, and potentially integration middleware such as Oracle Integration Cloud (OIC) when Oracle applications are part of the wider enterprise architecture.

Version note: Qualys and ServiceNow capabilities change independently. The implementation approach below focuses on the integration architecture and implementation patterns rather than assuming a specific vendor UI release. Always validate current API names, authentication options, and integration capabilities against the documentation for the versions deployed in your environment.


What Is Qualys ServiceNow Integration?

Qualys is commonly used for vulnerability management, asset discovery, compliance, and security assessment. ServiceNow provides the workflow layer used by IT, security, operations, and service-management teams.

A typical integration creates a flow such as:

Qualys detects vulnerability → vulnerability data is retrieved → ServiceNow receives the finding → assignment occurs → remediation team fixes the issue → ServiceNow records remediation → Qualys is checked again → finding is closed or updated.

The important point is that the integration should not simply copy every Qualys record into ServiceNow.

A production implementation normally establishes rules for:

  • Which vulnerabilities should create ServiceNow records
  • Which assets are in scope
  • How vulnerabilities are prioritized
  • Which ServiceNow group owns remediation
  • How duplicate findings are prevented
  • How remediation status is synchronized
  • When a ticket can be automatically closed
  • How failed integrations are retried
  • How audit information is retained

This distinction becomes important in large environments. A Qualys scan can produce thousands of findings, while the ServiceNow environment may need only a controlled subset of actionable records.


Key Components of a Qualys–ServiceNow Architecture

A practical architecture usually contains these logical components:

ComponentResponsibility
QualysVulnerability and asset data source
Qualys APIs / integration interfaceExposes security findings
Integration layerRetrieves, transforms, filters, and routes data
ServiceNowWorkflow, assignment, remediation tracking
ServiceNow tables / applicationsStore vulnerability and task information
CMDBProvides asset and ownership context
Notification mechanismCommunicates assignments and escalations
MonitoringTracks integration failures and processing status

In some organizations, ServiceNow communicates directly with Qualys.

In more complex architectures, an integration platform such as Oracle Integration Cloud Gen 3 can participate when Qualys or ServiceNow needs to exchange data with Oracle Fusion applications or other enterprise systems.

For example:

Qualys → OIC Gen 3 → ServiceNow

or:

Qualys → ServiceNow → Oracle Fusion / OIC

The correct architecture depends on the ownership of the data and the systems that need to participate in the workflow.


Real-World Qualys ServiceNow Integration Use Cases

Use Case 1 – Automatic Vulnerability Ticket Creation

A company runs regular Qualys vulnerability scans across production servers.

Qualys identifies:

  • Critical vulnerabilities
  • High vulnerabilities
  • Affected server
  • Vulnerability identifier
  • Detection date
  • Severity
  • Evidence
  • Remediation information

Instead of a security analyst manually creating tickets, the integration sends qualifying findings to ServiceNow.

A ServiceNow security task can then be assigned automatically to the infrastructure team.

For example:

Qualys FindingServiceNow Action
CriticalCreate high-priority remediation task
HighCreate remediation task
MediumCreate task according to policy
LowKeep in Qualys unless specifically required

The filtering policy should be agreed with security and operations teams before development.


Use Case 2 – Vulnerability Remediation Tracking

Consider a production Linux server with a critical vulnerability.

Qualys identifies the vulnerability and ServiceNow creates a remediation task.

The workflow might be:

  1. Qualys detects vulnerability.
  2. ServiceNow receives finding.
  3. CMDB identifies server owner.
  4. ServiceNow assigns task to server-support group.
  5. Engineer applies patch.
  6. Engineer updates remediation status.
  7. Qualys performs another scan.
  8. Vulnerability is no longer detected.
  9. Integration updates the ServiceNow record.
  10. ServiceNow closes the remediation task according to the configured workflow.

This provides security teams with an end-to-end audit trail.


Use Case 3 – CMDB-Based Ownership

One of the most common implementation challenges is determining who should fix a vulnerability.

Qualys may know that a vulnerability exists on:

WEB-SERVER-001

But Qualys data alone may not contain the complete organizational ownership model.

ServiceNow CMDB may contain:

  • Configuration item
  • Application
  • Business owner
  • Technical owner
  • Support group
  • Environment
  • Location
  • Business criticality

The integration can use the asset identifier to correlate the Qualys asset with the ServiceNow CI.

The resulting workflow becomes:

Qualys Asset → ServiceNow CI → Application → Support Group → Remediation Task

This is significantly more useful than assigning every security ticket to one generic security queue.


Architecture and Technical Flow

A simplified technical architecture looks like this:

 
                  +----------------------+
                  |       Qualys         |
                  | Vulnerability Data   |
                  +----------+-----------+
                             |
                             | API / Integration
                             v
                  +----------------------+
                  | Integration Layer    |
                  | Filtering            |
                  | Transformation       |
                  | Deduplication        |
                  | Error Handling       |
                  +----------+-----------+
                             |
                             v
                  +----------------------+
                  |     ServiceNow       |
                  | Vulnerability / Task  |
                  | Workflow             |
                  +----------+-----------+
                             |
              +--------------+--------------+
              |                             |
              v                             v
       +-------------+               +-------------+
       |    CMDB     |               | Assignment  |
       | Asset Data  |               | & Workflow  |
       +-------------+               +-------------+
 

The integration generally performs four major activities:

1. Extract

Retrieve qualifying vulnerability or asset information from Qualys.

2. Transform

Convert Qualys data into the structure expected by ServiceNow.

For example:

 
Qualys Asset ID
        ↓
ServiceNow CI Identifier

Qualys Severity
        ↓
ServiceNow Priority

Qualys Vulnerability ID
        ↓
Security Finding Reference
 

3. Load

Create or update the appropriate ServiceNow record.

4. Reconcile

Compare current Qualys status against the ServiceNow record.

This final step is critical.

An integration that only creates tickets can produce stale ServiceNow data.


Prerequisites

Before development begins, collect the following information.

Qualys prerequisites

You should establish:

  • Qualys subscription/environment details
  • API access
  • API user or service account
  • Authentication method
  • API endpoint
  • Required permissions
  • Vulnerability data required
  • Asset identifiers
  • Scan or detection information
  • API rate limits

Do not request excessive permissions for the integration account.


ServiceNow prerequisites

Identify:

  • ServiceNow instance
  • Required application/plugin
  • Integration user
  • Authentication method
  • Target tables or APIs
  • Required roles
  • CMDB configuration
  • Assignment groups
  • Security workflow
  • Duplicate-handling rules

The target ServiceNow data model should be agreed before writing mappings.


Integration prerequisites

For a middleware-based architecture, define:

  • Source endpoint
  • Target endpoint
  • Authentication
  • Scheduling frequency
  • Payload format
  • Mapping rules
  • Error handling
  • Retry strategy
  • Logging requirements
  • Monitoring
  • Alerting

If Oracle Integration Cloud Gen 3 is being used, create separate connections for the source and target systems and keep credentials outside the orchestration logic.


Step-by-Step Qualys ServiceNow Integration Build

Step 1 – Define the Business Scope

Do not start with API development.

First document exactly what should happen.

For example:

Create ServiceNow remediation tasks only for production assets with Critical or High vulnerabilities that remain open after the defined detection period.

A basic requirements matrix can look like:

RequirementExample
Asset scopeProduction
SeverityCritical, High
TargetServiceNow security task
AssignmentCI support group
Duplicate ruleExisting open finding
ClosureVulnerability no longer detected
FrequencyEvery 30 minutes
Retry3 attempts

Step 2 – Identify the Qualys Data

Determine which Qualys information is required.

Typical fields include:

  • Vulnerability identifier
  • Asset identifier
  • Hostname
  • IP address
  • Severity
  • Detection date
  • Status
  • Operating system
  • Detection details
  • Remediation information

Do not map every available field automatically.

Start with fields required for business processing and auditability.


Step 3 – Configure Qualys API Access

Create a dedicated integration identity according to your organization’s Qualys security model.

Validate:

  • Authentication
  • API permissions
  • API endpoint
  • Required modules
  • Response format
  • Filtering capabilities

Test the API independently before connecting it to ServiceNow.

A successful API test should demonstrate that the integration identity can retrieve the exact vulnerability data required by the process.


Step 4 – Configure ServiceNow Access

Create or use a dedicated integration account.

Configure the required roles and API access.

Identify the appropriate ServiceNow endpoint and target record structure.

Before building the integration, manually create one test record in ServiceNow.

This helps answer an important implementation question:

What exactly should the integration create?

For example, the organization may want:

  • Security Incident
  • Vulnerability item
  • Remediation task
  • Change-related task
  • Custom security record

The answer depends on the ServiceNow applications implemented by the organization.


Step 5 – Build the Data Mapping

Create a mapping document before implementing transformations.

Example:

QualysServiceNow
Vulnerability IDFinding reference
Asset IDCI correlation key
SeverityPriority
HostnameConfiguration item
Detection statusFinding status
First detectedOpened date
Last detectedLast observed
RemediationResolution guidance

Do not assume that two fields with similar names have identical meanings.


Step 6 – Implement Asset Correlation

Asset correlation is one of the most important parts of the solution.

Possible correlation values include:

  • Hostname
  • IP address
  • Cloud instance ID
  • Qualys asset identifier
  • Serial number
  • DNS name

A mature implementation establishes a preferred matching hierarchy.

For example:

 
Cloud Instance ID
       ↓
Qualys Asset ID
       ↓
Hostname
       ↓
IP Address
 

The exact hierarchy depends on the organization’s CMDB quality.

If correlation fails, do not silently create an incorrectly assigned ticket.

Instead, route the record to an exception queue.


Step 7 – Implement Deduplication

Suppose Qualys reports the same vulnerability during several scans.

Without deduplication, ServiceNow could receive multiple tickets for the same issue.

A practical logical key might combine:

 
Asset + Vulnerability ID
 

or, where necessary:

 
Asset + Vulnerability + Detection Instance
 

The correct key should be defined with the security team.

Before creating a new record:

  1. Search ServiceNow for an existing open finding.
  2. Compare the correlation key.
  3. Update the existing record if found.
  4. Create a new record only when no applicable record exists.

Step 8 – Implement Priority Mapping

Do not directly assume that Qualys severity equals ServiceNow priority.

For example:

Qualys SeverityBusiness RuleServiceNow Priority
CriticalProductionHighest remediation priority
HighProductionHigh priority
MediumProductionStandard remediation
LowPolicy dependentMonitoring / task

Organizations often introduce additional factors such as:

  • Production vs non-production
  • Internet exposure
  • Business criticality
  • Exploit availability
  • Regulatory impact
  • Application criticality

Therefore, severity mapping should be treated as a business rule rather than a simple technical transformation.


Testing the Integration

Testing should occur in controlled stages.

Test 1 – Authentication

Verify that:

  • Qualys authentication succeeds.
  • ServiceNow authentication succeeds.
  • Credentials are securely managed.
  • Unauthorized requests are rejected.

Test 2 – Positive Vulnerability Test

Use a controlled Qualys finding that meets the integration criteria.

Expected result:

 
Qualys Finding
      ↓
Integration
      ↓
ServiceNow Record
 

Validate:

  • Vulnerability identifier
  • CI
  • Severity
  • Assignment group
  • Description
  • Detection information
  • Source reference

Test 3 – Duplicate Test

Process the same finding again.

Expected behavior:

No second ServiceNow record should be created.

The existing record should be updated according to the integration rules.


Test 4 – Asset Correlation Failure

Send a finding for an asset that does not exist in the CMDB.

Expected behavior:

  • Finding is not incorrectly assigned.
  • Exception is logged.
  • Security/CMDB team can investigate.
  • Original Qualys information is preserved.

Test 5 – Remediation Closure

After remediation, allow Qualys to reflect the changed vulnerability state.

The integration should recognize the updated state and update ServiceNow according to the agreed closure workflow.

This test is especially important because many integrations successfully create records but fail during the lifecycle-management stage.


Common Errors and Troubleshooting

Authentication failures

Symptoms:

  • HTTP 401/403 responses
  • Invalid credentials
  • Token failures

Check:

  1. Integration account.
  2. Required roles.
  3. Authentication configuration.
  4. Endpoint.
  5. Token or credential expiration.
  6. IP restrictions.

Duplicate ServiceNow records

Likely cause:

No reliable correlation key.

Resolution:

Define a unique business identifier before record creation.

Do not rely solely on the ServiceNow short description.


Incorrect assignment

Likely cause:

The Qualys asset could not be correctly mapped to the ServiceNow CI.

Resolution:

Review:

  • Hostname normalization
  • DNS differences
  • Asset identifiers
  • CMDB relationships
  • Ownership data

Missing vulnerabilities

Sometimes users report that “Qualys has the vulnerability but ServiceNow doesn’t.”

Check:

  • Severity filter
  • Asset scope
  • API query
  • Detection status
  • Time window
  • Pagination
  • Integration schedule
  • Transformation rules

Pagination deserves particular attention when processing large vulnerability datasets.


API throttling

Large organizations can generate significant volumes of security data.

If the integration makes excessive API calls, the source or target system may throttle requests.

Use:

  • Incremental processing
  • Pagination
  • Batching
  • Controlled concurrency
  • Retry with backoff
  • Checkpointing

Avoid retrieving the entire vulnerability population every few minutes.


Best Practices for Qualys ServiceNow Integration

1. Start with a narrow scope

Do not integrate every Qualys finding on day one.

Start with:

Production + Critical/High + defined asset groups

Then expand after validating the lifecycle.


2. Design the lifecycle, not just the interface

The real requirement is not:

“Move Qualys data into ServiceNow.”

It is:

“Create a controlled vulnerability remediation lifecycle.”

That means creation, assignment, remediation, verification, closure, and exception handling all need to be designed.


3. Make the integration idempotent

Running the same transaction twice should not create duplicate business records.

This is one of the most important principles in enterprise integration.


4. Preserve source identifiers

Always store a reliable Qualys reference in ServiceNow.

This allows support teams to trace:

ServiceNow record → Qualys finding

during troubleshooting or audit activities.


5. Separate business rules from technical mappings

For example:

Technical mapping:

Qualys severity → ServiceNow priority

Business rule:

Critical vulnerability + internet-facing production asset → immediate remediation workflow

Keep these concepts separate so that business policy can change without redesigning the complete integration.


6. Build exception handling from day one

Common exception categories should include:

  • Unknown asset
  • Missing CI
  • Invalid vulnerability data
  • Authentication failure
  • ServiceNow API failure
  • Qualys API failure
  • Duplicate record
  • Invalid assignment group

A good integration makes failures visible instead of silently dropping records.


7. Monitor business failures, not only technical failures

An HTTP 200 response does not necessarily mean the business transaction succeeded.

For example:

 
API call successful
        ↓
Payload accepted
        ↓
CI not found
        ↓
Record routed to exception queue
 

Technically successful does not always mean functionally successful.


8. Use controlled retries

Not every error should be retried.

ErrorRetry?
Temporary network failureYes
HTTP 5xxUsually
Rate limitingYes, with backoff
Invalid credentialsNo
Invalid payloadNo
Missing CINo
Business validation failureNo

This prevents retry storms.


Where Oracle Integration Cloud Gen 3 Can Fit

In organizations using Oracle applications alongside ServiceNow and Qualys, OIC Gen 3 can act as an enterprise integration layer where there is a genuine requirement to connect these systems.

For example:

 
Qualys
   |
   v
OIC Gen 3
   |
   +----> ServiceNow
   |
   +----> Oracle Fusion
   |
   +----> Other Enterprise Applications
 

A practical scenario might involve a security finding affecting infrastructure supporting an Oracle application.

OIC can orchestrate data between enterprise systems when the process requires Oracle-side data enrichment or downstream processing.

However, adding middleware simply because it is available is not automatically beneficial. If ServiceNow can securely and reliably integrate directly with Qualys for the required workflow, unnecessary middleware increases operational complexity.

The architecture should therefore be driven by:

  • Integration ownership
  • Security requirements
  • Transformation complexity
  • Number of participating systems
  • Monitoring requirements
  • Enterprise integration standards

Frequently Asked Questions

1. What is Qualys ServiceNow integration?

Qualys ServiceNow integration connects vulnerability and security information from Qualys with ServiceNow workflows. It can automate vulnerability ticket creation, asset correlation, assignment, remediation tracking, and closure.

2. Can Qualys vulnerabilities automatically create ServiceNow tickets?

Yes, an appropriately configured integration can create or update ServiceNow records based on defined vulnerability, asset, severity, and business rules. The exact record type depends on the ServiceNow applications implemented by the organization.

3. Why is CMDB important in Qualys ServiceNow integration?

The CMDB provides asset and ownership context. Instead of simply reporting that a vulnerability affects a server, the integration can identify the corresponding CI, application, support group, and ownership information, enabling more accurate remediation routing.


Summary

A successful Qualys ServiceNow integration is more than an API connection between two applications. The important implementation work is designing the complete vulnerability lifecycle: identifying relevant findings, correlating assets, preventing duplicates, assigning remediation ownership, tracking fixes, validating remediation, and handling exceptions.

From a consultant’s perspective, the most important design decisions are the correlation strategy, deduplication key, severity-to-priority rules, CMDB dependency, lifecycle behavior, and error-handling model.

For production implementations, begin with a limited vulnerability scope, test the complete lifecycle, establish monitoring and exception handling, and then gradually expand coverage.

For additional Oracle Cloud documentation, refer to the Oracle Cloud Applications documentation. If your broader architecture includes Oracle Time and Labor, also review the current Oracle Fusion Cloud Human Resources – Time and Labor documentation in the Oracle Cloud Applications documentation library and use the version corresponding to your deployed Fusion release.


Share

Leave a Reply

Your email address will not be published. Required fields are marked *