共用方式為

GitLab Server Microsoft 365 Copilot 連接器

GitLab Server Microsoft 365 Copilot 連接器允許您的組織索引 GitLab 中儲存的合併請求、議題、維基及文件。 設定連接埠並索引 GitLab 內容後，使用者可透過 Microsoft Search 與 Microsoft 365 Copilot 搜尋與檢索資訊。

本文是針對 Microsoft 365 管理員，或任何設定、執行或監控 GitLab Microsoft 365 Copilot 連接器的人。

功能

  • 索引 GitLab 倉庫、合併請求，以及存取問題、維基和文件。
  • 啟用 Microsoft Search 與 Microsoft 365 Copilot，以有效取得 GitLab 資料。
  • 維護 GitLab 的 ACL 和使用者權限。
  • 允許管理員自訂爬取頻率與索引偏好。

限制

  • 該連接器不支援除狀態索引外的 GitLab CI/CD 管線索引。
  • 只有資料庫、議題、合併請求、.md、.txt 檔案和維基會被索引。
  • 禁止使用者作為權限規則不被支持。 作為一個變通方法，管理員可以將使用者從群組中移除。
  • 不支援以 IP 位址限制群組存取。 我們建議管理員建立一個私人群組來管理存取權限。
  • 由於 Microsoft 內部測試中發現的穩定性疑慮，對 Planner 角色的支援已保守地減少。 現在僅限於記者及以上職位。 使用者在指派團隊成員擔任規劃者角色時可能會遇到問題。 為減少潛在問題，請指派報告員或更高階職務。 我們密切關注此功能，並持續改進。
  • 對於 GitLab Server Copilot 連接器，出於安全考量，對公開專案合併請求的存取權保守地設為報告者角色及以上。

必要條件

在安裝連接器前，請先確認以下事項：

  1. 確認你的 GitLab 實例是否能透過 API 存取。
  2. 從 GitLab 產生 Client ID 和 Client Secret 進行驗證。
  3. 認證使用者帳號必須能存取資料庫、議題、合併請求、知識檔案及維基頁面。
  4. 用戶端 ID 與用戶端秘密必須包含以下範圍：
    • read_api
    • read_repository
    • read_user
  5. 存取已索引的 GitLab 資料的使用者必須擁有對應的 Microsoft Entra ID 身份以進行權限映射。
  6. 在 GitLab 認證設定時 ，請設定適當的重定向 URL ：
    • Microsoft 365 企業版：
      https://gcs.office.com/v1.0/admin/oauth/callback
    • Microsoft 365 政府：
      https://gcsgcc.office.com/v1.0/admin/oauth/callback

GitLab server Copilot 連接器細節

對於 自我管理的 GitLab 實例，請確保以下事項：

  • GitLab 版本必須是 17.7 或更新版本。
  • Microsoft Graph 連接器代理程式版本必須是 3.1.8.0 或更新版本，且必須安裝在能連接 GitLab 實例的伺服器上。
    請依照 設定指南 設定代理。
  • 認證帳號必須擁有 管理員權限 才能啟用 ACL 爬取。
  1. 為了提升效能，請在 使用者和 IP 速率限制 設定中停用或提高限制。 欲了解更多資訊，請參閱 GitLab 文件。 建議配置如下：
    • 使用者與 IP 速率限制：取消勾選 Enable authenticated API request rate limit 和 Enable authenticated web request rate limit。
    • 檔案 API 速率限制：取消勾選 Enable authenticated API request rate limit。
    • 已淘汰的 API 速率限制：取消勾選 Enable authenticated API request rate limit。
    • 使用者 API 速率限制：設定 Max requests per 10 minutes per user 為高值 (，例如) 100000 。
    • 群組 API 速率限制：將所有值設為 以 0 停用限制。
    • 專案 API 速率限制：將所有值設為 以 0 停用限制。
    • 成員 API 速率限制：設為 0。

快速入門

1. 選擇顯示名稱

選擇一個顯示名稱，幫助使用者辨識合併請求、問題或 Copilot 回應中的文件。

2. 認證

  • 輸入你的 GitLab 中的客戶端 ID 和 客戶端秘密 。
  • 選擇 授權 登入並授權存取。
  • 授予所需的 API 範圍。

3. 推廣至有限族群

在部署連接器前，先用有限的使用者在 Copilot 和 Microsoft Search 測試連線。

自訂設定

自訂設定是給管理員用，方便編輯預設值。 當你選擇 自訂設定時，你會看到另外三個分頁： 使用者、 內容和 同步。

使用者

恆等映射

為確保權限執行正確，請將以下 GitLab 使用者身份之一映射至 Microsoft Entra ID。

  • Email：將 GitLab 使用者的電子郵件與 Microsoft Entra ID 電子郵件比對。 (預設與推薦映射)
  • 使用者名稱：將 GitLab 使用者名稱與 UPN) (Microsoft Entra ID 主體名稱匹配。
  • 名稱：Maps GitLab 使用者名稱搭配 Microsoft Entra ID 顯示名稱。

若直接映射失敗，則使用正則表達式 (正則表達式) 進行轉換。

內容

你可以在內容分頁驗證範例資料中的屬性映射，如標題、描述、狀態和時間戳記。

同步處理

你可以根據這裡的排程選項設定完整爬行和增量爬行。 預設情況下，增量爬行設定為每 15 分鐘一次，完整爬行則設定為每日一次。 如果需要，你可以調整這些排程以符合你的資料刷新需求。

後續步驟

有關故障排除資訊，請參閱 GitLab 故障排除指南。

如果你遇到問題或需要支援，請參考 Microsoft Graph 支援。

  • Last updated on