本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 對 OneDrive 資料來源進行故障診斷
<a name="kb-managed-ds-onedrive-troubleshooting"></a>

使用此頁面來診斷 OneDrive 身分驗證、資料來源建立和同步的常見問題。如需文件層級存取控制的特定問題，請參閱 中的故障診斷表[文件層級存取控制](kb-managed-ds-onedrive-acl.md)。

## 資料來源建立和連線錯誤
<a name="kb-managed-ds-onedrive-troubleshooting-create"></a>


**建立和連線錯誤**  

| 徵狀 | 可能原因 | 修正 | 
| --- | --- | --- | 
| 資料來源無法建立 ，且錯誤certificateS3Path不得為 null。 | aclEnabled 為 ，true但未提供憑證路徑。文件層級存取控制需要憑證。 | certificateS3Path 新增至 connectionConfiguration，指向 Amazon S3 中的.p12憑證。請參閱 [設定 OneDrive 的 Microsoft Entra App ID 身分驗證](kb-managed-onedrive-entra-setup.md)。 | 
| 租用戶 ID 無效。 | 租用戶 ID 格式錯誤或不符合您的 Microsoft Entra 租用戶。 | 從 Microsoft Entra 管理中心的應用程式概觀頁面複製目錄 （租戶） ID。 | 
| 無效的用戶端 ID，或找不到應用程式。 | 秘密clientId中的 不正確，或應用程式註冊不存在。 | 從應用程式概觀頁面複製應用程式 （用戶端） ID，並更新秘密。 | 
| 無法連線至 OneDrive。 | 一或多個登入資料不正確，或應用程式缺少必要的許可或管理員同意。 | 驗證秘密值、確認應用程式許可，並授予管理員同意。請參閱 [設定 OneDrive 的 Microsoft Entra App ID 身分驗證](kb-managed-onedrive-entra-setup.md)。 | 
| 知識庫服務角色無法讀取憑證。 | 憑證物件s3:GetObject上缺少服務角色，或使用角色無法使用的客戶受管金鑰來加密物件。 | s3:GetObject 授予憑證，如果物件使用客戶受管 KMS 金鑰，kms:Decrypt則授予該金鑰。請參閱 [步驟 8 （僅限 ACLs)：授予憑證的服務角色存取權](kb-managed-onedrive-entra-setup.md#kb-managed-onedrive-entra-step8)。 | 

## 憑證錯誤 （文件層級存取控制）
<a name="kb-managed-ds-onedrive-troubleshooting-cert"></a>


**憑證錯誤**  

| 徵狀 | 可能原因 | 修正 | 
| --- | --- | --- | 
| 即時存取驗證期間的憑證密碼或權杖思維錯誤。 | .p12 密碼與秘密certificatePassword中的 不相符。 | 將 certificatePassword設定為用來建立.p12檔案的密碼，或使用已知密碼重新建立套件。 | 
| 存取驗證在之前有效，現在所有查詢都會傳回零結果。 | 憑證已過期，或管理員同意已撤銷。 | 產生新憑證、將公有憑證上傳到 Entra 應用程式註冊、取代 Amazon S3 .p12中的 ，以及重新授予管理員同意。請參閱 [輪換憑證](#kb-managed-ds-onedrive-rotate-cert)。 | 
| 憑證無法載入為 PKCS\#12 的錯誤 （例如，「無效的憑證格式」)。 | certificateS3Path 指向錯誤的物件 （例如 .cer/PEM 檔案），或秘密certificatePassword中的 與套件不相符。文件層級存取控制需要 .p12 格式。 | 確認 certificateS3Path 指向您的.p12套件，且certificatePassword符合該套件。 | 

## 輪換憑證
<a name="kb-managed-ds-onedrive-rotate-cert"></a>

如果您使用文件層級存取控制，請在憑證過期之前輪換憑證。過期的憑證會導致即時存取驗證失敗，因此查詢會傳回零結果。若要在不中斷存取的情況下進行輪換，請將新憑證上傳為單獨的物件，並將資料來源切換至該物件，以便現有憑證在您切換之前繼續運作。

1. 產生新的憑證和 PKCS\#12 (`.p12`) 套件，如中所述[設定 OneDrive 的 Microsoft Entra App ID 身分驗證](kb-managed-onedrive-entra-setup.md)。

1. 在您的 Entra 應用程式註冊中，在**憑證和秘密**下，上傳新的公有憑證。保留現有的憑證 — 應用程式註冊可以保留多個憑證。

1. 在新的**物件金鑰**下將新的`.p12`套件上傳至 Amazon S3 （請勿覆寫現有的憑證物件）。確認您的知識庫服務角色可以讀取新物件。

1. 更新資料來源，讓 `certificateS3Path`指向新物件，並更新 AWS Secrets Manager 秘密`certificatePassword`中的 以符合新套件。使用 [UpdateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) 操作或 AWS 管理主控台。

1. 確認具有授權使用者的擷取會傳回結果，顯示新憑證可用於即時驗證。

1. 確認新憑證正常運作後，請從 Entra 應用程式註冊中移除舊憑證，並從 Amazon S3 刪除舊`.p12`物件。

## OAuth 2.0 身分驗證錯誤
<a name="kb-managed-ds-onedrive-troubleshooting-oauth2"></a>


**OAuth 2.0 錯誤**  

| 徵狀 | 可能原因 | 修正 | 
| --- | --- | --- | 
| 同步失敗，並顯示無法重新整理 OAuth 2.0 存取字符的訊息。 | 秘密缺少 refreshToken 欄位，或重新整理字符已過期或已撤銷。 | 確認秘密包含 clientId、 clientSecret和 refreshToken。如果字符已過期或已撤銷，請取得新的字符並更新秘密。請參閱 [步驟 4：取得重新整理權杖](kb-managed-onedrive-oauth2-setup.md#kb-managed-onedrive-oauth2-step4)。 | 
| 您想要編目與使用者或 OneNote 筆記本共用的檔案，但不編製索引。 | 資料來源使用 Microsoft Entra App ID （僅限應用程式） 身分驗證，無法存取共用檔案或 OneNote 筆記本。 | 使用OAUTH2身分驗證並啟用對應的同步範圍。請參閱 [設定 OneDrive 的 OAuth 2.0 身分驗證](kb-managed-onedrive-oauth2-setup.md)。 | 

## 同步錯誤
<a name="kb-managed-ds-onedrive-troubleshooting-sync"></a>


**同步錯誤**  

| 徵狀 | 可能原因 | 修正 | 
| --- | --- | --- | 
| 同步完成，但沒有文件編製索引。 | 應用程式無法存取設定的使用者磁碟機，或包含或排除篩選條件會排除所有內容。 | 驗證應用程式許可和管理員同意，並檢閱您的使用者電子郵件和磁碟機項目篩選條件。 | 
| 特定使用者的內容不會編目。 | 篩選條件會排除使用者，或使用者沒有可存取的內容。 | 檢查 inclusionUserEmailAddresses 和 exclusionUserEmailAddresses 篩選條件，並確認使用者在其磁碟機中有內容。 | 

## 文件層級存取控制問題
<a name="kb-managed-ds-onedrive-troubleshooting-acl"></a>

ACL 設定錯誤不會在擷取期間產生明確的錯誤。相反地，查詢會傳回較少或零的結果。如需 ACL 特定症狀、驗證步驟和修正，請參閱 [文件層級存取控制](kb-managed-ds-onedrive-acl.md)。