Setting Up Credentials for Jira Integration
This feature is only available to Collaborators and Account Administrators.
Standard Authentication Methods
Username & Password Authentication (for users on Jira On-Premise Servers)
Users working in an on-premise server are able to use their username and password for Jira credentials, so long as the users are not being managed by a third-party tool. If you’re looking to setup an integration with Strategic Roadmaps while using an SSO provider to log into Jira, you would either need to request that your Jira admin provide you with a local username & password or check out the OAuth Authentication for Strategic Roadmaps section of this article.
API Token Authentication (for users on Jira Cloud Servers)
In June 2019, Atlassian began the deprecation of all standard authentication methods when working through integrated applications. This means that in order to connect to Strategic Roadmaps from a Jira Cloud server, you would need to generate an API token in Atlassian.
The following guide from Atlassian can walk you through this process: API Tokens
Once generated, you can enter your Email and API Token into the credentials page of your Jira Integration setup menu to validate your credentials and begin synchronizing your data with Strategic Roadmaps.
Alternative Authentication Methods
This feature is available on the following plans:
Professional
Enterprise
OAuth Authentication (for users on Jira On-Premise & Cloud Servers)
To set up OAuth as an authentication method for your Jira Integration, you need to be on a Professional package with administrative privileges on both your account and your Jira Server. Depending on your version of Jira, the locations of certain pages may vary—feel free to reach out to Tempo Support if you are unable to locate the appropriate pages in your Jira server.
To setup OAuth Authentication for Jira in Strategic Roadmaps, follow these steps:
Enable OAuth Support in Strategic Roadmaps
On the application, click on your Avatar in the bottom-left corner to access the Account Settings window. From there, click into the Integrations tab and select either an existing integration or create a new one. On the setup page, you will notice that there is a button for OAuth Support. To begin the setup process, make sure that this is toggled to “Enabled” - if done correctly, a Consumer Key and Public Key will appear in the modal window.
NOTE: Enabling OAuth Support does not mean that the setup has been completed.
Setup the Application Link in Jira Server
Once enabled on your account, you or your Jira administrator will have to setup the application link to Strategic Roadmaps in Atlassian. When logged in as a Jira admin, you can navigate to Products (also called Applications) from inside your Settings (⚙️) menu. On the navigation menu, select Application Links and begin the setup process by entering the URL https://roadmunk.com into the field shown below then select Create new link. A dialogue box will appear once Create new link is clicked - click continue in that box to begin the setup.
On the modal that appears:
Set the Application Name to “Strategic Roadmaps” (or a name of your choice)
Ensure that Application Type is set to “Generic Application”
Fill in all other fields with the Consumer Key provided
Before continuing in the setup process, ensure that the Create Incoming Link option is checked
On the second page:
Enter the Consumer Key and the Public Key from Strategic Roadmaps into their respective boxes.
Set the Consumer Name as “Strategic Roadmaps”
Once this has been completed, Strategic Roadmaps should appear under your list of Application Links. To finalize the setup, select the Edit (pencil) icon for Strategic Roadmaps on the right side of the line item in your linked applications and select Outgoing Authentication. Scroll down and click the Delete button, then select Delete once more in the popup that appears. The dialogue window can be closed at this point.
Setup Credentials in Strategic Roadmaps
Once this step has been completed, return to Strategic Roadmaps and navigate to the roadmap you’re looking to integrate with Jira. Click on the Integrations button in your roadmap and select either Jira Integration (for new integrations) or Modify Setup (for existing integrations). From this menu - navigate to the Credentials tab and select the Add Credentials option on the page.
If the setup has been completed successfully in your Jira server, a small window (see above) will appear prompting you to authorize the connection. Please ensure that popup blockers are disabled or whitelisted Strategic Roadmaps, as this can prevent this window from appearing properly. Choose the Allow option and the integration should be finalized, showing the time of setup on the credential card in the setup window. Once this has been completed, you can finalize your settings on your Jira Integration modal and start working on your Jira Integrated roadmap.