Integrating with Jira - Connecting with iCR

With a Jira project created and an OAuth app ready for use with iCR, the next step is to authorize iCR with Jira. In the previous section we showed how to create the OAuth app to provide the necessary credentials for iCR to communicate with Jira. When that is complete, you can log into iCR as described in Connecting to the Navigator.

Once connected to the Navigator, we use the Settings menu to set the Jira OAuth credentials. Follow these steps:

• Click on the Settings menu and scroll to the entry labeled Change Jira credentials

• That brings up a pop-up menu where you enter the Client ID and Secret that were copied when you set up the OAuth App

• Click on Submit to set the values

You have now configured the OAuth credentials which permit iCR to intereact with Jira. The video below will display the steps needed to copy the Jira OAuth credentials into iCR.

With the credentials set, we can now associate a specific project repository for use with our Jira project. As introduced in Using a cloud-based VCS, we will again use the django repository as our example here.

Let's connect our django project with our Jira bug tracking projct. These are the steps required to accomplish that:

• The first step is to Clone the project.

• Scroll through the branches to choose the branch to be tracked. We will select the main branch. Notice that a button labeled Integration appears to the left of the Remove button. We will use this to connect this repository to Jira

• Click on the Integration button to select the bug tracking system to integrate with. In this relesae, only Jira Cloud is supported

• Once selected, a new OAuth connection will be requested. Click Yes to continue to make the connection to the Jira software

• Since this is the very first time the OAuth app may be used, a window pops us requesting that the app be authorized to access your Atlassian account. Scroll to the bottom to select the proper Atlassian account. Click Accept to authorize the connection

• Note that you will ONLY see this request the very first time that you engage with your OAuth app

• Once authorized, you will need to reselect the project. Notice that the button to the left of the Remove button is now showing JIRA_Integrated as we are now authorized to use Jira to track bugs. The next step is to select the Jira project which will track the bugs found by iCR

• Click on JIRA_Integrated to view the drop-down menu. From this menu we can set the specific Jira project key that will be used to track bugs for this project or we can choose to disconnect from Jira. Clicking on Set Project Key prompts us for the project key we defined in Integrating with Jira - Define Your Project. In our example, the key is IBT. Enter that now and click Submit

By clicking on Submit we have completed the final step to bind this repository branch to a Jira software project. We can now use Jira softwre to track bugs found by iCR. That will be shown in Reviewing a fix.

You can view all of these steps in the following video: