Search

Chapter 5. Creating and configuring a Jira connection

download PDF

You can track application migrations by creating a Jira issue for each migration from within the MTA user interface. To be able to create Jira issues, you first need to do the following:

  1. Create an MTA credential to authenticate to the API of the Jira instance that you create in the next step.
  2. Create a Jira instance in MTA and establish a connection to that instance.

5.1. Configuring Jira credentials

To define a Jira instance in MTA and establish a connection to that instance, you must first create an MTA credential to authenticate to the Jira instance’s API.

Two types of credentials are available:

  • Basic auth - for Jira Cloud and a private Jira server or data center
  • Bearer Token - for a private Jira server or data center

To create an MTA credential, follow the procedure below.

Procedure

  1. In Administration view, click Credentials.

    The Credentials page opens.

  2. Click Create new.
  3. Enter the following information:

    • Name
    • Description (optional)
  4. In the Type list, select Basic Auth (Jira) or Bearer Token (Jira):

    • If you selected Basic Auth (Jira), proceed as follows:

      1. In the Email field, enter your email.
      2. In the Token field, depending on the specific Jira configuration, enter either your token generated on the Jira site or your Jira login password.

        Note

        To obtain a Jira token, you need to log in to the Jira site.

      3. Click Save.

        The new credential appears on the Credentials page.

    • If you selected Bearer Token (Jira), proceed as follows:

      1. In the Token field, enter your token generated on the Jira site.
      2. Click Save.

        The new credential appears on the Credentials page.

You can edit a credential by clicking Edit.

To delete a credential, click Delete.

Note

You cannot delete a credential that has already been assigned to a Jira connection instance.

5.2. Creating and configuring a Jira connection

To create a Jira instance in MTA and establish a connection to that instance, follow the procedure below.

Procedure

  1. In Administration view, under Issue Management, click Jira.

    The Jira configuration page opens.

  2. Click Create new.

    The New instance window opens.

  3. Enter the following information:

    • Name of the instance
    • URL of the web interface of your Jira account
    • Instance type - select either Jira Cloud or Jira Server/Data center from the list
    • Credentials - select from the list

      Note

      If the selected instance type is Jira Cloud, only Basic Auth credentials are displayed in the list.

      If the selected instance type is Jira Server/Data center, both Basic Auth and Token Bearer credentials are displayed. Choose the type that is appropriate for the particular configuration of your Jira server or data center.

  4. By default, a connection cannot be established with a server with an invalid certificate. To override this restriction, toggle the Enable insecure communication switch.
  5. Click Create.

    The new connection instance appears on the Jira configuration page.

    Once the connection has been established and authorized, the status in the Connection column becomes Connected.

    If the Connection status becomes Not connected, click the status to see the reason for the error.

The Jira configuration table has filtering by Name and URL and sorting by Instance name and URL.

Note

A Jira connection that was used for creating issues for a migration wave cannot be removed as long as the issues exist in Jira, even after the migration wave is deleted.

Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.