Connect Confluence Data Center to Teamwork Graph

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

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

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

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

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

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

はじめる前に

Teamwork Graph will always respect permissions. Users will only ever see content that they already have access to. More on connectors and permissions
Confluence Data Center コネクタは、Confluence 9.4 以降、および 9.2.6 LTS 以降でサポートされています。
Confluence 10.2 以降では、クラウドコネクタを介して Data Center とクラウドをリンクする新しい方法を導入しています。このアプローチでは、引き続きアプリケーションリンクを接続方法として利用できますが、今後は OAuth 2.0 によって強化されます。
If you’ve enabled rate limiting, you may need to adjust your request limits to ensure content is seamlessly indexed in Teamwork Graph.

概要

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

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

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

We don’t recommend switching your existing connectors to cloud connectors yet because this will trigger reindex and may cause issues.

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

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

We’ve lifted the limits on connecting Confluence Data Center instances to a single cloud tenant. You can now connect as many instances as you need using connector.

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

Connect to Teamwork Graph via cloud connectors

これらのステップは、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 インスタンスの間に組織レベルのクラウドコネクタを作成します。

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

Step 3: Set up connector

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

Create connector in cloud

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. On the Select an app to connect screen, select Atlassian Teamwork Graph.

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

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 (リクエストのレビュー)] を選択します。

Cloud connectors screen in Confluence Data Center admin with Review request option for Teamwork Graph connector

2. On the Review connection request screen, select Accept.

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

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

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

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

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

1. Refresh the Connected sources page in your cloud Admin Hub. Find your new connector and select Manage content.

Connected sources page in Atlassian admin with option to manage content for Teamwork Graph connector

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

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

Screen with option to choose data to include for Teamwork Graph connector

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

Your connector is now configured.

次のステップ

After you’ve finished connecting Confluence Data Center, your team members will see Confluence 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 Teamwork Graph can make sure your teammates only see results they have access to.

Depending on the amount of content in your Confluence Data Center instance, it may take some time for everything to be indexed and appear in Teamwork Graph.

接続ステータス

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

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