Cloud コネクタを設定する

このガイドでは、Cloud コネクタで Atlassian Cloud 組織を Data Center インスタンスに接続する方法について説明します。クラウド コネクタの設定は、Data Center インスタンスで Rovo または Portfolio Insights コネクタを使用するための前提条件です。 

これらの手順は、Jira 11.3 以降と Confluence 10.2 以降に適用されます。それより前のバージョンを使用している場合、アプリケーション リンクまたは製品内統合を使用した他の接続オプションを確認してください。

はじめる前に

Data Center をクラウドに接続する前に、これらの要件を満たしていることを確認してください。

Data Center インスタンスのバージョンを確認する

Jira の場合、バージョン 11.3 以降である必要があります。

Confluence の場合、バージョン 10.2 以降である必要があります。

それより前のバージョンを使用している場合、Cloud Companion アプリを使用するか、アプリケーション リンクまたは製品内統合を使用した他の接続オプションを確認してください。

一般的な要件

クラウド コネクタをセットアップするには、次のものが必要です。

1. Atlassian Cloud 組織。お持ちでない場合は、無料で作成できます。
2. Atlassian Cloud の組織管理者権限。
3. Data Center インスタンスのシステム管理者権限。Cloud と Data Center で管理者を分けることができます。Data Center に接続しているときは、接続の詳細を相互に共有できるようになります。
4. 許可リストの設定:
   1. https://api.atlassian.com ドメインを Data Center インスタンスの許可リストに追加します。Jira での許可リストの設定と Confluence での許可リストの設定で詳細をご確認ください。
5. ファイアウォールの設定:
   1. ポート 443 で api.atlassian.com への TCP 接続を許可する新しいルールを作成します。

ステップ 1: Cloud Companion アプリをインストールまたはアップグレードする (Portfolio Insights のみ)

Cloud Companion アプリをインストールするか、お使いの Data Center 製品バージョンと互換性のあるバージョンにアップグレードします。このアプリは、Data Center インスタンスをクラウドにリンクさせるのに役立ちます。

ステップ 2: アプリケーション トンネルを設定する (Rovo のみ)

 Data Center インスタンスが非公開ネットワークにホストされている (ファイアウォールの内側にある) 場合、クラウド接続はそのインスタンスに到達できません。この制限を回避するには、次のいずれかを実行してください。

1. アプリケーション トンネルを作成する
2. 既存のトンネルを使用する:
   1. トンネルのセットアップ時に、conf/server.xml で作成した HTTP コネクタを見つけます。 
   2. secure="true" という属性が含まれるように HTTP コネクタを更新します。

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

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

このステップでは、クラウド組織と Data Center インスタンスの間でコネクタを作成します。このコネクタは、後で Data Center インスタンスをアプリ (Rovo または Portfolio Insights) に接続するために使用されます。

1. クラウドの管理ハブで、[Data Management (データ管理)] > [データソース] > [接続済みソース] の順に移動します。
2. [Connect data source (データ ソースを接続)] を選択します。
   
3. [Agree to connect (接続に同意)] 画面で、共有するデータを確認してから [次へ] を選択します。
4. [Add details of your instance (インスタンスの詳細を追加)] 画面で、次の情報を入力します。
   1. [ベース URL] – ベース URL を見つけるには、Data Center インスタンスにログインし、[管理] > [一般設定] の順に移動します。 
   2. [インスタンス名] – インスタンスの名前。
   3. 次へ をクリックします。
5. 接続を完了するには、[Complete connection (接続の完了)] 画面の [Client credentials (クライアント認証情報)] フィールドで [コピー] を選択します。
   
6. 次のステップは、Data Center のシステム管理者権限を持っているかどうかによって異なります。
   1. Data Center 管理者権限を持っている場合:
      1. [Continue to Data Center (Data Center に進む)] を選択します。Data Center インスタンスの管理者設定にリダイレクトされ、接続を完了します。それ以外の場合は、Data Center インスタンスに移動します。[管理] にアクセスし、[アプリケーション リンク] を見つけて、[Cloud connectors (Cloud コネクタ)] に移動します。
      2. セキュリティ キーを [Client credentials (クライアント認証情報)] フィールドに貼り付けて、[Connect (接続)] を選択します。新しい Cloud コネクタが表示されます。
         
   2. Data Center 管理者の権限をお持ちでない場合は、クライアント認証情報をコピーして Data Center 管理者に送信し、接続を完了してください。

これで、クラウドから Data Center インスタンスへの接続が確立されました。 

ステップ 4: アプリを接続する

アプリを接続するには、Data Center インスタンスの [Cloud connectors (Cloud コネクタ)] ページで、[Connect cloud apps (クラウド アプリの接続)] を選択します。 

クラウド インスタンスにリダイレクトされます。接続するアプリに応じた手順に従ってください。

• Jira Data Center を Rovo に接続する
• Confluence Data Center を Rovo に接続する
• Portfolio Insights を Data Center インスタンスに接続する

Connection Status

各ステータスは接続で何が起こっているかを示すため、接続を管理、監視する上で重要な役割を果たします。 

コネクタの認証情報をローテーションする

認証情報をローテーションすると、既存のセキュリティ キーは新しいセキュリティ キーに置き換えられます。クラウドとのリンクを継続するには、Data Center インスタンスでキーを更新する必要があります。

組織コネクタの認証情報をローテーションできるユースケースはいくつかあります。

• 既存の認証情報が漏洩し、安全ではなくなった可能性がある。 
• 組織コネクタが無効になったため、Data Center インスタンスをクラウドに再接続する必要がある。

認証情報をローテーションするには、次の手順を実行します。

1. クラウドの管理ハブで、[Data Management (データ管理)] > [データソース] > [接続済みソース] の順に移動します。
2. Select More actions , and then Rotate credentials.
   
3. [Rotate credentials (認証情報をローテーション)] 画面で、[次へ] を選択します。
4. [Copy Credentials (認証情報のコピー)] 画面の [Client credentials (クライアント認証情報)] で、[コピー] を選択します。
5. [Continue to Data Center (Data Center に進む)] を選択します。Data Center インスタンスの管理者設定にリダイレクトされ、接続を完了します。それ以外の場合は、次を実行します。
   1. Data Center インスタンスに移動します。[管理] にアクセスし、[アプリケーション リンク] を見つけて、[Cloud connectors (Cloud コネクタ)] に移動します。
   2. Select More actions , and then Apply new credentials.
6. セキュリティ キーを [Client credentials (クライアント認証情報)] フィールド貼り付けて、[Connect (接続)] を選択します。
   

コネクタを無効にする

組織コネクタを一度セットアップすると、削除することはできません。コネクタを無効にしてから、新しい認証情報を適用して再度有効にすることができます。組織コネクタを無効にするには、接続したすべてのアプリを削除する必要があります。

接続を無効にするには、次の手順を実行します。

1. クラウドの管理ハブで、[Data Management (データ管理)] > [データソース] > [接続済みソース] の順に移動します。
2. 組織コネクタに関連付けられているアプリ コネクタを削除します。クラウドまたは Data Center からアプリ コネクタを削除できます。 
   1. Jira の Rovo コネクタを削除する
   2. Confluence の Rovo コネクタを削除する
   3. Portfolio Insights コネクタを削除する
3. Select More actions , and then Disable connector.
4. [無効にする] を選択して、アクションを確定します。