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)

• 課題

• コメント

For each relevant object, it indexes these attributes:

• 名前

• タイプ

• 説明

• createdDate

• 最終更新日

• 作成者

• Last updated by

• 投稿者

• 担当者

• Project

• 親

• ラベル

• 投票数

• ウォッチャー

• 反応

• ステータス

• Subtype

• 優先度

• 期限

• ソリューション

• 環境

• 添付ファイル

• 関係

• チーム

• URL

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

• Parent key (for subtask/parent relationships)

• Text/body (for comments)

はじめる前に

• To connect Jira Data Center to Rovo, the minimum required version is Jira 11.0 and above, as well as in 10.3.10 LTS and later.

• You can connect up to three instances of Jira Data Center to your cloud site.

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

• Starting with Jira 11.3 in, we’re introducing a new way to link Data Center and cloud via cloud connectors. In this approach, application links remain the method of connection and are now enhanced with OAuth 2.0.

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

概要

If you’re ready to connect Jira Data Center to Rovo, follow these steps. The steps will differ based on the Jira Data Center version you’re using.

For Jira Data Center 11.3 or later, use Cloud connectors:

1. If your Data Center instance is hosted on private networks, create an application tunnel.

2. Connect Data Center to cloud with cloud connector.

3. Set up Rovo connector via cloud connector.

4. Choose which spaces to include.

For Jira Data Center 11.2 or earlier, use application links:

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. 受信アプリケーション リンクを作成します。

3. アトラシアンの管理でコネクタをセットアップします。

Connect to Rovo via cloud connector

These steps are applicable to Jira Data Center 11.3 and later. If you’re using earlier versions, check other connection options via application links.

ステップ 1: アプリケーション トンネルをセットアップする

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

新しいトンネルを作成する

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. 移動 Atlassian Administration. Select your organization if you have more than one.

5. Select Data management > Data sources > Application tunnels.

6. [トンネルを作成] を選択します。

7. ウィザードに従ってオンプレミス インスタンスの詳細を入力して、トンネルに関連付けられたセキュリティ キーを生成します。

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

   1. インスタンスにリダイレクトされるようにするには、[Copy and process (コピーして処理)] を選択します。

   2. インスタンスの管理者にキーを渡すには、[コピー]、[閉じる] の順に選択します。キーは、[管理] > [アプリケーション トンネル] で [セキュリティ キーを追加] を選択することで手動で追加できます。

9. セキュリティ キーを貼り付けて、ウィザードのステップに従います。

これでトンネルが作成されました。ステータスが「接続済み」になるまで待ってください。

既存のトンネルを使用する

既存のトンネルを使用するには、HTTP コネクタを変更します。

1. インストール ディレクトリで conf/server.xml ファイルを編集します。

2. secure="true" という属性が含まれるようにコネクタを更新します。

必要な接続とアップストリーム ポートの詳細

Step 2: Set up сloud connector

In this step, you’ll create an organization-level сloud connector between your cloud organization and your Jira Data Center instance.

Follow the steps described in Configure cloud connectors, and then return to this page.

Step 3: Set up Rovo connector

In this step, you’ll need to switch between your cloud site and Data Center instance, so make sure to have them both open.

Create Rovo connector in cloud

1. Go to Connected sources page in your cloud Admin Hub. There’re two ways to open this page:

a. On the Cloud connectors page in Data Center Jira administration, select Connect cloud apps. You’ll be redirected to the related page in cloud.
b. In your cloud Admin Hub, go to Data Management, then Data sources, and then Connected sources.

2. Next to your organization connection, select Connect app.

3. On the Select an app to connect screen, select Atlassian Rovo.

4. On the Select site screen, select a cloud site that you’d like to connect Rovo to, and then select Next.

5. On the Check connection screen, we’ll run a check to reach your Data Center instance. If you have more than one application tunnel, select the needed one, and then select Next. If you don’t have an application tunnel, create one.

6. On the Send connection request screen, select Agree and continue.

7. Now that you’ve configured the connection on the cloud side, select Go to Data Center to finish the connection. If you don’t have the Data Center system admin permissions, ask the admin to continue the setup on the Data Center side.

Accept connection request in Data Center

1. On the Cloud connectors page in Jira admin screen, select Review request.

2. On the Review connection request screen, select Accept. Rovo is powered by Teamwork Graph, so it will appear with that name on the list.

次のステップ

After you’ve finished connecting Jira Data Center, your team members will see Jira Data Center and Jira Service Management Data Center (if applicable) show up as a filters options 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.

Connection statuses

There are different statuses on the Connected sources page that show how your Data Center instance is connected to Rovo. Here’s a brief overview of connection statuses as they appear in cloud and Data Center:

Connect to Rovo via application links

These steps are applicable to Jira Data Center 11.2 and earlier. If you’re using newer versions, consider using the connection option via Cloud connectors.

ステップ 1: アプリケーション トンネルをセットアップする

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

新しいトンネルを作成する

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. 移動 Atlassian Administration. Select your organization if you have more than one.

5. Select Data management > Data sources > Application tunnels.

6. [トンネルを作成] を選択します。

7. ウィザードに従ってオンプレミス インスタンスの詳細を入力して、トンネルに関連付けられたセキュリティ キーを生成します。

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

   1. インスタンスにリダイレクトされるようにするには、[Copy and process (コピーして処理)] を選択します。

   2. インスタンスの管理者にキーを渡すには、[コピー]、[閉じる] の順に選択します。キーは、[管理] > [アプリケーション トンネル] で [セキュリティ キーを追加] を選択することで手動で追加できます。

9. セキュリティ キーを貼り付けて、ウィザードのステップに従います。

これでトンネルが作成されました。ステータスが「接続済み」になるまで待ってください。

既存のトンネルを使用する

既存のトンネルを使用するには、HTTP コネクタを変更します。

1. インストール ディレクトリで conf/server.xml ファイルを編集します。

2. secure="true" という属性が含まれるようにコネクタを更新します。

必要な接続とアップストリーム ポートの詳細

ステップ 2: 受信アプリケーション リンクを作成する

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. [リンクを作成] を選択します。

3. [外部アプリケーション] > [受信] を選択します。

4. [続行] を選択します。

5. アプリケーション リンクの名前を入力します。

6. https://id.atlassian.com/outboundAuth/finish をリダイレクト URL として挿入します。

7. アプリの権限については、[サブスクリプションを管理] を選択します。

8. [保存] を選択します。

9. アプリケーション リンク テーブルの [アクション] で、その他のアクション (•••) > [認証情報を表示] の順に選択します。

10. [クライアント ID] と [クライアント シークレット] をメモします。この情報は、アトラシアンの管理でコネクタをセットアップする際に必要になります。

ステップ 3: アトラシアンの管理でコネクタをセットアップする

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

1. 移動 Atlassian Administration. Select your organization if you have more than one.

2. Select Apps > AI 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. Data Center のネットワーク タイプを選択します。

   1. ネットワークがファイアウォールの内側にあり、パブリック インターネットからアクセスできない場合は、プライベート ネットワークを選択します。事前にセットアップしたアプリケーション トンネルを選択します。

   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. OAuth のクライアント ID とクライアント シークレットを入力します。

4. 免責事項を確認します。

5. Select Authorize Jira Data Center.

次のステップ

After you’ve finished connecting Jira Data Center, your team members will see Jira Data Center and Jira Service Management Data Center (if applicable) show up as a filters options 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.

Manage Rovo connector

These steps are applicable to Jira Data Center 11.3 and later.

認証情報を取り消す

You can revoke credentials and disable the connector if there’s a chance that the credentials were exposed and are no longer safe.

To revoke Rovo credentials:

1. Go to your Data Center instance, go to Administration, find Application links, and then go to Cloud connectors.

2. Select More actions (), and then Revoke credentials.

3. Confirm your action by selecting Revoke credentials. The connector status will change to Disabled.

Rotate credentials

You can rotate Rovo credentials when they expire or after they’ve been revoked.

To rotate Rovo credentials:

1. In your cloud Admin Hub, go to Data Management, then Data sources, and then Connected sources.

2. Find your organization connector and expand it.

3. Next to Rovo connection, select More actions (), and then Rotate credentials.

4. Confirm your action by selecting Rotate credentials. Wait up to 30 minutes while the credential rotation takes place. The connector will change status to Connected.

Delete connector

You can delete and re-establish Rovo connector as many times as you need. The connector should be in Connected status to be deleted.

To delete Rovo connector from Data Center:

1. Go to your Data Center instance, go to Administration, find Application links, and then go to Cloud connectors.

2. Select More actions (), and then Delete connector.

3. Confirm your action by selecting Delete.

To delete Rovo connector from cloud:

1. In your cloud Admin Hub, go to Data Management, then Data sources, and then Connected sources.

2. Find your organization connector and expand in.

3. Next to Rovo connector, select More actions (), and then Delete connector.

4. Confirm your action by selecting Delete.

The connector will disappear from both cloud and Data Center admin panels.