Confluence Data Center を Teamwork Graph に接続する

Centralize your team’s knowledge across Data Center (DC) and Cloud sites by integrating your Confluence Data Center pages and blog posts into Teamwork Graph.

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

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

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

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

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

はじめる前に

Teamwork Graph では常に権限が遵守されます。ユーザーには、すでにアクセス権があるコンテンツのみが表示されます。コネクタと権限の詳細をご確認ください
Confluence Data Center コネクタは、Confluence 9.4 以降、および 9.2.6 LTS 以降でサポートされています。
Starting with Confluence 10.2. we’re introducing a new way to link Data Center and cloud via cloud connectors. They’re are also available in Confluence 9.2.22 (including later 9.2 patches). In this approach, application links remain the method of connection and are now enhanced with OAuth 2.0.
レート制限を有効にしている場合は、コンテンツが Teamwork Graph でシームレスにインデックス化されるように、リクエスト制限を調整する必要があることがあります。

概要

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

For Confluence 10.2 and later, and Confluence 9.2.22 (including later 9.2 patches), use сloud connectors:

Set up an application tunnel (if required).
Check that the Application tunnels app is installed in Jira Data Center.
Data Center をクラウドコネクタでクラウドに接続します。
Cloud コネクタを使用して Teamwork Graph コネクタをセットアップします。
含めるスペースを選択します。

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

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

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

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

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

Cloud コネクタで Teamwork Graph に接続する

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

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

You may be able to skip this step. Refer to the following table:

	Confluence instance accessible over public internet	Confluence instance is on a private network
Confluence instance is earlier than 10.2	Go to step 2 (Your tunnel will be set up automatically)	Complete step 1 (Set up an application tunnel)
Confluence instsance is 10.2 or later	Go to step 2 (Your tunnel will be set up automatically)	Go to step 2 (Your tunnel will be set up automatically)

Confluence instance accessible over public internet

Confluence instance is on a private network

Confluence instance is earlier than 10.2

Go to step 2

(Your tunnel will be set up automatically)

Complete step 1

(Set up an application tunnel)

Confluence instsance is 10.2 or later

Go to step 2

(Your tunnel will be set up automatically)

Go to step 2

(Your tunnel will be set up automatically)

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

必要な接続とアップストリームポートを設定します。
移動アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。
Select Data management, then Data sources, then Application tunnels.
[トンネルを作成] を選択します。
ウィザードに従ってオンプレミスインスタンスの詳細を入力して、トンネルに関連付けられたセキュリティキーを生成します。
Confluence Data Center インスタンスにキーを追加します。
1. インスタンスにリダイレクトされるようにするには、[Copy and process (コピーして処理)] を選択します。
2. インスタンスの管理者にキーを渡すには、[コピー]、[閉じる] の順に選択します。キーは、[管理] > [アプリケーショントンネル] で [セキュリティキーを追加] を選択することで手動で追加できます。
セキュリティキーを貼り付けて、ウィザードのステップに従います。

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

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

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

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

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

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

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

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

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

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

Also in this step, we’ll run a check to reach your Data Center instance.

if a tunnel is already connected to your instance, it will be selected automatically.
If no tunnel exists and your version supports automatic setup, you can create one directly during this step. Credentials are exchanged automatically, with no manual copying and no Data Center restart.

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

1. Go to アトラシアンの管理。組織が複数ある場合は、対象の組織を選択します。

2. Select Data management, then Data sources, then Connected sources.

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

[Connect app (アプリを接続)] オプションを示す、アトラシアンの管理の [接続済みソース] ページ

4. On the Select an app to connect screen, select Atlassian Teamwork Graph.

The options to select an app to connect.

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

6. 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.

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

8. 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.

Data Center で接続リクエストを承認する

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

Teamwork Graph コネクタのリクエストのレビューオプションを示す、Confluence Data Center 管理の [Cloud コネクタ] 画面

2. On the Review connection request screen, select Accept. For behind-the-firewall instances, this approval covers both the application tunnel and the Teamwork Graph connector. Rovo is powered by Teamwork Graph, so it will appear with that name on the list.

If you chose to have a tunnel automatically created, after accepting the connection, no restart of the Data Center instance is required.

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

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

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

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

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

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

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

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

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

Teamwork Graph コネクタに含めるデータを選択するオプションが表示された画面

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

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

次のステップ

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

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

接続ステータス

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

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