GitHub Cloud Issues Microsoft 365 Copilot 連接器讓您的組織能夠索引 GitHub 議題，使其能在 Microsoft 365 Copilot 和 Microsoft Search 體驗中被呈現。 本文提供你在部署或使用連接器時可能遇到的常見錯誤故障排除資訊。
要驗證 GitHub 設定資訊以協助排查錯誤，請參閱 「設定 GitHub 服務以擷取 GitHub Cloud Issues 連接器」。
GitHub Cloud Issues 連接器故障排除
下表列出常見錯誤及其解決步驟。
| 錯誤訊息或問題 | 可能原因 | 解決方案 |
|---|---|---|
| 認證失敗 | 設定時使用錯誤的客戶端 ID、客戶端秘密或私鑰。 | 確認 GitHub App 的憑證與你的 GitHub App 設定值相符。 必要時重新產生客戶端秘密。 |
| 不支援單點登入 | 嘗試在連接器設置時使用單一登入 (SSO) 來驗證。 | 用不需要 SSO 設定的 GitHub 帳號登入。 |
| 權限不足 | GitHub 應用程式沒有所需的權限。 | 請確保 GitHub 應用程式對管理、元資料、議題、成員和Email地址都有只讀權限。 |
| IP 限制後爬行失敗 | 防火牆規則會封鎖連接器的 IP 範圍。 | 把連接器的 IP 範圍加入你的允許清單。 詳情請參見 防火牆設定。 |
| 恆等映射錯誤 | GitHub 的使用者身份與 Microsoft Entra ID 屬性不符。 | 使用電子郵件、登入或姓名設定身份映射。 如果直接映射失敗，請使用正則表達式轉換。 |
| 速率超過上限 | 同一個 GitHub 帳號請求太多。 | 使用不同的使用者帳號來進行 OAuth 認證，以分散 API 呼叫。 |