翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# SharePoint データソースのトラブルシューティング
<a name="kb-managed-ds-sharepoint-troubleshooting"></a>

このページを使用して、SharePoint 認証、データソースの作成、同期に関する一般的な問題を診断します。ドキュメントレベルのアクセスコントロールに固有の問題については、「」のトラブルシューティング表を参照してください[ドキュメントレベルのアクセスコントロール](kb-managed-ds-sharepoint-acl.md)。

## データソースの作成と接続エラー
<a name="kb-managed-ds-sharepoint-troubleshooting-create"></a>


**作成および接続エラー**  

| 症状 | 考えられる原因 | Fix | 
| --- | --- | --- | 
| データソースはすぐに失敗し、null にconnectionConfiguration.certificateS3Pathすることはできません。 | authType は ENTRA\_ID\_APP\_ONLYですが、証明書パスが指定されていません。この認証タイプには、ACLs が無効になっている場合でも、常に証明書が必要です。 | Amazon S3 の.p12証明書connectionConfigurationを指す certificateS3Pathに を追加します。「[SharePoint の Microsoft Entra ID アプリ専用認証を設定する](kb-managed-sharepoint-entra-setup.md)」を参照してください。 | 
| 無効なテナント ID。 | テナント ID の形式が正しくないか、Microsoft Entra テナントと一致しません。 | Microsoft Entra 管理センターのアプリケーションの概要ページからディレクトリ (テナント) ID をコピーします。 | 
| 無効なクライアント ID、またはアプリケーションが見つかりません。 | シークレットclientIdの が正しくないか、アプリ登録が存在しません。 | アプリケーション概要ページからアプリケーション (クライアント) ID をコピーし、シークレットを更新します。 | 
| SharePoint に接続できません。 | 1 つ以上の認証情報が正しくないか、アプリケーションに必要なアクセス許可または管理者の同意がありません。 | シークレット値を確認し、アプリケーションのアクセス許可を確認し、管理者の同意を付与します。「[SharePoint の Microsoft Entra ID アプリ専用認証を設定する](kb-managed-sharepoint-entra-setup.md)」を参照してください。 | 
| ナレッジベースサービスロールは証明書を読み取ることができません。 | 証明書オブジェクトs3:GetObjectにサービスロールがないか、ロールが使用できないカスタマーマネージドキーで暗号化されています。 | 証明書s3:GetObjectに を付与し、オブジェクトがカスタマーマネージド KMS キーを使用している場合は、そのキーkms:Decryptに を付与します。「[ステップ 8: サービスロールに証明書へのアクセス権を付与する](kb-managed-sharepoint-entra-setup.md#kb-managed-sharepoint-entra-step8)」を参照してください。 | 

## 証明書エラー (Microsoft Entra ID アプリのみ)
<a name="kb-managed-ds-sharepoint-troubleshooting-cert"></a>


**証明書エラー**  

| 症状 | 考えられる原因 | Fix | 
| --- | --- | --- | 
| 同期中の証明書パスワードまたはトークンマイニングエラー。 | .p12 パスワードがシークレットcertificatePasswordの と一致しません。 | .p12 ファイルの作成に使用するパスワードcertificatePasswordに設定するか、既知のパスワードでバンドルを再作成します。 | 
| すべての同期が失敗する前と現在、認証は機能していました。 | 証明書の有効期限が切れているか、管理者の同意が取り消されました。 | 新しい証明書を生成し、Entra アプリ登録にパブリック証明書をアップロードし、Amazon S3 .p12の を置き換え、管理者の同意を再付与します。 | 
| 同期は失敗し、証明書を X.509 または PKCS\#12 としてロードできなかったというエラー (たとえば、「無効な証明書形式 — X.509 または PKCS12 としてロードできませんでした」) が発生します。 | Amazon Bedrock は、提供された認証情報を使用して Amazon S3 の証明書を読み取ることができませんでした。一般的な理由には、シークレットcertificatePasswordの欠落または空白、間違ったオブジェクト (.cer/PEM ファイルや残りのオブジェクトなど) certificateS3Pathを指す 、シークレットと一致しなくなった証明書などがあります。これは、データソースを再設定するか、認証方法を切り替えた後に発生する可能性が高くなります。 | データソースによって参照されるシークレットに、.p12バンドルcertificatePasswordに一致する が含まれ、その が をcertificateS3Path指していることを確認します.p12。データソースを再設定した場合は、証明書とシークレットがまだ対応していることを確認してから、再度同期します。 | 

## 証明書をローテーションする
<a name="kb-managed-ds-sharepoint-rotate-cert"></a>

有効期限が切れる前に証明書をローテーションします。証明書の有効期限が切れると、すべての同期が失敗します。アクセスを中断せずにローテーションするには、新しい証明書を別のオブジェクトとしてアップロードし、データソースを切り替えて、カットオーバーするまで既存の証明書が動作し続けます。

1. 「」の説明に従って、新しい証明書と PKCS\#12 (`.p12`) バンドルを生成します[SharePoint の Microsoft Entra ID アプリ専用認証を設定する](kb-managed-sharepoint-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-sharepoint-troubleshooting-oauth2"></a>


**OAuth 2.0 エラー**  

| 症状 | 考えられる原因 | Fix | 
| --- | --- | --- | 
| 同期が失敗し、REST API トークンリクエストがステータス 400 で失敗したというメッセージが表示されます。 | アカウントには、リソース所有者パスワード認証情報フローが満たすことができない MFA または条件付きアクセスが必要です。または、シークレットに userName または passwordフィールドがありません。 | シークレットに clientId、clientSecret、userName、 が含まれていることを確認しますpassword。アカウントが MFA または条件付きアクセスを強制する場合は、 に切り替えます[SharePoint の Microsoft Entra ID アプリ専用認証を設定する](kb-managed-sharepoint-entra-setup.md)。 | 
| アカウントのパスワードが変更されると、同期は失敗します。 | 保存されたパスワードは無効になりました。 | シークレットの passwordフィールドを更新します。 | 

## 同期エラー
<a name="kb-managed-ds-sharepoint-troubleshooting-sync"></a>


**同期エラー**  

| 症状 | 考えられる原因 | Fix | 
| --- | --- | --- | 
| 同期は完了しますが、インデックスが作成されたドキュメントはありません。 | アプリケーションは設定されたサイトにアクセスできません。ではSites.Selected、サイトごとのアクセス許可が付与されない場合があります。 | アプリケーションのアクセス許可と管理者の同意を確認します。を使用する場合はSites.Selected、各サイトのサイトごとの許可を確認します。「[ステップ 5 (Sites.Selected のみ): サイトごとのアクセス許可を付与する](kb-managed-sharepoint-entra-setup.md#kb-managed-sharepoint-entra-step5)」を参照してください。 | 
| 新しく追加されたサイトはクロールされません (Sites.Selected)。 | サイトごとの権限は遡及的ではないため、新しいサイトには権限はありません。 | コネクタアプリケーションに新しいサイトへのアクセスを許可し、再度同期します。 | 
| 特定のパスは結果を返しません。 | パスがブラウザ URL として入力されたか、項目が SharePoint で移動または名前が変更されました。 | (ブラウザ URL ではなく) SharePoint パスを使用し、そのパスに項目がまだ存在することを確認します。 | 

## ドキュメントレベルのアクセスコントロールの問題
<a name="kb-managed-ds-sharepoint-troubleshooting-acl"></a>

ACL の設定ミスは、取得中に明示的なエラーを生成しません。代わりに、クエリはより少ないまたはゼロの結果を返します。ACL 固有の症状、検証手順、および修正については、「」を参照してください[ドキュメントレベルのアクセスコントロール](kb-managed-ds-sharepoint-acl.md)。