外部コンテンツのインデックス作成用に Atlassian Confluence Cloud を構成する

Atlassian Developer コンソールで 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/)	組織アドミンのログイン認証情報

必要なロール：なし

このタスクについて

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

コネクタが Confluence Cloud API を介してAtlassian Confluence Cloudソースシステムにアクセスできるようにするには、Atlassian Developer コンソールで OAuth 2.0 統合を設定し、Atlassian Administration で API キーを設定する必要があります。Now 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. [詳細なスコープ (Granular scopes)] タブで、 [スコープを編集 (Edit Scopes)] を選択し、次の各スコープのオプションを選択します。
      • read:attachment:confluence
      • read:blogpost: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. [保存] をクリックします。
      
   8. OAuth 2.0 統合の [認証] ページに移動し、OAuth 2.0 (3LO) 認証タイプの行で [ 追加 ] を選択します。
      
   9. コールバック URL として https://<instance-name>.service-now.com/oauth_redirect.do と入力し、 <instance-name> を Now Platform® インスタンス名に置き換えて、[ 変更内容を保存] を選択します。
      
   10. OAuth 2.0 統合の [設定] ページに移動し、クライアント ID とシークレットの値を安全な場所に記録します。
       

       重要:

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

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

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

      重要:

      Now Platformアドミンは、Atlassian Confluence Cloud 外部コンテンツコネクタを構成するときに API キーの値を必要とします。
   8. [完了] を選択します。

次のタスク

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

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

Now Platformアドミンは、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サポートリソースで説明されているように、自分のメールのヴィジビリティを [任意の人] に設定することで、コネクタがコンテンツアクセス権限を取得できるようにすることができます。