Book a demo

Jira

Jira is a powerful project management and issue-tracking tool widely used by development teams to plan, track, and manage software projects.

It provides robust workflows, automation, and integrations that streamline collaboration between teams.

Integrating OX Security with Jira enhances security visibility within your existing development workflows.

This integration allows security issues and vulnerabilities detected by OX to be automatically logged as Jira issues, ensuring they are tracked, prioritized, and resolved alongside other development tasks.

By seamlessly embedding security insights into Jira, teams can maintain a proactive approach to risk management while minimizing workflow disruptions.

Jira Cloud and Jira On-Prem

OX supports integrating with both JIRA Cloud and JIRA On-Prem for ticketing automation.

When integrating OX with JIRA On-Prem, you can automatically create and update tickets based on issues detected in your environment. Unlike JIRA Cloud, JIRA On-Prem requires additional configuration steps, particularly around the URL format and authentication method.

When connecting OX to a JIRA On-Prem instance, you need to decide what authentication method to use for the connection. You define the method by defining the URL format, as follows:

  • Token-based authentication (this method is recommended, as it is more secure)

https://<domain>/release/v${version}/api/2/bearer

  • Basic username-password authentication

https://<domain>/release/v${version}/api/2

The integration process includes the following:

  1. Prerequisites

  2. Get Jira tokens: for Jira on Cloud, for Jira On-Prem

Prerequisites

A Jira account.

Getting Jira Cloud token

  1. Log in to your Atlassian account.

  2. From your profile picture in the top-right corner, select Profile.

  1. In your profile settings page, select Manage your account and then select Security.

  1. Scroll down to the API Tokens section, select Create and manage API tokens, and then select Create API token.

  1. In the Create API token dialog, define the following.

Parameter
Description

Name

A significant name that makes it easy to identify the purpose of the token.

Expires on

Set the expiration date as far as possible.

  1. Select Create. The dialog with the token appears.

  1. Copy the token and store it in a safe location. After closing this dialog you cannot see it again.

Getting Jira On-Prem token

  1. Log in to your Atlassian account.

  2. Click your profile avatar and select Profile.

  3. Navigate to Personal Access Tokens.

  1. Click Create token.

  1. Provide a name and expiration period, then click Create.

  2. Copy the token and store it in a safe location. After closing this dialog, you cannot see it again.

    Note: This process may differ slightly based on your JIRA On-Prem version.

Connecting to Jira on the Cloud

  1. In the OX app, go to Connectors and search for Jira.

  1. Select Jira and set the following parameters in the Configure your Jira credentials dialog.

Parameter
Description

Jira Host URL

Add your organization account URL.

User Name

Type the email address used as your Jira user name.

Token Name

Paste the Jira token you have created.

  1. Select CONNECT. The success message appears.

Connecting to Jira On-Prem

  1. In the OX app, go to Connectors and search for Jira.

  1. Select Jira and set the following parameters in the Configure your Jira credentials dialog.

Parameter
Description

Jira Host URL

Add the URL format that defines the authentication method for the Jira on-prem connection, where:

  • <domain> : The base domain of the JIRA server

  • <version> : The JIRA version

User Name

Type your JIRA username.

Token Name

Based on the authentication method you are using, paste the Jira token you have created, or add your actual JIRA password.

  1. Select CONNECT. The success message appears.

Adding Jira tickets

After establishing the connection with Jira, you can add Jira tickets for a variety of tasks and issues in OX using one of the following methods:

  • Adding a new ticket to an issue, or bulk of issues.

  • Adding a new ticket as a scheduled task using workflows.

To add a new Jira ticket in OX:

  1. In the Issues page, identify and select the issue for which you want to add a new ticket in Jira.

  2. Select the Jira icon.

  1. Set the ticket mandatory parameters in the Create Jira Issue dialog.

Parameter
Description

Summary

The title of the ticket that describes the problem/issue, as it appears in the OX Issues page.

Project

The name of the project, as it's defined in Jira.

Issue Type

Select the issue type.

  1. (Optional)Set the other Jira ticket parameters.

  2. Select SUBMIT.

The new ticket appears in Jira.

Last updated