Jira Data Center を Rovo に接続する
Jira Data Center のプロジェクトと課題を Rovo に統合することで、Data Center および Cloud サイト全体でチームのナレッジを一元化します。
何がインデックス化されますか?
Jira DC コネクタは、次のオブジェクトをインデックス化します。
プロジェクト (ビジネス、ソフトウェア、サービスの各タイプ)
課題
コメント
関連する各オブジェクトについて、次の属性がインデックス化されます。
名前
タイプ
説明
createdDate
最終更新日
作成者
最終更新者:
投稿者
担当者
Project
親
ラベル
投票数
ウォッチャー
反応
ステータス
サブタイプ
優先度
期限
ソリューション
環境
添付ファイル
関係
チーム
URL
コンテナー キー (エピック/プロジェクトなどの関係用)
親キー (サブタスク/親の関係用)
テキスト/本文 (コメント用)
はじめる前に
Jira Data Center を Rovo に接続するために最低限必要なバージョンは、Jira 11.0 以降および 10.3.10 LTS 以降です。
クラウド サイトには最大 3 つの Jira Data Center インスタンスを接続できます。
Rovo では常に権限が遵守されます。ユーザーには、すでにアクセス権があるコンテンツのみが表示されます。コネクタと権限の詳細については、こちらをご確認ください。
Jira 11.3 以降では、クラウド コネクタを介して Data Center とクラウドをリンクする新しい方法を導入しています。このアプローチでは、引き続きアプリケーション リンクを接続方法として利用できますが、今後は OAuth 2.0 によって強化されます。
レート制限を有効にしている場合は、コンテンツが Rovo でシームレスにインデックス化されるように、リクエスト制限を調整する必要があることがあります。
概要
Jira Data Center を Rovo に接続する準備ができている場合は、次のステップを実行します。これらのステップは、ご利用の Jira Data Center バージョンによって異なります。
Jira Data Center 11.3 以降の場合は、次のようにクラウド コネクタを使用します。
Data Center インスタンスがプライベート ネットワークでホストされている場合は、アプリ トンネルを作成します。
クラウド コネクタを使用して Rovo コネクタをセットアップします。
含めるスペースを選択します。
既存の Rovo コネクタをクラウド コネクタに切り替えることは、インデックス再作成がトリガーされ、問題が発生する可能性があるため、現時点では推奨していません。
Jira Data Center 11.2 以前の場合は、次のようにアプリ リンクを使用します。
アプリ トンネルを作成するか、許可リストを設定します。このステップは、プライベート ネットワークでホストされている Jira インスタンスにのみ適用されます。Jira インスタンスがパブリック インターネットにある場合は、このステップをスキップしてください。
受信アプリケーション リンクを作成します。
アトラシアンの管理でコネクタをセットアップします。
Jira Data Center インスタンスを 1 つのクラウド テナントに接続する際の制限を撤廃しました。Rovo コネクタを使用して、必要な数のインスタンスに接続できるようになりました。
検索には一定の制限が適用されます。詳細については、「検索」をご確認ください
クラウド コネクタで Rovo に接続する
これらのステップは、Jira Data Center 11.3 以降に適用されます。それ以前のバージョンをご利用の場合は、アプリ リンクによる他の接続オプションをご確認ください。
ステップ 1: アプリケーション トンネルをセットアップする
Jira Data Center インスタンスにパブリック インターネットからアクセスできる場合は、このステップをスキップしてステップ 2 に進んでください。
Jira Data Center インスタンスが非公開ネットワークにある場合は、Cloud 組織から Jira Data Center インスタンスへのアプリ トンネルをセットアップする必要があります。設定を調整することで、既存のトンネルも使用できます。トンネルの詳細
新しいトンネルを作成する
Atlassian Marketplace でアプリケーション トンネル アプリを開きます。
Data Center インスタンスに Marketplace アプリをインストールします。
必要な接続とアップストリーム ポートを設定します。
移動 Atlassian Administration. Select your organization if you have more than one.
[データ管理] > [データ ソース] > [アプリケーション トンネル] の順に選択します。
[トンネルを作成] を選択します。
ウィザードに従ってオンプレミス インスタンスの詳細を入力して、トンネルに関連付けられたセキュリティ キーを生成します。
Jira Data Center インスタンスにキーを追加します。
インスタンスにリダイレクトされるようにするには、[Copy and process (コピーして処理)] を選択します。
インスタンスの管理者にキーを渡すには、[コピー]、[閉じる] の順に選択します。キーは、[管理] > [アプリケーション トンネル] で [セキュリティ キーを追加] を選択することで手動で追加できます。
セキュリティ キーを貼り付けて、ウィザードのステップに従います。
これでトンネルが作成されました。ステータスが「接続済み」になるまで待ってください。
既存のトンネルを使用する
既存のトンネルを使用するには、HTTP コネクタを変更します。
インストール ディレクトリで
conf/server.xmlファイルを編集します。secure="true"という属性が含まれるようにコネクタを更新します。
ステップ 2: クラウド コネクタをセットアップする
このステップでは、クラウド組織と Jira Data Center インスタンスの間に組織レベルのクラウド コネクタを作成します。
「クラウド コネクタを設定する」で説明されているステップを実行したあと、このページに戻ります。
ステップ 3: Rovo コネクタをセットアップする
この手順では、クラウド サイトと Data Center インスタンスを切り替える必要があるため、必ず両方を開いておいてください。
クラウドで Rovo コネクタを作成する
1. クラウド管理者ハブの「Connected sources (接続済みのソース)」ページに移動します。このページを開く方法は、次のように 2 つあります。
a. Data Center の [Jira 管理] の [Cloud connectors (クラウド コネクタ)] ページで、[Connect cloud apps (クラウド アプリの接続)] を選択します。クラウドの関連ページにリダイレクトされます。
b. クラウドの管理ハブで、[データ管理] > [データソース] > [接続済みソース] の順に移動します。
2. 組織接続の横にある [Connect app (アプリを接続)] を選択します。
3. [Select an app to connect (接続するアプリを選択)] 画面で、[Atlassian Rovo] を選択します。
4. [サイトを選択] 画面で、Rovo に接続するクラウド サイトを選択し、[次へ] を選択します。
5. [Check connection (接続を確認)] 画面で、Data Center インスタンスに到達するためのチェックを実行します。複数のアプリケーション トンネルがある場合は、必要なものを選択してから、[次へ] を選択します。アプリケーション トンネルがない場合は、作成してください。
6. [Send connection request (接続リクエストを送信)] 画面で、[同意して続行] を選択します。
7. クラウド側で接続を設定したので、[Go to Data Center (Data Center に移動)] を選択して接続を完了します。Data Center システムの管理者権限がない場合は、管理者に Data Center 側のセットアップを続行するよう依頼してください。
Accept connection request in Data Center
1. Jira 管理画面の [Cloud connectors (クラウド コネクタ)] ページで、[Review request (リクエストのレビュー)] を選択します。
2. [接続リクエストの確認] 画面で [承認] を選択します。Rovo は Teamwork Graph を基盤としているため、リストにはその名前で表示されます。
次のステップ
Jira Data Center の接続が完了すると、チーム メンバーには、検索のフィルター オプションとして Jira Data Center と Jira Service Management Data Center (該当する場合) が表示されます。結果が表示される前に接続を求められます。これは、Rovo においてチーム メイトに表示する結果をそれぞれのアクセス権に基づいて制限するのに必要です。
Jira Data Center インスタンス内のコンテンツの量によっては、すべてがインデックス化されて Rovo に表示されるまでに時間を要する場合があります。
接続ステータス
「Connected sources (接続済みのソース)」ページには、Data Center インスタンスが Rovo にどのように接続されているかを示すさまざまなステータスがあります。クラウドと Data Center での接続ステータスの概要は次のとおりです。
クラウドのステータス | Data Center のステータス | 説明 |
|---|---|---|
接続済み | 接続済み | 接続は正常に確立されています。 |
取り消し済み | 無効 | コネクタの認証情報は取り消されており、クラウド管理者が認証情報をローテーションするまで接続は無効になります。 |
中断 | 中断 | 接続はアクティブでしたが、予期せず動作を停止しました。 |
Rovo にアプリケーション リンク経由で接続する
これらのステップは、Jira Data Center 11.2 以前に適用されます。新しいバージョンをご利用の場合は、Cloud コネクタ経由の接続オプションの使用をご検討ください。
ステップ 1: アプリケーション トンネルをセットアップする
Jira Data Center インスタンスにパブリック インターネットからアクセスできる場合は、このステップをスキップしてステップ 2 に進んでください。
Jira Data Center インスタンスが非公開ネットワークにある場合は、Cloud 組織から Jira Data Center インスタンスへのアプリ トンネルをセットアップする必要があります。設定を調整することで、既存のトンネルも使用できます。トンネルの詳細
また、トンネルの使用が望ましくない場合は、Data Center インスタンス内の Atlassian Cloud 製品やサイトの受信接続や IP を許可リストに登録することもできます。Atlassian Cloud 製品の IP アドレスとドメインの詳細については、こちらをご確認ください。
新しいトンネルを作成する
Atlassian Marketplace でアプリケーション トンネル アプリを開きます。
Data Center インスタンスに Marketplace アプリをインストールします。
必要な接続とアップストリーム ポートを設定します。
移動 Atlassian Administration. Select your organization if you have more than one.
[データ管理] > [データ ソース] > [アプリケーション トンネル] の順に選択します。
[トンネルを作成] を選択します。
ウィザードに従ってオンプレミス インスタンスの詳細を入力して、トンネルに関連付けられたセキュリティ キーを生成します。
Jira Data Center インスタンスにキーを追加します。
インスタンスにリダイレクトされるようにするには、[Copy and process (コピーして処理)] を選択します。
インスタンスの管理者にキーを渡すには、[コピー]、[閉じる] の順に選択します。キーは、[管理] > [アプリケーション トンネル] で [セキュリティ キーを追加] を選択することで手動で追加できます。
セキュリティ キーを貼り付けて、ウィザードのステップに従います。
これでトンネルが作成されました。ステータスが「接続済み」になるまで待ってください。
既存のトンネルを使用する
既存のトンネルを使用するには、HTTP コネクタを変更します。
インストール ディレクトリで
conf/server.xmlファイルを編集します。secure="true"という属性が含まれるようにコネクタを更新します。
ステップ 2: 受信アプリケーション リンクを作成する
接続プロセスで使用する Jira Data Center インスタンスの管理画面でアプリ リンクを作成します。アプリ リンクの作成方法をご確認ください
Jira 11.0 EAP4 以前では、アプリ リンク作成を開始する前に次の手順を実行してください。
ダーク機能ページに移動: <base_url>/secure/SiteDarkFeatures!default.jspa
ダーク機能ページにこのフラグを追加:
scope.manage.subscriptions.enabledアプリ リンクの作成に進む
Jira Data Center で、[管理] > [アプリ リンク] に移動します。
[リンクを作成] を選択します。
[外部アプリケーション] > [受信] を選択します。
[続行] を選択します。
アプリケーション リンクの名前を入力します。
https://id.atlassian.com/outboundAuth/finishをリダイレクト URL として挿入します。アプリの権限については、[サブスクリプションを管理] を選択します。
[保存] を選択します。
アプリケーション リンク テーブルの [アクション] で、その他のアクション (•••) > [認証情報を表示] の順に選択します。
[クライアント ID] と [クライアント シークレット] をメモします。この情報は、アトラシアンの管理でコネクタをセットアップする際に必要になります。
ステップ 3: アトラシアンの管理でコネクタをセットアップする
アトラシアンの管理の Jira Data Center コネクタのセットアップ画面にアクセスします。
移動 Atlassian Administration. Select your organization if you have more than one.
[アプリ] > [AI 設定] > [Rovo] の順に選択します。
[サイト] で、接続するサイトの横にある [コネクタを追加] を選択します。
[Jira Data Center] を選択して [次へ] を押します。
Jira Data Center を設定します。
Jira Data Center の接続の名前を入力します。
Data Center のネットワーク タイプを選択します。
ネットワークがファイアウォールの内側にあり、パブリック インターネットからアクセスできない場合は、プライベート ネットワークを選択します。事前にセットアップしたアプリケーション トンネルを選択します。
Jira Data Center インスタンスにパブリック インターネットからアクセスできる場合、またはトンネルを使用する代わりに受信接続や IP を許可リストに登録している場合は、パブリック ネットワークを選択します。Jira Data Center インスタンスのサーバー ベース URL (該当する場合はコンテキスト パスを含む) を挿入します。
OAuth のクライアント ID とクライアント シークレットを入力します。
免責事項を確認します。
[Authorize Jira Data Center (Jira Data Center を承認)] を選択します。
次のステップ
Jira Data Center の接続が完了すると、チーム メンバーには、検索のフィルター オプションとして Jira Data Center と Jira Service Management Data Center (該当する場合) が表示されます。結果が表示される前に接続を求められます。これは、Rovo においてチーム メイトに表示する結果をそれぞれのアクセス権に基づいて制限するのに必要です。
Jira Data Center インスタンス内のコンテンツの量によっては、すべてがインデックス化されて Rovo に表示されるまでに時間を要する場合があります。
Rovo コネクタを管理する
これらのステップは、Jira Data Center 11.3 以降に適用されます。
認証情報を取り消す
認証情報が漏洩し、安全でなくなった可能性がある場合は、認証情報を取り消してコネクタを無効にできます。
Rovo の認証情報を取り消すには、次の手順に従います。
1. Data Center インスタンスに移動します。[管理] にアクセスし、[アプリケーション リンク] を見つけて、[クラウド コネクタ] に移動します。
2. [その他のアクション] () を選択し、[Revoke credentials (認証情報を取り消す)] を選択します。
3. [Revoke credentials (認証情報を取り消す)] を選択してアクションを確定します。コネクタのステータスが [無効] に変更されます。
Rotate credentials
Rovo の認証情報は、有効期限が切れた場合や取り消された後にローテーションできます。
Rovo の認証情報をローテーションするには、次の手順に従います。
1. クラウドの管理ハブで、[Data Management (データ管理)] > [データソース] > [接続済みソース] の順に移動します。
2. 組織コネクタを見つけて展開します。
3. Rovo 接続の横にある [その他のアクション] () を選択し、[Rotate credentials (認証情報をローテーションする)] を選択します。
4. [Rotate credentials (認証情報をローテーションする)] を選択してアクションを確定します。認証情報のローテーションが実行されるまで、最大 30 分間お待ちください。コネクタのステータスが [Connected (接続済み)] に変わります。
Delete connector
Rovo コネクタは必要に応じて何度でも削除して再確立できます。コネクタを削除するには、接続済みステータスである必要があります。
Data Center から Rovo コネクタを削除するには、次の手順に従います。
1. Go to your Data Center instance, go to Administration, find Application links, and then go to Cloud connectors.
2. [その他のアクション] () を選択し、[Delete connector (コネクタを削除する)] を選択します。
3. Confirm your action by selecting Delete.
クラウドから Rovo コネクタを削除するには、次の手順に従います。
1. クラウドの管理ハブで、[Data Management (データ管理)] > [データソース] > [接続済みソース] の順に移動します。
2. 組織コネクタを見つけて展開します。
3. Rovo コネクタの横で、[その他のアクション] () を選択し、[Delete connector (コネクタを削除する)] を選択します。
4. Confirm your action by selecting Delete.
コネクタがクラウドと Data Center のどちらの管理者パネルにも表示されなくなります。
この内容はお役に立ちましたか?