Chapter 5. Creating and configuring a Jira connection
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:
- Create an MTA credential to authenticate to the API of the Jira instance that you create in the next step.
- 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
In Administration view, click Credentials.
The Credentials page opens.
- Click Create new.
Enter the following information:
- Name
- Description (optional)
In the Type list, select Basic Auth (Jira) or Bearer Token (Jira):
If you selected Basic Auth (Jira), proceed as follows:
- In the Email field, enter your email.
In the Token field, depending on the specific Jira configuration, enter either your token generated on the Jira site or your Jira login password.
NoteTo obtain a Jira token, you need to log in to the Jira site.
Click Save.
The new credential appears on the Credentials page.
If you selected Bearer Token (Jira), proceed as follows:
- In the Token field, enter your token generated on the Jira site.
Click Save.
The new credential appears on the Credentials page.
You can edit a credential by clicking Edit.
To delete a credential, click Delete.
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
In Administration view, under Issue Management, click Jira.
The Jira configuration page opens.
Click Create new.
The New instance window opens.
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
NoteIf 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.
- By default, a connection cannot be established with a server with an invalid certificate. To override this restriction, toggle the Enable insecure communication switch.
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.
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.
