設定擴充工作的外部連接器

第三方驗證服務供應商可讓您安全地將 Knowledge Studio 擴充工作連結至外部平台，例如 GitHub、Microsoft SharePoint 和 Atlassian Confluence。請完成本文件中的憑證產生和驗證提供者設定步驟，做為必要條件設定的一部分。

事前準備

設定外部連接器前，請務必完成下列必要條件：

  • 請參閱「設定擴充工作的必要條件」，瞭解整體擴充設定工作流程。
  • 確認您在目標第三方平台 (GitHub、Microsoft SharePoint 或 Atlassian Confluence) 具備必要的管理員或開發人員權限，可產生存取權杖或註冊應用程式。
  • 如要安全儲存憑證並附加至工作，請務必正確設定代理身分服務。詳情請參閱「設定驗證提供者的 IAM 權限」。

將擴充代理連結至第三方知識來源時，必須使用 Google Cloud 代理身分服務。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. 設定權杖屬性：
    • Token name：輸入描述性名稱 (例如 enrichment-agent)。
    • 到期日：設定適當的到期日。
    • Resource owner (資源擁有者)：選取擁有目標存放區的組織或使用者帳戶。
    • Repository access：選取「Only select repositories」，然後選擇要擴充的存放區。
    • 權限：為必要範圍 (例如「Issues」、「提取要求」和「Contents」) 授予特定的「Read」或「Read and Write」存取權。
  5. 按一下「Generate token」，然後複製權杖並妥善保存。
  6. 在 Google Cloud 中註冊 API 金鑰驗證供應商，並提供 PAT 做為 API 金鑰。請參閱「使用 API 金鑰和驗證管理工具進行驗證」。

如要進一步瞭解如何建立 PAT，請參閱 GitHub 說明文件中的「Managing your personal access tokens」(管理個人存取權杖)。

設定 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. 建立新的用戶端密鑰。請立即記下這個值，因為它只會顯示一次。詳情請參閱「建立新的用戶端密鑰」。

  4. 複製應用程式設定值。註冊後，請收集下列驗證提供者設定值：

    • 用戶端 ID：應用程式總覽中的應用程式 (用戶端) ID。
    • 權杖網址：在「總覽」頁面中，按一下「端點」分頁標籤。複製標示為「OAuth 2.0 權杖端點 (v2)」的網址。

  5. 使用這些密鑰在 Google Cloud 中註冊 2-legged OAuth 驗證提供者。建立供應器時，請將預設範圍提供給 --allowed-scopes 參數：

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

    詳情請參閱 Microsoft Entra 說明文件中的「向 Microsoft 身分識別平台註冊應用程式」。

設定 Atlassian Confluence

由於 Confluence 不支援伺服器對伺服器代理程式的 2-Legged OAuth，因此您必須在 Atlassian 中建立專屬服務帳戶 (或虛擬使用者帳戶)，授予必要權限，並產生 PAT。

  1. 在 Confluence 中登入特定服務帳戶。
  2. 按一下畫面右上角的個人資料相片。
  3. 在選單中選取「設定」 (或「帳戶設定」)。
  4. 在「安全性」分頁中，前往「API 權杖」部分。
  5. 按一下「Create API token with scopes」按鈕。請勿使用未限定範圍的權杖，否則系統不會擷取所有必要工具。
  6. 提供描述性名稱 (例如 enrichment-agent)、設定到期日，然後按一下「Next」(下一步)。
  7. 在「Select the app」(選取應用程式) 清單中，選取「Atlassian MCP」選項，然後按一下「Next」(下一步)。
  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 規定必須使用 HTTP 基本驗證編碼 (email:api_token)，才能透過程式輔助方式使用個人 API 權杖。
  12. 在 Google Cloud 中註冊 API 金鑰驗證供應商，並提供 <ATLASSIAN_EMAIL>:<API_TOKEN> 字串做為 API 金鑰。請參閱「使用驗證管理工具透過 API 金鑰進行驗證」。

如要進一步瞭解如何建立 PAT，請參閱 Atlassian 說明文件中的「管理 Atlassian 帳戶的 API 權杖」。

後續步驟