View a markdown version of this page

Problembehandlung bei einer SharePoint Datenquelle - Amazon Bedrock
Fehler bei der Erstellung der Datenquelle und beim VerbindungsaufbauZertifikatsfehler (Microsoft Entra ID App-Only)Das Zertifikat rotierenFehler bei der OAuth 2.0-AuthentifizierungFehler beim SynchronisierenDocument-level Probleme mit der Zugriffskontrolle

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Problembehandlung bei einer SharePoint Datenquelle

Verwenden Sie diese Seite, um häufig auftretende Probleme bei der SharePoint Authentifizierung, Datenquellenerstellung und Synchronisierung zu diagnostizieren. Informationen zu Problemen, die sich speziell auf die Zugriffskontrolle auf Dokumentebene beziehen, finden Sie in der Tabelle zur Problembehandlung unter. Document-level Zugriffskontrollen

Fehler bei der Erstellung der Datenquelle und beim Verbindungsaufbau

Erstellungs- und Verbindungsfehler
Symptom Wahrscheinliche Ursache Reparieren
Die Datenquelle schlägt sofort mit einem Fehler fehl, der nicht Null sein connectionConfiguration.certificateS3Path darf. Der Pfad authType ist ENTRA_ID_APP_ONLY aber kein Zertifikat wurde angegeben. Für diesen Authentifizierungstyp ist immer ein Zertifikat erforderlich, auch wenn ACLs deaktiviert sind. Fügen Sie certificateS3Path connectionConfiguration hinzu und verweisen Sie auf Ihr .p12 Zertifikat in Amazon S3. Siehe Richten Sie die Microsoft Entra App-Only ID-Authentifizierung ein für SharePoint.
Ungültige Mandanten-ID. Die Mandanten-ID ist falsch formatiert oder stimmt nicht mit Ihrem Microsoft Entra-Mandanten überein. Kopieren Sie die Verzeichnis-ID (Mandanten-ID) von der Anwendungsübersichtsseite im Microsoft Entra Admin Center.
Ungültige Client-ID, oder die Anwendung kann nicht gefunden werden. Das clientId in the Secret ist falsch, oder die App-Registrierung ist nicht vorhanden. Kopieren Sie die Anwendungs-ID (Client) von der Seite mit der Anwendungsübersicht und aktualisieren Sie den geheimen Schlüssel.
Verbindung zu SharePoint kann nicht hergestellt werden. Eine oder mehrere Anmeldeinformationen sind falsch, oder der Anwendung fehlen die erforderlichen Berechtigungen oder die Zustimmung des Administrators. Überprüfen Sie die geheimen Werte, bestätigen Sie die Anwendungsberechtigungen und erteilen Sie die Zustimmung des Administrators. Siehe Richten Sie die Microsoft Entra App-Only ID-Authentifizierung ein für SharePoint.
Die Knowledgebase-Dienstrolle kann das Zertifikat nicht lesen. Die Servicerolle fehlt s3:GetObject im Zertifikatsobjekt, oder das Objekt ist mit einem vom Kunden verwalteten Schlüssel verschlüsselt, den die Rolle nicht verwenden kann. Gewähren s3:GetObject Sie für das Zertifikat, und wenn das Objekt einen vom Kunden verwalteten KMS-Schlüssel verwendet, gewähren kms:Decrypt Sie für diesen Schlüssel. Siehe Schritt 8: Gewähren Sie der Servicerolle Zugriff auf das Zertifikat.

Zertifikatsfehler (Microsoft Entra ID App-Only)

Fehler im Zertifikat
Symptom Wahrscheinliche Ursache Reparieren
Fehler bei der Zertifikatspasswort- oder Tokenprägung während der Synchronisierung. Das .p12 Passwort stimmt nicht mit dem im Secret überein. certificatePassword Geben certificatePassword Sie das Passwort ein, mit dem die .p12 Datei erstellt wurde, oder erstellen Sie das Paket mit einem bekannten Passwort neu.
Die Authentifizierung hat zuvor funktioniert und jetzt schlagen alle Synchronisierungen fehl. Das Zertifikat ist abgelaufen oder die Zustimmung des Administrators wurde widerrufen. Generieren Sie ein neues Zertifikat, laden Sie das öffentliche Zertifikat in die Entra-App-Registrierung hoch, ersetzen Sie es .p12 in Amazon S3 und erteilen Sie erneut die Zustimmung des Administrators.
Die Synchronisierung schlägt mit der Fehlermeldung fehl, dass das Zertifikat nicht als X.509 oder PKCS #12 geladen werden konnte (z. B. „Ungültiges Zertifikatsformat — Fehler beim Laden als X.509 oder PKCS12“). Amazon Bedrock konnte das Zertifikat in Amazon S3 mit den angegebenen Anmeldeinformationen nicht lesen. Zu den häufigsten Gründen gehören ein fehlendes oder leeres certificatePassword Geheimnis, ein Zertifikat, certificateS3Path das auf das falsche Objekt verweist (z. B. eine .cer /PEM-Datei oder ein übrig gebliebenes Objekt), oder ein Zertifikat, das dem Geheimnis nicht mehr entspricht. Dies ist wahrscheinlicher, nachdem eine Datenquelle neu konfiguriert oder die Authentifizierungsmethode gewechselt wurde. Vergewissern Sie sich, certificatePassword dass das Geheimnis, auf das die Datenquelle verweist, eine enthält, die Ihrem .p12 Paket entspricht, und das certificateS3Path darauf .p12 hinweist. Wenn Sie die Datenquelle neu konfiguriert haben, überprüfen Sie, ob das Zertifikat und der geheime Schlüssel immer noch übereinstimmen, und synchronisieren Sie dann erneut.

Das Zertifikat rotieren

Das Zertifikat rotieren, bevor es abläuft. Ein abgelaufenes Zertifikat führt dazu, dass alle Synchronisierungen fehlschlagen. Um das Zertifikat rotieren zu lassen, ohne den Zugriff zu unterbrechen, laden Sie das neue Zertifikat als separates Objekt hoch und stellen Sie die Datenquelle darauf um, sodass das vorhandene Zertifikat weiterhin funktioniert, bis Sie den Vorgang beenden.

  1. Generieren Sie ein neues Paket aus Zertifikat und PKCS #12 (.p12), wie unter beschrieben. Richten Sie die Microsoft Entra App-Only ID-Authentifizierung ein für SharePoint

  2. Laden Sie in Ihrer Entra-App-Registrierung unter Certificates & Secrets das neue öffentliche Zertifikat hoch. Behalten Sie das bestehende Zertifikat bei — eine App-Registrierung kann mehrere Zertifikate enthalten.

  3. Laden Sie das neue .p12 Paket unter einem neuen Objektschlüssel auf Amazon S3 hoch (überschreiben Sie nicht das vorhandene Zertifikatsobjekt). Vergewissern Sie sich, dass Ihre Wissensdatenbank-Servicerolle das neue Objekt lesen kann.

  4. Aktualisieren Sie die Datenquelle so, dass sie auf das neue Objekt certificateS3Path verweist, und aktualisieren Sie die Daten certificatePassword in Ihrem AWS Secrets Manager geheimen Ordner, sodass sie mit dem neuen Paket übereinstimmen. Verwenden Sie die UpdateDataSourceOperation oder die AWS-Managementkonsole.

  5. Starten Sie eine Synchronisierung und vergewissern Sie sich, dass sie mit dem neuen Zertifikat erfolgreich abgeschlossen wurde.

  6. Nachdem die Synchronisierung erfolgreich war, entfernen Sie das alte Zertifikat aus der Entra-App-Registrierung und löschen Sie das alte .p12 Objekt aus Amazon S3.

Fehler bei der OAuth 2.0-Authentifizierung

OAuth 2.0-Fehler
Symptom Wahrscheinliche Ursache Reparieren
Die Synchronisierung schlägt fehl und es wird die Meldung angezeigt, dass die REST-API-Token-Anfrage mit dem Status 400 fehlgeschlagen ist. Für das Konto ist MFA oder Conditional Access erforderlich, was der Fluss mit den Anmeldeinformationen für das Passwort des Ressourcenbesitzers nicht erfüllen kann, oder das geheime Feld fehlt. userName password Vergewissern Sie sich, dass das GeheimnisclientId,clientSecret, userName und enthält. password Wenn das Konto MFA oder Conditional Access erzwingt, wechseln Sie zu. Richten Sie die Microsoft Entra App-Only ID-Authentifizierung ein für SharePoint
Die Synchronisierung schlägt fehl, nachdem das Kontopasswort geändert wurde. Das gespeicherte Passwort ist nicht mehr gültig. Aktualisieren Sie das password Feld im Secret.

Fehler beim Synchronisieren

Fehler bei der Synchronisation
Symptom Wahrscheinliche Ursache Reparieren
Die Synchronisierung ist abgeschlossen, aber es werden keine Dokumente indexiert. Die Anwendung kann nicht auf die konfigurierten Websites zugreifen. MitSites.Selected, Berechtigungen pro Site werden möglicherweise nicht gewährt. Überprüfen Sie die Anwendungsberechtigungen und die Zustimmung des Administrators. Wenn Sie dies verwendenSites.Selected, bestätigen Sie für jede Site einen Zuschuss pro Site. Siehe Schritt 5 (Sites.Selected nur): Zugriff pro Site gewähren.
Eine neu hinzugefügte Site wird nicht gecrawlt ()Sites.Selected. Per-site Zuschüsse gelten nicht rückwirkend, sodass für die neue Website kein Zuschuss gewährt wird. Gewähren Sie der Connector-Anwendung Zugriff auf die neue Site und synchronisieren Sie sie dann erneut.
Bestimmte Pfade liefern keine Ergebnisse. Der Pfad wurde als Browser-URL eingegeben, oder das Element wurde verschoben oder umbenannt SharePoint. Verwenden Sie den SharePoint Pfad (nicht die Browser-URL) und überprüfen Sie, ob das Element unter diesem Pfad noch vorhanden ist.

Document-level Probleme mit der Zugriffskontrolle

ACL-Fehlkonfigurationen führen beim Abrufen nicht zu expliziten Fehlern. Stattdessen geben Abfragen weniger oder gar keine Ergebnisse zurück. Informationen zu ACL-specific Symptomen, Überprüfungsschritten und Problembehebungen finden Sie unterDocument-level Zugriffskontrollen.