Skip to main content
The Jira integration lets you push CybeDefend findings (SAST, SCA, IaC, Container, Secret) into your Atlassian Jira Cloud projects as tickets — either manually for selected vulnerabilities or automatically after every scan. Ticket status, priority, and assignee are kept in sync with CybeDefend in near real-time through Jira webhooks.
Only Jira Cloud is supported. Jira Data Center / Server is not currently compatible because the integration relies on Atlassian’s OAuth 2.0 (3LO) flow and Cloud webhook APIs.

​
What you get

  • Ticket creation for one or many vulnerabilities, with three grouping strategies (per vulnerability, per type, per file).
  • Rich descriptions in Atlassian Document Format (ADF), including CVSS, CWE/OWASP tags, file location, fix recommendations, and a direct link back to the CybeDefend view.
  • Severity → priority mapping (Critical → Highest, High → High, …) applied to each issue.
  • Auto-create after scan to file tickets without human intervention (configurable per project).
  • Branch allow-list so tickets are only created for findings on branches you care about (e.g. main, develop).
  • Live status sync via Jira webhooks — status, assignee, priority, and project moves are reflected in CybeDefend automatically.
  • Link to existing issue for vulnerabilities already tracked under another ticket.
  • Duplicate protection — open tickets are reused; closed tickets do not re-open silently.

​
Prerequisites

1

Atlassian account with site access

You need a user that has access to the target Jira Cloud site and can install OAuth apps for it.
2

Required Jira scopes

The OAuth app requests the following scopes:
  • read:jira-work — list projects, read issues
  • write:jira-work — create and update tickets
  • read:jira-user — resolve assignees
  • manage:jira-webhook — register the status-sync webhook
  • offline_access — refresh tokens automatically
3

CybeDefend permission

You must hold the manage_integration permission on the organization (Owner or Admin).

​
1. Connect Jira to your organization

1

Open organization integrations

In CybeDefend, go to Organization Settings → Integrations and select Jira.
2

Start the OAuth flow

Click Connect Jira. You will be redirected to Atlassian to authorize the CybeDefend app. A CSRF state token is stored server-side for 10 minutes — finish the flow within that window.
3

Choose your Jira site

Approve access for the Jira Cloud site you want to use. If multiple sites are accessible to your Atlassian account, the integration uses the first accessible site returned by Atlassian.
4

Wait for installation to complete

On callback, CybeDefend exchanges the authorization code for an access token, encrypts it with AES-256-GCM, and registers a webhook so issue updates flow back automatically.
Tokens are encrypted at rest. Refresh is automatic — you do not need to re-authorize unless the integration is uninstalled from the Atlassian side.

​
2. Map a CybeDefend project to a Jira project

The OAuth connection is at the organization level. Each CybeDefend project then points to a single Jira project that will receive its tickets.
1

Open project settings

From the project view, go to Settings → Integrations → Jira.
2

Pick the Jira project

Select the destination Jira project from the dropdown. CybeDefend fetches up to 100 projects from the connected site, ordered by name.
3

Restrict by branch (optional)

Add up to 50 branches (e.g. main, develop, release/*) to the allow-list. Vulnerabilities detected on any other branch will be silently skipped when creating tickets. Leave the list empty to allow all branches.
4

Enable auto-create (optional)

Toggle Auto-create tickets after scans if you want every new finding (matching the branch allow-list) to be filed automatically once a scan completes.
For triage-heavy projects, leave auto-create off and use the per vulnerability type mode manually — you’ll get one ticket per CWE/CVE rather than one ticket per occurrence, which is far easier to action.

​
3. Create tickets for vulnerabilities

From the vulnerability list (SAST, SCA, IaC, Container, Secret), select one or more findings and choose Create Jira issues. You pick the grouping mode:
ModeBehaviorWhen to use
Per vulnerabilityOne Jira ticket per individual detection (vulnerabilityId + filePath + line, or vulnId + package@version for SCA).Fine-grained tracking, small batches.
Per vulnerability typeOne ticket per rule / CVE, grouping all occurrences.Default — best signal-to-noise ratio.
Per fileOne ticket per (scanner, file path). SCA tickets group by dependency manifest.Code reviews organized by file owner.

​
What’s in the ticket

  • Summary — human-readable name (e.g. lodash: Prototype pollution in lodash.merge) with a [CybeDefend] prefix and a count suffix when grouped.
  • Description (ADF) — severity, CVSS, CWE/OWASP, fix recommendation, code snippet for SAST, package details for SCA, and a deep link back to the matching CybeDefend view (filtered by name).
  • Priority — mapped from severity: Critical → Highest, High → High, Medium → Medium, Low → Low, Info → Lowest.
  • Issue type — Bug if available, otherwise Task, then Story, falling back to the first non-subtask type in the project’s create-meta.
Before creating a ticket, CybeDefend checks for an existing open ticket with the same group key, or vulnerabilities already linked to a non-terminal ticket (open, in progress, …). Duplicates are skipped, not re-filed. Tickets in done, closed, resolved, or deleted states do not block re-creation.
If a ticket already exists for the work, you can attach CybeDefend vulnerabilities to it instead of creating a new one.
1

Pick the vulnerabilities

Select the findings in the CybeDefend vulnerability list and choose Link to existing Jira issue.
2

Enter the issue key

Provide the Jira key (e.g. TRI-142). CybeDefend validates the key exists and reads its current summary and status.
3

Confirm

CybeDefend records the mapping and appends a “Linked CybeDefend vulnerabilities” section to the existing Jira description — your original description is never overwritten.

​
5. Status synchronization

CybeDefend registers a dynamic webhook at install time, listening to jira:issue_updated and jira:issue_deleted for every project on the site. When a ticket changes in Jira, CybeDefend updates the linked vulnerabilities within seconds:
  • Status — reflected as issueState (e.g. in progress, done).
  • Priority — stored on the mapping.
  • Assignee — the Jira display name is mirrored.
  • Project key — if a ticket is moved between Jira projects, the new key is detected via the changelog and all mappings are updated.
  • Deleted issues — marked as deleted in CybeDefend.
Dynamic webhooks expire after 30 days; CybeDefend refreshes them periodically through a background cron, so no manual action is needed.
If a webhook ever misses an event, you can trigger a manual sync from the project’s Jira integration panel — CybeDefend will pull the latest status for each linked ticket and detect any project moves at the same time.

​
6. Disconnecting Jira

Disconnecting from Organization Settings → Integrations → Jira → Disconnect will:
  1. Remove the OAuth integration and stored tokens.
  2. Delete every per-project Jira configuration (mapping, allowed branches, auto-create setting).
  3. Remove every vulnerability ↔ Jira issue mapping for the organization.
  4. Leave the Jira tickets untouched — they remain in Jira and are no longer linked back to CybeDefend.
To use Jira again afterwards, simply re-run the connect flow.

​
Troubleshooting

Your Atlassian account does not have access to any Jira Cloud site, or your administrator has restricted OAuth apps for the site. Ask your Jira admin to grant access or approve the CybeDefend app.
The CybeDefend project has no mapping yet. Open Project Settings → Integrations → Jira and select a destination Jira project.
Check three things: (1) Auto-create is enabled on the CybeDefend project, (2) the scan’s branch is in the allow-list (or the list is empty), (3) the vulnerability isn’t already linked to an open Jira ticket — duplicates are intentionally skipped.
The webhook may have been removed at the Jira side, or the webhook expired. Disconnect and reconnect the integration to re-register it, or use the manual Sync status action on the project’s Jira panel.
The CSRF state token lives for 10 minutes. Restart the install flow from CybeDefend instead of refreshing the Atlassian callback page.
Related: Project Vulnerability List · Updating Vulnerabilities