Atlassian Jira Connector

The Atlassian Jira Connector enables integration between Qualys TotalCloud (TC) and Jira on Cloud, allowing automated ticket creation and updates for misconfigurations identified in TC. This integration supports real-time ticketing workflows and status synchronization to enhance incident response and governance.

Integration Type	Supported Qualys Module	Supported Jira Platform
API Connector	TotalCloud	Jira on Cloud

Prerequisites

To configure the Atlassian Jira Connector successfully, ensure the following prerequisites are met:

An active Qualys subscription with the TotalCloud module enabled
A Jira Cloud account with permission to:
- Create, Update, and Transition issues
A valid API token generated via Atlassian (see: Generate API Token)
The Jira project must be of type Company Managed

In your Jira instance, create a mandatory custom field as per module type:

Qualys Module	Custom Field Type	Required Field Name
TotalCloud	Short Text (plain text)	Connector Id

Create a New Jira Connector

Let's create your first Jira Connector

Go to Connectors
Search for Atlassian Jira
Click on the 3-dot menu > Manage > Create Connection

Basic Details

Provide a Name and Description
Set:
- Qualys Data Model: Misconfiguration
- Qualys Data Model Type: TC

Authentication Details

Field Name	Key	Type	Example
Jira Instance URL	domain	String	https://xxxxxx.atlassian.net
Jira Username	username	String	jirauseremail@company.com
API Token	password	String	Follow the steps at Jira API Token.

Click Test Connection to validate. If successful, proceed to create the Data Model.

Create the Data Model

Click Create a Data Model
Enter a name for the data model
From the dropdowns:
- Jira Project – Select the target Jira project
- Issue Type – Select the type (e.g., Bug, Task)
Jira attributes are auto-populated.
Map Workflow Statuses – Align CC statuses with Jira statuses (e.g., Open, In Progress, Resolved)

Click Create to finalize the data model.

Create a Transform Map

Click Create a Transform Map
Provide a name for the map
Use the dropdowns to map:
- TC Field > Field from TotalCloud schema
- Source Data Type → Data type of the TC field
- Atlassian Jira Field → Target field in Jira

Example:

CC Field: assetName
Source Data Type: String
Atlassian Jira Field: Summary

Click Create to save the mapping.

Save the Connection

Review all configurations and click Create to deploy the connector.

How Does a Connection Work?

The connector functions by linking Qualys TotalCloud misconfiguration alerts to Jira issues. Once a connection is established, TotalCloud uses alert rules to trigger ticket creation or updates in Jira.

Connector Creation – Establish the Jira connection with domain, user credentials, and API token.
Data Model Mapping – Define how Jira projects and issue types align with TotalCloud schemas.
Transform Mapping – Map fields from TC misconfiguration data to Jira issue fields.
Trigger Configuration – Create alert actions and rules within TotalCloud to control ticket generation.

Activating Ticketing via TotalCloud Actions

After creating the connector, you must configure Alert Actions and Rules within TotalCloud to define the triggers for creating or updating Jira tickets.

Refer to the TotalCloud Documentation for detailed steps on configuring alert rules and ticket automation workflows.