Confluence Data Center を Rovo に接続する

Confluence Data Center のページとブログ投稿を Rovo に統合することで、Data Center および Cloud サイト全体でチームのナレッジを一元化します。

何がインデックス化されますか?

Confluence DC コネクタは、次のオブジェクトのインデックス化を実行します。

ページ
ブログ投稿
コメント
添付ファイル

各オブジェクトについて、次の属性がインデックス化されます。

名前
URL
createdDate
最終更新日
作成者
投稿者
ドキュメント本文
スペース
ラベル
反応
すべての親ページ
ページビュー数

はじめる前に

Rovo では常に権限が遵守されます。ユーザーには、すでにアクセス権があるコンテンツのみが表示されます。コネクタと権限の詳細については、こちらをご確認ください。
Confluence Data Center コネクタは、Confluence 9.4 以降、および 9.2.6 LTS 以降でサポートされています。
Confluence 10.2 以降では、クラウドコネクタを介して Data Center とクラウドをリンクする新しい方法を導入しています。このアプローチでは、引き続きアプリケーションリンクを接続方法として利用できますが、今後は OAuth 2.0 によって強化されます。
レート制限を有効にしている場合は、コンテンツが Rovo でシームレスにインデックス化されるように、リクエスト制限を調整する必要があることがあります。

概要

Confluence Data Center を Rovo に接続する準備ができている場合は、次のステップを実行します。これらのステップは、ご利用の Confluence Data Center バージョンによって異なります。

Confluence Data Center 10.2 以降では、次のようにクラウドコネクタを使用します。

Data Center インスタンスがプライベートネットワークでホストされている場合は、アプリトンネルを作成します。
Data Center をクラウドコネクタでクラウドに接続します。
クラウドコネクタを使用して Rovo コネクタをセットアップします。
含めるスペースを選択します。

既存の Rovo コネクタをクラウドコネクタに切り替えることは、インデックス再作成がトリガーされ、問題が発生する可能性があるため、現時点では推奨していません。

Confluence Data Center 10.1 以前の場合は、アプリケーションリンクを使用します。

アプリケーショントンネルを作成するか、許可リストを設定します。このステップは、プライベートネットワークでホストされている Confluence インスタンスにのみ適用されます。Confluence インスタンスがパブリックインターネットにある場合は、このステップをスキップしてください。
受信アプリケーションリンクを作成します。
アトラシアンの管理でコネクタをセットアップします。
含めるスペースを選択します。

Confluence Data Center インスタンスを 1 つのクラウドテナントに接続する際の制限を撤廃しました。Rovo コネクタを使用して、必要な数のインスタンスに接続できるようになりました。

検索には一定の制限が適用されます。詳細については、「検索」をご確認ください

クラウドコネクタで Rovo に接続する

これらのステップは、Confluence Data Center 10.2 以降に適用されます。それ以前のバージョンをご利用の場合は、アプリリンクによる他の接続オプションをご確認ください。

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

Confluence Data Center インスタンスにパブリックインターネットからアクセスできる場合は、このステップをスキップしてステップ 2 に進んでください。

Confluence Data Center インスタンスがプライベートネットワークにある場合は、Cloud 組織から Confluence Data Center インスタンスへのアプリトンネルをセットアップする必要があります。設定を調整することで、既存のトンネルも使用できます。トンネルの詳細

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

必要な接続とアップストリームポートを設定します。
移動 Atlassian Administration. Select your organization if you have more than one.
[データ管理] > [データソース] > [アプリケーショントンネル] の順に選択します。
[トンネルを作成] を選択します。
ウィザードに従ってオンプレミスインスタンスの詳細を入力して、トンネルに関連付けられたセキュリティキーを生成します。
Confluence Data Center インスタンスにキーを追加します。
1. インスタンスにリダイレクトされるようにするには、[Copy and process (コピーして処理)] を選択します。
2. インスタンスの管理者にキーを渡すには、[コピー]、[閉じる] の順に選択します。キーは、[管理] > [アプリケーショントンネル] で [セキュリティキーを追加] を選択することで手動で追加できます。
セキュリティキーを貼り付けて、ウィザードのステップに従います。

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

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

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

インストールディレクトリで conf/server.xml ファイルを編集します。
secure="true" という属性が含まれるようにコネクタを更新します。

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

ステップ 2: クラウドコネクタをセットアップする

このステップでは、クラウド組織と Confluence Data Center インスタンスの間に組織レベルのクラウドコネクタを作成します。

「クラウドコネクタを設定する」で説明されているステップを実行したあと、このページに戻ります。

ステップ 3: Rovo コネクタをセットアップする

この手順では、クラウドサイトと Data Center インスタンスを切り替える必要があるため、必ず両方を開いておいてください。

クラウドで Rovo コネクタを作成する

1. クラウド管理者ハブの「Connected sources (接続済みのソース)」ページに移動します。このページを開く方法は、次のように 2 つあります。

a. Data Center の [Confluence 管理] の [Cloud コネクタ] ページで、[Connect cloud apps (クラウドアプリの接続)] を選択します。クラウドの関連ページにリダイレクトされます。

b. クラウドの管理ハブで、[Data Management (データ管理)] > [データソース] > [接続済みソース] の順に移動します。

2. 組織接続の横にある [Connect app (アプリを接続)] を選択します。

Connected sources page in Atlassian admin with Connect app option

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. Confluence 管理画面の [Cloud コネクタ] ページで、[Review request (リクエストのレビュー)] を選択します。

Rovo コネクタのリクエストのレビューオプションを示す、Confluence Data Center 管理のクラウドコネクタ画面

2. [接続リクエストの確認] 画面で [承認] を選択します。Rovo は Teamwork Graph を基盤としているため、リストにはその名前で表示されます。

ステップ 3: クラウドで共有コンテンツを管理する

インデックス化するスペースを選択できます。既定では、すべてのスペースが選択されています。今後作成される新しいスペースを含めるかどうかも選択できます。

作業を開始する前に、次の点に注意してください。

コネクタは、含めるデータの選択を保存した後にのみ、含まれるスペースのコンテンツのインデックス作成を開始します。それまでは、コネクタではスペース名、スペースキー、スペースアイコンを含むすべてのスペースのリストのみをインデックス化します。
個別ページのブロックはサポートされていません。

共有コンテンツを管理するには、次の手順に従います。

1. クラウド管理者ハブの [Connected sources (接続済みのソース)] ページに移動します。新しい Rovo コネクタを見つけて、[コンテンツを管理する] を選択します。

Rovo コネクタのコンテンツを管理するオプションを示す、アトラシアンの管理の接続済みソースページ

2. [Choose data to include (含めるデータを選択する)] 画面で、インデックス化するスペースを選択します。既定では、すべてのスペースが選択されています。次のいずれかの方法を使用できます。

[Automatically include all current and future spaces (現在および今後のすべてのスペースを自動的に含める)] トグルを有効にします。
トグルを無効にして、インデックス化するスペースの名前を選択します。

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

Rovo コネクタが設定されました。

次のステップ

Confluence Data Center との接続が完了すると、チームメンバーには、検索のフィルターオプションとして Confluence Data Center が表示されます。結果が表示される前に接続を求められます。これは、Rovo においてチームメイトに表示する結果をそれぞれのアクセス権に基づいて制限するのに必要です。

Confluence Data Center インスタンス内のコンテンツの量によっては、すべてがインデックス化されて Rovo に表示されるまでに時間を要する場合があります。

接続ステータス

「Connected sources (接続済みのソース)」ページには、Data Center インスタンスが Rovo にどのように接続されているかを示すさまざまなステータスがあります。クラウドと Data Center での接続ステータスの概要は次のとおりです。

クラウドのステータス	Data Center のステータス	説明
接続済み	接続済み	接続は正常に確立されています。
取り消し済み	無効	コネクタの認証情報は取り消されており、クラウド管理者が認証情報をローテーションするまで接続は無効になります。
中断	中断	接続はアクティブでしたが、予期せず動作を停止しました。