Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Note
Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.
Verwenden Sie diesen Artikel, wenn abfragezeitbasierte Berechtigungsfilterung für indizierte SharePoint Inhalt fehlende oder unerwartete Ergebnisse zurückgibt oder eine berechtigungsfilterte Abfrage fehlschlägt.
Voraussetzungen
- Ein Index, der vom SharePoint in Microsoft 365 Indexer mit konfigurierter ACL-Aufnahme aufgefüllt wird.
- Abfragezeitberechtigungsfilterung konfiguriert, wie in der Abfragezeit-ACL- und RBAC-Erzwingung beschrieben.
- REST-API-Version
2026-10-01für SharePoint Berechtigungsfilterung. - Zugriff auf die Indexdefinition, den generierten oder expliziten Indexerstatus und die SharePoint Berechtigungen für einen Testbenutzer.
- Suchindexdatenmitwirkender oder gleichwertige Berechtigung zum Lesen mit erhöhten Rechten, wenn Sie gefilterte und ungefilterte Ergebnisse vergleichen müssen.
Befolgen Sie den Entscheidungsbaum zur Fehlerbehebung
Führen Sie diese Prüfungen in der reihenfolge aus. Beenden Sie, wenn das beobachtete Ergebnis die Konfiguration oder Berechtigung identifiziert, die Korrektur benötigt.
1. Bestätigen Sie, dass der Fehler zur Abfragezeit auftritt.
In diesem Artikel wird die Berechtigungsfilterung behandelt, nachdem SharePoint Inhalt und ACL-Metadaten indiziert wurden.
- Wenn bei der Erstellung der Datenquelle oder bei einer Indexerausführung
Invalid AAD tenantgemeldet wird, führen Sie die Mandantenbehebung für Microsoft Entra durch. - Wenn Sie
TenantId, die Authentifizierung oder die Verbindungszeichenfolge der Datenquelle korrigieren müssen, finden Sie weitere Informationen unter Konfigurieren des SharePoint-Indexers in Microsoft 365. - Wenn
UserIds,GroupIdsoderSharePointSiteUrlwährend der Indizierung fehlen, verwenden Sie die ACL ingestion troubleshooting table.
Fahren Sie hier nur fort, wenn indizierte Berechtigungsmetadaten vorhanden sind und das Symptom auftritt, wenn Sie sie abfragen.
2. Identifizieren der drei Identitäten
Notieren Sie, welche Identität jede Rolle ausfüllt. Ersetzen Sie keinen Bezeichner für einen anderen.
| Identity | Purpose | Wo sie überprüft werden soll |
|---|---|---|
| Benutzerabfrage | Das delegierte Benutzertoken in x-ms-query-source-authorization bestimmt, welche geschützten Dokumente der Benutzer abrufen kann. |
Ihr Anwendungsauthentifizierungsfluss und die Abfrageanforderung. |
| SharePoint-Connector-App-Registrierung | Das sharePointConnectorAppRegistration auf dem Index ermöglicht Foundry IQ (Azure KI-Suche), die SharePoint-Websitegruppenmitgliedschaften des abfragenden Benutzers aufzulösen. |
Die Indexdefinition und die App-Registrierung, die in Unterstützung für SharePoint-Gruppen konfigurieren beschrieben sind. |
| Foundry IQ Anforderungsidentität | Das Microsoft Entra Bearer-Token im Authorization-Header oder der API-Schlüssel im api-key-Header authentifiziert die Anforderung gegenüber dem Foundry IQ-Dienst. Die Identität muss berechtigt sein, den Index abzufragen. |
Ihr Abfrageclient und die Foundry IQ-Datenebenen-Rollenzuweisung. |
3. Überprüfen der Berechtigungsfilterkonfiguration
Vergleichen Sie den Index, den Indexer und die generierten Objekte mit ihren Besitzerartikeln.
- Vergewissern Sie sich, dass der Index
permissionFilterOptionaufenabledgesetzt ist. - Bestätigen Sie, dass
UserIdsundGroupIdsdie korrektenpermissionFilter-Werte haben. - Bestätigen Sie für SharePoint-Websitegruppen, dass der Index
sharePointConnectorAppRegistrationund einSharePointSiteUrl-Feld mitsharepointSiteUrl: trueenthält. - Bestätigen Sie, dass jedes indizierte Dokument oder jeder Abschnitt die entsprechenden Berechtigungsfelder enthält. Wenn das Skillset Indexprojektionen verwendet, überprüfen Sie, ob sich die ACL-Felder in
indexProjections.selectors[].mappingsbefinden. - Vergewissern Sie sich, dass der Index über das erforderliche
metadata_spo_item_pathFeld verfügt und dass projizierte Blöcke den Quellpfad beibehalten. Eine Objekt-/Element-ID oder Website-URL ersetzt es nicht.
Wenn ein Wert fehlt, kehren Sie zu Konfigurieren Ihres Foundry IQ-Diensts für die ACL-Erfassung und Durchsetzung zur Abfragezeit zurück.
Bei Metadaten- und Lebenszyklussymptomen können Sie die Überprüfung auf das betroffene Quellelement und die indizierten Dokumente oder Blöcke einschränken.
| Symptom | Gezielte Prüfung und nächster Schritt |
|---|---|
| Der Quellpfad fehlt oder stimmt nicht mit dem Element überein. | Vergleichen sie metadata_spo_item_path mit den Quellmetadaten. Überprüfen Sie das erforderliche benannte Feld und die /document/metadata_spo_item_path-Projektion jedes einzelnen Blocks. Ein Elementschlüssel, eine Web-URL oder eine Website-URL ist kein Ersatz. Korrigieren Sie die Zuordnung, und verarbeiten Sie die betroffenen Elemente erneut. |
| Nativer Zugriff auf Website-Gruppen unterscheidet sich je nach Standort | Vergleichen Sie die einzelnen Elemente metadata_spo_site_url mit dem markierten sharepointSiteUrl: trueFeld. Überprüfen Sie, ob Projektionen die ursprüngliche Site anstelle einer konstanten Site-URL beibehalten. Überprüfen Sie für jede Website die Connector-Einwilligung und die Berechtigungen für ausgewählte Websites. |
| Listenelemente, Seitenelemente oder gemischte Elemente fehlen oder haben unerwartete Schlüssel. | Überprüfen Sie für direkt konfigurierte Indexer unter Verwendung von allSiteLists, allSitePages oder allSiteContent die metadata_spo_site_asset_item_id Schlüsselzuordnung und -Codierung. Verwenden Sie die Schlüsselanweisungen des Connectors, nicht einen Pfad oder eine Website-URL als Ersatz. |
| Ein übergeordnetes Element sieht korrekt aus, aber Blöcke unterscheiden sich | Überprüfen Sie die Projektionen des generierten oder expliziten Skillsets und die tatsächlichen untergeordneten Datensätze. Überprüfen Sie Inhalt, Quellpfad, ACLs und den entsprechenden Websitekontext für jeden Abschnitt. Fügen Sie keine manuellen Zuordnungen für projektionsgenerierte Schlüssel oder übergeordnete ID hinzu. |
| Alte Datensätze bleiben nach aktualisierung, verschieben, umbenennen oder löschen | Überprüfen Sie Quellauswahlpfade, Indexerwarnungen und -fehler sowie aktuelle und frühere Dokument- und Chunk-Schlüssel. Unterscheiden Sie Berechtigungsaktualisierung von der Inhalts- und Lebenszyklusverarbeitung; überprüfen Sie veraltete Datensätze separat. |
Verwenden Sie die Indexerdiagnose für fehlende, null, falsch formatierte oder nicht aufgelöste Pfade; führen Sie keinen bestimmten Fehler oder ein Autorisierungsergebnis aus dem Feldwert allein ab. Führen Sie für eine indizierte Wissensquelle auch die generierten Ressourcenüberprüfungen aus.
4. Sicheres Überprüfen des Abfragetokens
Protokollieren Sie kein vollständiges Zugriffstoken, fügen Sie kein vollständiges Zugriffstoken nicht in eine Supportanfrage ein, oder teilen Sie kein vollständiges Zugriffstoken. Decodieren Sie nur die Token-Nutzlast lokal, und bereinigen Sie Bezeichner, bevor Sie die Diagnoseausgabe erfassen.
- Bestätigen Sie, dass die Anforderung ein aktuelles delegiertes Token für den Testbenutzer enthält
x-ms-query-source-authorization. - Dekodieren Sie die Nutzlast lokal und bestätigen Sie, dass
oidden beabsichtigten Testbenutzer identifiziert. Notieren Sie einen bereinigten Wert wie<test-user-object-id>. - Authentifizieren Sie den Benutzer erneut, und wiederholen Sie den Vorgang, wenn das Token fehlt oder abgelaufen ist.
Wenn das Benutzertoken nicht angegeben wird, werden berechtigungsgeschützte Inhalte nicht zurückgegeben. Die Authorization Kopfzeile allein ersetzt x-ms-query-source-authorizationnicht.
5. Überprüfen Sie die Microsoft Entra-Berechtigungen
- Bestätigen Sie, dass das indexierte
UserIdsoderGroupIdsdie erwartete Microsoft Entra-Objekt-ID enthält. Verwenden Sie eine Abfrage mit erhöhten Leseberechtigungen nur für diesen Diagnosevergleich. - Vergewissern Sie sich, dass der Testbenutzer über eine direkte Zuweisung verfügt oder die zugewiesene Gruppe innerhalb der unterstützten fünf geschachtelten Ebenen erreicht.
- Wenn die Microsoft Entra Gruppe in einer SharePoint-Gruppe geschachtelt ist, überprüfen Sie die Schachtelungstiefe und die Konfiguration der SharePoint-Gruppe. Ein Pfad, der tiefer als fünf Ebenen ist, gewährt keinen Zugriff über diesen Pfad; eine separate unterstützte Berechtigung kann weiterhin angewendet werden.
Die genaue Unterstützungsgrenze finden Sie unter "Unterstützte Gruppenbeziehungen".
6. Überprüfen SharePoint Websitegruppenberechtigungen
Führen Sie diesen Schritt aus, wenn die ACL des Dokuments auf einer SharePoint-Websitegruppe vom Typ Owners, Members, Visitors oder einer benutzerdefinierten Gruppe basiert.
- Verwenden Sie eine Abfrage mit erweiterten Leseberechtigungen, um zu bestätigen, dass
GroupIdsdie erwartete, mitspg:präfixierte Gruppen-ID enthält undSharePointSiteUrldie Quellsite identifiziert. - Vergewissern Sie sich, dass der Testbenutzer ein direktes Mitglied dieser SharePoint-Gruppe ist oder diese über einen unterstützten Microsoft Entra-Gruppenschachtelungspfad erreicht.
- Vergewissern Sie sich, dass der Index
sharePointConnectorAppRegistrationdie von SharePoint Gruppen unterstützten Bezeichner und Berechtigungen verwendet.
Wenn die indizierten Felder leer oder veraltet sind, korrigieren Sie die Aufnahme oder synchronisieren Sie die SharePoint Berechtigungen, bevor Sie die Abfrage erneut testen.
Überprüfen Sie bei fehlenden geschachtelten Gruppenergebnissen auch das Limit von 10.000 Sicherheitsprinzipalen auf Websiteebene. Sie unterscheidet sich von der Schachtelungstiefe und der Gruppenanzahl des Testbenutzers. Durch die erneute Indizierung allein wird dieses Problem mit dem Abfragezeitschwellenwert nicht behoben.
Die Mitgliedschaftsergebnisse werden zwischengespeichert, sodass eine Änderung an der Sitegruppenkonfiguration in der nächsten Abfrage möglicherweise nicht angezeigt wird. Vergleichen Sie eine unterstützte direkte Zuordnung mit dem geschachtelten Gruppenpfad, um das Problem zu isolieren. Wenn es weiterhin besteht, sammeln Sie die Details zur Anforderungskorrelation für den Support, anstatt wiederholt neu zu indizieren. Lassen Sie die Berechtigungsfilterung aktiviert, während Sie untersuchen.
7. Überprüfen der Abfrageanforderung
- Verwenden Sie die REST-API-Version
2026-10-01für SharePoint Berechtigungsfilter. - Bestätigen Sie, dass
Authorizationeinen Prinzipal authentifiziert, der den Index abfragen kann. - Stellen Sie sicher, dass
x-ms-query-source-authorizationdas delegierte Token des Testbenutzers enthält. - Wiederholen Sie dieselbe Abfrage ohne nicht verknüpfte Filter oder Bewertungsänderungen, damit Sie das Berechtigungsverhalten isolieren können.
Verwenden Sie das allgemeine Abfragebeispiel als Vorlage für die Anfrageform. Nehmen Sie keine vollständigen Tokens in gespeicherte Anfragen oder Protokolle auf.
Wenn die Autorisierung nicht ausgewertet werden kann, behandeln Sie den Fehler, ohne geschützte Inhalte zurückzugeben oder erneut mit erhöhtem oder ungefiltertem Zugriff zu versuchen. Siehe Behandeln von Autorisierungs- und Aktualisierungsfehlern für Anwendungs- und Pushpipeline-Verantwortlichkeiten.
8. Vergleich der erwarteten und tatsächlichen Ergebnisse
- Wählen Sie ein Dokument aus, auf das der Testbenutzer zugreifen kann, und ein Dokument, auf das der Benutzer in SharePoint nicht zugreifen kann.
- Führen Sie die nach Berechtigungen gefilterte Abfrage als Testbenutzer aus und notieren Sie nur Dokumentschlüssel oder andere nicht vertrauliche Bezeichner.
- Führen Sie eine Abfrage mit erhöhten Leseberechtigungen aus, und vergleichen Sie die gespeicherten
UserIdsWerteGroupIdsundSharePointSiteUrlWerte mit den Quellberechtigungen. - Wenn das erwartete Dokument mit erhöhten Rechten zurückgegeben wird, die Benutzerabfrage dies jedoch nicht tut, überprüfen Sie das Benutzertoken, gespeicherte ACL-Werte und Aktualität sowie die Gruppenauflösung. Wenn der Lesevorgang mit erhöhten Rechten es ebenfalls nicht findet, überprüfen Sie die Aufnahme von Inhalten, die Quellauswahl und die indizierten Schlüssel.
Vergleichen Sie unterstützte explizite Benutzer- und Gruppenzuweisungen, einschließlich geerbter Zuweisungen, anstatt organisationsweiter Freigabelinks. Organisationsweite Links und Ablauferzwingung für Freigabelinks werden nicht unterstützt. Durch das Ablaufen eines Links wird keine unabhängige explizite Erteilung widerrufen. Das Öffnen einer Datei in SharePoint ist eine separate Zugriffsprüfung, getrennt vom Abrufen ihres indizierten Inhalts.
Überprüfen Sie nach einer Änderung der Quellberechtigung die Synchronisierungsszenariotabelle und den Indexerausführungsstatus. Eine Abfrage startet den Indexer nicht, und ein angeforderter Lauf zeigt nicht an, dass die ACL-Verarbeitung abgeschlossen ist.
- Überprüfen Sie in SharePoint, ob das betroffene Element Berechtigungen erbt oder über eindeutige Berechtigungen verfügt. Beispielsweise folgt eine Datei, die die Berechtigungen eines Ordners erbt, den Zuweisungen dieses Ordners; eine Datei mit eindeutigen Berechtigungen behält ihre eigenen Zuweisungen bei.
- Vergewissern Sie sich, dass die relevante Indexerausführung abgeschlossen ist, und vergleichen Sie dann die indizierten ACLs mit den Quellzuweisungen des Elements. Bei segmentierten Inhalten überprüfen Sie auch die betroffenen Chunks.
- Folgen Sie der Szenariotabelle, um die normale inkrementelle Verarbeitung, die erneute Synchronisierung von Berechtigungen oder die Neuverarbeitung von Quellelementen auszuwählen. Wenn sich die Ergebnisse weiterhin unterscheiden, erfassen Sie die Details zur Anforderungskorrelation.
Der Lesezugriff mit erhöhten Rechten erfolgt zu Untersuchungszwecken. Verwenden Sie sie nicht, um uneingeschränkte Ergebnisse an Endbenutzer zurückzugeben.
9. Erfassen von Anforderungskorrelationsdetails
Wenn die Abfrage immer noch fehlschlägt, erfassen Sie die API-Version, den UTC-Zeitstempel, den sanitisierten Anforderungstext, den HTTP-Status, Antwortheader und alle vom Dienst zurückgegebenen Anforderungs- oder Korrelations-ID. Fügen Sie den Indexnamen ein, und geben Sie an, ob dasselbe Dokument unter Lesezugriff mit erhöhten Rechten angezeigt wird.
Entfernen Sie Zugriffstoken, API-Schlüssel, geheime Schlüssel, Benutzernamen und mandantenspezifische URLs, bevor Sie die Diagnose für Microsoft-Support freigeben.