Connecting to 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. Get Jira tokens: for Jira on Cloud, for Jira On-Prem

Prerequisites

A Jira account.

Step 1: Getting Jira On-Prem token [Jira]

  1. Log in to your Jira Data Center / Server instance using your assigned user 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.

Step 2: Connecting to Jira On-Prem [OX]

  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.

Last updated