Connect Jira Data Center to Rovo

Centralize your team’s knowledge across Data Center and Cloud sites by integrating your Jira Data Center projects and issues into Rovo.

What is indexed?

The Jira DC connector indexes these objects:

• Projects (business, software, and service types)

• Issues

• Comments

For each relevant object, it indexes these attributes:

• Name

• Type

• Description

• Created date

• Last updated date

• Creator

• Last updated by

• Contributor

• Assignee

• Project

• Parent

• Labels

• Votes

• Watchers

• Reactions

• Status

• Subtype

• Priority

• Due date

• Resolution

• Environment

• Attachments

• Relationships

• Team

• URL

• Container key (for relationships, e.g., epic/project)

• Parent key (for subtask/parent relationships)

• Text/body (for comments)

Before you begin

• Rovo will always respect permissions. Users will only ever see content that they already have access to. More on connectors and permissions

• To connect Jira Data Center to Rovo, the minimum required version is Jira 11.0.

• If you’ve enabled rate limiting, you may need to adjust your request limits to ensure content is seamlessly indexed in Rovo.

Overview

To connect Jira Data Center to Rovo, complete the following steps:

1. Create an application tunnel or configure an allowlist - This step only applies to Jira instances hosted on private networks. If your Jira instance is available over the public internet, skip this step.

2. Create an incoming application link.

3. Set up the connector in Atlassian Admin.

Step 1: Set up an application tunnel

If your Jira Data Center instance is on a private network, you need to set up an application tunnel from your Cloud organization to your Jira Data Center instance. You can also use an existing tunnel by adjusting its configuration. More on tunnels

Alternatively, if you prefer not to use tunnels, you can allowlist incoming connections or IPs for Atlassian Cloud products and sites in your Data Center instance. More on IP addresses and domains for Atlassian Cloud products

Create a new tunnel

1. Open Application tunnels in Atlassian Marketplace.

2. Install the Marketplace app in your Data Center instance.

3. Configure the required connections and upstream ports.

4. Go to admin.atlassian.com. Select your organization if you have more than one.

5. Go to Settings > Application tunnels.

6. Select Create tunnel.

7. Go through the wizard to provide the details of your self-managed instance and generate the security key associated with your tunnel.

8. Add the key to your Jira Data Center instance.

   1. To be redirected to your instance, select Copy and process.

   2. To give the key to the admin of the instance, select Copy, then Close. The key can be added manually in Administration > Application tunnel, by selecting Add security key.

9. Paste your security key and follow the steps in the wizard.

Your tunnel is created. Wait until the status is Connected.

Use an existing tunnel

To use an existing tunnel, modify the HTTP connector:

1. In your installation directory, edit the conf/server.xml file.

2. Update the connector to include the attribute: secure="true".

More on required connections and upstream ports

Step 2: Create an incoming application link

Create an application link in the administration of your Jira Data Center instance to use in the connection process. About creating application links

1. In Jira Data Center, go to Administration > Application Links.

2. Select Create link.

3. Choose External application > Incoming.

4. Select Continue.

5. Enter a name for your application link

6. Insert https://id.atlassian.com/outboundAuth/finish as the redirect URL.

7. For application permissions, select Manage Subscriptions.

8. Select Save.

9. In the application links table, under Actions, select More actions (•••) > View credentials.

10. Make note of the Client ID and Client secret - you’ll need them when setting up the connector in Atlassian Admin.

Step 3: Set up the connector in Atlassian Admin

Access the setup screen for the Jira Data Center connector in Atlassian Admin:

1. Go to admin.atlassian.com. Select your organization if you have more than one.

2. Select Settings > Rovo.

3. Under Sites, next to the site you want to connect, select Add connector.

4. Select Jira Data Center and press Next.

Configure Jira Data Center:

1. Enter a name for your Jira Data Center connection.

2. Select your Data Center network type:

   1. Private network if your network is behind a firewall and can’t be accessed over the public internet. Select the application tunnel you previously set up.

   2. Public network if your Jira Data Center instance can be accessed over the public internet or you’ve allowlisted incoming connections or IPs instead of using tunnels. Insert the server base URL (including context path if applicable) of your Jira Data Center instance.

3. Enter the OAuth Client ID and Client secret.

4. Review the disclaimer.

5. Select Authorize Jira Data Center.

Next steps

After you’ve finished connecting Jira Data Center, your team members will see Jira Data Center show up as a filter option in Search. They will be asked to connect before they can see results. This is required so Rovo can make sure your teammates only see results they have access to.