Confluence Data Center を Rovo に接続する

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

What is indexed?

The Confluence DC connector indexes these objects:

• ページ

• ブログ投稿

• コメント

• 添付ファイル

• 名前

• URL

• createdDate

• 最終更新日

• 作成者

• 投稿者

• Document body

• スペース

• ラベル

• 反応

• All parent pages

• Number of page views

はじめる前に

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

• The Confluence Data Center connector is supported in Confluence 9.4 and above, as well as in 9.2.6 LTS and later.

• Starting with Confluence 10.2. 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 Confluence Data Center to Rovo, follow these steps. The steps will differ based on the Confluence Data Center version you’re using.

For Confluence Data Center 10.2 or later, use сloud 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 Confluence Data Center 10.1 or earlier, use application links:

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

2. 受信アプリケーション リンクを作成します。

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

4. Choose which spaces to include.

Connect to Rovo via cloud connectors

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

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

If your Confluence Data Center instance is on a private network, you need to set up an application tunnel from your Cloud organization to your Confluence Data Center instance. You can also use an existing tunnel by adjusting its configuration. More on tunnels

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

1. Configure the required connections and upstream ports.

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

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

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

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

6. Confluence Data Center インスタンスにキーを追加します。

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

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

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

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

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

既存のトンネルを使用するには、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 Confluence 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 Confluence 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 Confluence 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.

Step 3: Manage shared content in cloud

You can choose which spaces you want to index. All spaces are selected by default. You can also choose whether new spaces created in the future are included or not.

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

• The connector will only start indexing the content of included spaces once you’ve saved your selection of data to include. Before then, the connector will only index the list of all spaces including space names, space keys, and space icons.

• Blocking individual pages isn't supported.

To manage shared content:

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

2. On the Choose data to include screen, choose which spaces you want to index. All spaces are selected by default. You can:

• Enable the Automatically include all current and future spaces toggle.

• Disable the toggle, and then select the names of spaces that you want indexed.

3. Select Save.

Your Rovo 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 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 Confluence Data Center 10.1 and earlier. If you’re using newer versions, check other connection options via cloud connectors.

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

If your Confluence Data Center instance is on a private network, you need to set up an application tunnel from your Cloud organization to your Confluence 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. Configure the required connections and upstream ports.

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

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

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

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

6. Confluence Data Center インスタンスにキーを追加します。

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

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

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

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

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

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

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

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

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

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

Create an application link in the administration of your Confluence Data Center instance to use in the connection process. About creating application links

1. Confluence Data Center で、[管理] > [アプリケーション リンク] に移動します。

2. [リンクを作成] を選択します。

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

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

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

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

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

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

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

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

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

アトラシアンの管理の Confluence Data Center コネクタのセットアップ画面にアクセスします。

1. Go to admin.atlassian.com. 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. [Confluence Data Center] を選択して [次へ] を押します。

Confluence Data Center を設定します。

1. Confluence Data Center の接続の名前を入力します。

2. Data Center のネットワーク タイプを選択します。

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

   2. Confluence Data Center インスタンスにパブリック インターネットからアクセスできる場合、またはトンネルを使用する代わりに受信接続や IP を許可リストに登録している場合は、パブリック ネットワークを選択します。Confluence Data Center インスタンスのサーバー ベース URL (該当する場合はコンテキスト パスを含む) を挿入します。

3. OAuth のクライアント ID とクライアント シークレットを入力します。

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

5. [次へ] を選択します。

Step 4: Choose data to include

You can choose which spaces you want to index. All spaces are selected by default. You can also choose whether new spaces created in the future are included or not.

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

• The connector will only start indexing the content of included spaces once you’ve saved your selection of data to include. Before then, the connector will only index the list of all spaces including space names, space keys and space icons.

• Blocking individual pages is not supported.

Once you’ve set up your connector, you can manage the indexed content:

1. Go to admin.atlassian.com. Select your organization if you have more than one.

2. 設定 > Rovo を選択します。

3. Under Sites, next to Confluence Data Center, select More actions () and select Manage content.

次のステップ

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 Rovo can make sure your teammates only see results they have access to.

Manage Rovo connector

These steps are applicable to Confluence Data Center 10.2 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 connector, 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.