拡充タスク用の外部コネクタを構成する

サードパーティの認証プロバイダを使用すると、Knowledge Studio の拡充タスクを GitHub、Microsoft SharePoint、Atlassian Confluence などの外部プラットフォームに安全に接続できます。前提条件の設定の一環として、このドキュメントの認証情報の生成と認証プロバイダの構成手順を完了します。

始める前に

外部コネクタを構成する前に、次の前提条件を完了していることを確認してください。

  • 拡充タスクの前提条件を構成するで、拡充構成ワークフローの全体を確認する。
  • ターゲットのサードパーティ プラットフォーム（GitHub、Microsoft SharePoint、Atlassian Confluence）で、アクセス トークンの生成やアプリケーションの登録に必要な管理者権限またはデベロッパー権限があることを確認します。
  • 認証情報を安全に保存してタスクにアタッチするには、Agent Identity サービスが正しく構成されていることを確認します。詳細については、認証プロバイダの IAM 権限を設定するをご覧ください。

拡充エージェントをサードパーティのナレッジソースに接続する場合は、 Google Cloud Agent Identity サービスを使用する必要があります。Agent Identity は、サードパーティの認証情報を安全に保存し、短期間有効なアクセス トークンを拡充エージェントにプロビジョニングする認証マネージャーとして機能します。これにより、人間のオペレーターがタスクの実行中に未加工のクライアント シークレットを直接管理する必要がなくなります。

GitHub を構成する

Knowledge Studio を GitHub リポジトリに接続するには、GitHub で詳細な個人アクセス トークン（PAT）を作成し、API キー認証プロバイダに保存する必要があります。

  1. GitHub にログインし、プロフィール写真をクリックして、[Settings] をクリックします。
  2. [Developer settings] > [Personal access tokens] > [Fine-grained tokens] に移動します。
  3. [Generate new token] をクリックします。
  4. トークンのプロパティを構成します。
    • トークン名: わかりやすい名前を入力します（例: enrichment-agent）。
    • 有効期限: 適切な有効期限を設定します。
    • リソース オーナー: ターゲット リポジトリを所有する組織またはユーザー アカウントを選択します。
    • リポジトリ アクセス: [Only select repositories] を選択し、拡充するリポジトリを選択します。
    • 権限: 必要なスコープ（問題、pull リクエスト、コンテンツなど）に対して、特定の読み取りアクセス権または読み取り / 書き込みアクセス権を付与します。
  5. [Generate token] をクリックし、トークンを安全にコピーします。
  6. Google Cloud に API キー認証プロバイダを登録し、API キーとして PAT を指定します。認証マネージャーで API キーを使用して認証するをご覧ください。

PAT の作成の詳細については、GitHub ドキュメントの個人用アクセス トークンの管理をご覧ください。

Microsoft SharePoint を構成する

Microsoft SharePoint に接続する場合は、2-Legged OAuth フローを使用して Microsoft Entra ID（旧 Azure Active Directory）から OAuth 認証情報を取得します。

  1. Microsoft Entra 管理センターで新しいアプリケーションを登録します。
  2. Microsoft Graph API の権限を付与します。
    1. [API permissions] > [Add a permission] > [Microsoft Graph] > [Application permissions] に移動します（[Delegated permissions] は選択しないでください）。
    2. Sites.Read.All スコープと Files.Read.All スコープを追加します。
    3. テナントの [Grant admin consent] をクリックして、両方のアプリケーション権限が「Granted」と表示されるようにします。

  3. 新しいクライアント シークレットを作成します。この値は 1 回しか表示されないため、すぐに記録してください。詳細については、新しいクライアント シークレットを作成するをご覧ください。

  4. アプリケーションの構成値をコピーします。登録後、認証プロバイダの構成用に次の値を収集します。

    • クライアント ID: アプリの概要に表示されるアプリケーション（クライアント）ID。
    • トークン URL: [概要] ページで、[エンドポイント] タブをクリックします。[OAuth 2.0 トークン エンドポイント（v2）] というラベルの URL をコピーします。

  5. これらのシークレットを使用して、 Google Cloud に 2-legged OAuth 認証プロバイダを登録します。プロバイダを作成するときに、--allowed-scopes パラメータにデフォルトのスコープを指定します。

    --allowed-scopes="https://graph.microsoft.com/.default"

    詳細については、Microsoft Entra のドキュメントの Microsoft ID プラットフォームにアプリケーションを登録するをご覧ください。

Atlassian Confluence を構成する

Confluence はサーバー間エージェントの 2-Legged OAuth をサポートしていないため、Atlassian で専用のサービス アカウント（またはダミーのユーザー アカウント）を作成し、必要な権限を付与して、PAT を生成する必要があります。

  1. Confluence で特定のサービス アカウントにログインします。
  2. 画面右上にあるプロフィール写真をクリックします。
  3. メニューから [設定]（または [アカウント設定]）を選択します。
  4. [Security] タブで、[API tokens] セクションに移動します。
  5. [Create API token with scopes] ボタンをクリックします。スコープなしのトークンは、必要なツールをすべて取得できないため、使用しないでください。
  6. わかりやすい名前（enrichment-agent など）を指定し、有効期限を構成して、[次へ] をクリックします。
  7. [アプリを選択] リストで [Atlassian MCP] オプションを選択し、[次へ] をクリックします。
  8. 次の Confluence の読み取りスコープと検索スコープをすべて選択します。
    • read:page:confluence
    • read:space:confluence
    • search:confluence
    • read:confluence-content.all
    • read:confluence-content.summary
    • read:confluence-space.summary
    • search:rovo:mcp
    • read:jira-work
  9. [次へ] をクリックし、[作成] をクリックします。
  10. 生成されたトークンをコピーします。
  11. Google Cloud 認証プロバイダの認証情報文字列を <ATLASSIAN_EMAIL>:<API_TOKEN> としてフォーマットします。Atlassian では、個人用 API トークンをプログラムで使用するために、HTTP 基本認証エンコード（email:api_token）が必要です。
  12. Google Cloud に API キー認証プロバイダを登録し、API キーとして <ATLASSIAN_EMAIL>:<API_TOKEN> 文字列を指定します。認証マネージャーで API キーを使用して認証するをご覧ください。

PAT の作成の詳細については、Atlassian ドキュメントの Atlassian アカウントの API トークンを管理するをご覧ください。

次のステップ