外部コンテンツのインデックス作成のための Atlassian Confluence Cloud の構成

Atlassian 開発者コンソールで OAuth 2.0 統合を登録し、Atlassian Administration で API キーを作成して、Atlassian Confluence Cloud 外部コンテンツコネクタが Atlassian Confluence Cloud ソースシステム内のスペースとセキュリティプリンシパルをクロールできるようにします。

始める前に

組織の Atlassian 管理アプリケーションには、次の認証情報と権限が必要です。

Atlassian portal	必要な認証情報と権限
Atlassian 開発者コンソール (https://developer.atlassian.com/console/myapps/)	ログイン認証情報 登録済みアプリケーションの設定を表示する権限 新しいアプリケーションを登録する権限 アプリケーションのきめ細かな Confluence API スコープを設定する権限 アプリケーションの OAuth 2.0 コールバック URL を設定する権限
Atlassian Administration (https://admin.atlassian.com/)	組織アドミンのログイン認証情報

必要なロール：admin

このタスクについて

Atlassian Confluence Cloud外部コンテンツコネクタは、Confluence Cloud API を使用してAtlassian Confluence Cloudソースシステムからコンテンツを取得します。

コネクタが Confluence Cloud API を介して Atlassian Confluence Cloud ソースシステムにアクセスできるようにするには、Atlassian 開発者コンソールで OAuth 2.0 統合を構成し、Atlassian Administration で API キーを構成する必要があります。ServiceNow AI Platformインスタンスアドミニストレーターは、OAuth 2.0 統合からコピーした設定と API キーを使用して、Atlassian Confluence Cloud ソースシステムに適切に接続できるように Atlassian Confluence Cloud 外部コンテンツコネクタを構成できます。

手順

1. Atlassian Developer コンソールで、Atlassian Confluence Cloud外部コンテンツコネクタの新しい OAuth 2.0 統合を登録します。
   1. https://developer.atlassian.com/console/myapps/ で Atlassian 開発者コンソールにログインします。
   2. [自分のアプリ] セクションで、 作成 > OAuth 2.0 統合.
      
   3. OAuth 2.0 統合の名前を入力し、 Atlassian の開発者規約に同意するオプションを選択して、 作成 を選択します。
      

      たとえば、OAuth 2.0 統合の名前として「 Confluence Cloud 外部コンテンツコネクタ 」と入力します。

   4. OAuth 2.0 統合の [アクセス許可] ページに移動し、[Confluence API] 行で [追加 ] を選択します。
      
   5. [Confluence API] 行で [ 構成] を選択します。
      
   6. [詳細なスコープ] タブで、[ スコープの編集 ] を選択し、次の各スコープのオプションを選択します。
      • read:attachment:confluence
      • read:ブログ投稿:Confluence
      • read:content-details:confluence
      • read:content.metadata:confluence
      • read:folder:confluence
      • read:group:confluence
      • read:page:Confluence
      • read:space:confluence
      • read:user:confluence

      
   7. [Save (保存)] を選択します。
      
   8. OAuth 2.0 統合の [認証] ページに移動し、OAuth 2.0 (3LO) 認証タイプの行で [追加 ] を選択します。
      
   9. コールバック URL として 「https://<instance-name>.service-now.com/oauth_redirect.do 」と入力し、 <instance-name> を ServiceNow AI Platform® インスタンス名に置き換えて、[ 変更を保存] を選択します。
      
   10. OAuth 2.0 統合の [設定] ページに移動し、クライアント ID とシークレットの値を安全な場所に記録します。
       

       重要:

       ServiceNow AI Platformアドミニストレーターは、Atlassian Confluence Cloud外部コンテンツコネクタを設定するときに、これらのクライアント ID とシークレットの値を必要とします。
2. Atlassian Administration、新しいアドミン API キーを作成します。
   1. https://admin.atlassian.com/でAtlassian Administrationにログインします。
   2. タブリストの [設定 ] を選択します。
      
   3. [API キー] を選択し、[API キーの作成] を選択します。
      
   4. [開始する前に] ページで、 [スコープのない API キー] を選択し、 [次へ] を選択します。
      
   5. 新しい API キーの名前と有効期限を入力します。
      

      たとえば、API キーの名前として 「Confluence Cloud 外部コンテンツコネクタ 」と入力し、その有効期限を 1 年後に設定します。

   6. [Create (作成)] を選択します。
   7. 安全な場所に API キーの値を記録します。
      

      重要:

      ServiceNow AI Platformアドミンは、Atlassian Confluence Cloud外部コンテンツコネクタを設定するときに API キーの値が必要です。
   8. [Done (完了)] を選択します。

次のタスク

ServiceNow AI Platformアドミンに次のアイテムを提供します。

• ステップ 1.j で記録した OAuth 2.0 統合のクライアント ID とシークレットの値。
• ステップ 2.g で記録した API キーの値。

ServiceNow AI Platformアドミンは、Atlassian Confluence Cloudインスタンスから検索可能なコンテンツとセキュリティプリンシパルを取得するようにAtlassian Confluence Cloud外部コンテンツコネクタを構成するために、これらのアイテムを必要としています。

Atlassian Confluence Cloud外部コンテンツコネクターの作成と設定の詳細については、「Atlassian Confluence Cloud外部コンテンツコネクタの作成」を参照してください。

注:

デフォルトでは、 Atlassian Confluence Cloud 外部コンテンツコネクタは、組織によって管理されている Confluence Cloud ユーザーのコンテンツアクセス権限のみを取得します。その他のConfluence Cloudユーザーは、https://support.atlassian.com/confluence-cloud/docs/configure-user-email-visibility/ Atlassianサポートリソースで説明されているように、自分のメールの可視化を [すべてのユーザー] に設定することで、コネクタがコンテンツのアクセス権限を取得できるようにすることができます。