Atlassian Confluence Cloud外部コンテンツコネクタのAtlassian設定の構成

  • リリースバージョン: Yokohama
  • 更新日 2025年02月28日
  • 所要時間：5分

    • Atlassian 開発者コンソールで OAuth 2.0 アプリケーションを登録し、Atlassian 管理 で API キーを作成して、Atlassian Confluence Cloud 外部コンテンツコネクタが Atlassian Confluence Cloud ソースシステムのスペースをクロールし、アクセス許可にアクセスできるようにします。

    始める前に

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

    必要なロール：admin

    このタスクについて

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

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

    手順

    1. Atlassian 開発者コンソールで、次の手順を実行して、Atlassian Confluence Cloud外部コンテンツコネクタの新しい OAuth 2.0 統合を登録します。
      1. https://developer.atlassian.com/console/myapps/ で Atlassian 開発者コンソールにログインします。
      2. [自分のアプリ] セクションで、 作成/挿入 > OAuth 2.0 統合.
        Atlassian の [作成] ボタンと OAuth 2.0 統合メニューアイテム開発者コンソールの [自分のアプリ] 画面。
      3. OAuth 2.0 統合の名前を入力し、 Atlassian の開発者規約に同意するオプションを選択して、 作成 を選択します。
        OAuth 2.0 (3LO) 統合名、開発者用語オプションAtlassian、および Atlassian 開発者コンソールの [作成] ボタン。

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

      4. OAuth 2.0 統合の [権限] 画面に移動し、[Confluence API] 行で [追加 ] を選択します。
        Atlassianの [Confluence API を追加] ボタン開発者コンソールの [権限] 画面。
      5. [Confluence API] 行で [ 構成] を選択します。
        Atlassianの [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
        Atlassianの [スコープを編集] ボタン開発者コンソールの [権限] 画面。
      7. [Save (保存)] をクリックする。
        Atlassian の [保存] ボタン開発者コンソールの [Confluence API の編集] ダイアログボックス。
      8. OAuth 2.0 統合の 認証 画面に移動し、OAuth 2.0 (3LO) 認証タイプの行で 追加 を選択します。
        Atlassian に OAuth 2.0 (3LO) 認証ボタンを追加開発者コンソールの [認証] 画面。
      9. コールバック URL として 「http://<instance-name>.service-now.com/oauth_redirect.do 」と入力し、 <instance-name> を Now Platform® インスタンス名に置き換えて、[ 変更を保存] を選択します。
        Atlassianの [コールバック URL] フィールドと [変更を保存] ボタン開発者コンソールの [認証] 画面。
      10. OAuth 2.0 統合の [設定] 画面に移動し、クライアント ID とシークレットの値を安全な場所に記録します。
        Atlassian のクライアント ID フィールドとシークレットフィールド開発者コンソールの [設定] 画面。
        重要:
        AI 検索アドミニストレーターは、Atlassian Confluence Cloud外部コンテンツコネクタを設定するときに、これらのクライアント ID とシークレットの値を必要とします。
    2. Atlassian 管理で、次の手順を実行して、新しいアドミン API キーを作成します。
      1. https://admin.atlassian.com/でAtlassian 管理にログインします。
      2. タブリストの [設定 ] を選択します。
        Atlassian 管理 コンソールの [設定] タブ。
      3. [API キー] を選択し、[API キーの作成] を選択します。
        Atlassian 管理コンソールの [設定] セクションの [API キー] 画面の [API キーを作成] ボタン
      4. 新しい API キーの名前と有効期限を入力します。
        [API キー名] フィールド、[有効期限] フィールド、および Atlassian 管理 コンソールダイアログボックスの [作成] ボタン。

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

      5. [Create (作成)] を選択します。
      6. 安全な場所に API キーの値を記録します。
        [Atlassian 管理コンソール] ダイアログボックスの API キー。
        重要:
        AI 検索アドミニストレーターは、Atlassian Confluence Cloud外部コンテンツコネクタを設定するときに API キーの値が必要です。
      7. [Done (完了)] を選択します。
    3. Now Platform インスタンスで、次の手順を実行して、Atlassian Confluence Cloud OAuth 2.0 プロバイダーのリダイレクト URL を変更します。
      1. [All (すべて)] を選択します。
      2. [フィルター] フィールドに「oauth_entity.list」と入力します。
      3. Atlassian Confluence Cloud OAuth 2.0 プロバイダーエンティティレコードを編集します。
      4. エンティティレコードのリダイレクト URL を http://<instance-name>.service-now.com/oauth_redirect.do に設定し、 <instance-name> を Now Platform インスタンス名に置き換えます。
      5. [Update (更新)] を選択します。

    次のタスク

    AI 検索アドミニストレーターに次のアイテムを提供します。
    • ステップ 1.j で記録した OAuth 2.0 統合のクライアント ID とシークレットの値。
    • ステップ 2.f で記録した API キーの値。

    AI 検索アドミニストレーターは、Atlassian Confluence Cloudインスタンスからドキュメントとアクセス権限を取得するためのAtlassian Confluence Cloud外部コンテンツコネクタを作成するために、これらのアイテムを必要としています。

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