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.
Hinweis
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.
Die Erfassung von SharePoint-Berechtigungsmetadaten verwendet einen Foundry IQ (Azure KI-Suche)-Indexer, um unterstützte Zugriffssteuerungslisten (ACLs) zusammen mit indizierten SharePoint-Inhalten zu speichern. Berechtigungsfilter zur Abfragezeit bewerten diese indizierten Metadaten und die Identität des Abfragebenutzers. Quellberechtigungsänderungen erreichen den Index über die Berechtigungssynchronisierung, nicht über Abfragen.
Wichtig
Die indizierte Berechtigungsfilterung ist keine Liveauswertung des vollständigen SharePoint Zugriffs- und Richtlinienmodells. Informationen zu quellseitigen Abrufen zur Anforderungszeit und kundenseitig verwalteten Erfassungsalternativen finden Sie unter Auswählen eines Abrufansatzes für Aktualität.
Voraussetzungen
Foundry IQ auf einer kostenpflichtigen Stufe (Basic oder höher) in jeder Region.
SharePoint in Microsoft 365 Websites, Bibliotheken, Ordnern und Dateien mit konfigurierten Berechtigungen.
Führen Sie alle Konfigurationsschritte in der Dokumentation SharePoint Indexer aus, und wenden Sie die in diesem Artikel beschriebenen ACL-spezifischen Anforderungen an.
Konfigurieren Sie Anwendungsberechtigungen für Microsoft Entra und eine für Ihr Szenario geeignete Anmeldeinformation. Siehe Berechtigungen nach ACL-Szenario. Für die ACL-Erfassung sind Anwendungsberechtigungen erforderlich. Delegierte Berechtigungen werden nicht unterstützt. Informationen zu Anwendungs- und delegierten Entscheidungen finden Sie unter Auswählen der Berechtigungskonfiguration.
Die Datenebenen-REST-API 2026-10-01 für die allgemein verfügbare SharePoint-Berechtigungskonfiguration in diesem Artikel.
Hinweis
Neusynchronisierung von Berechtigungen ist mit der REST-API 2026-10-01 allgemein verfügbar.
Reset-docs bleibt in der Vorschau und verwendet REST-API 2026-11-01-preview.
Einschränkungen
Verwenden Sie standardmäßige oder standardmäßige Dokumentanalyse (
parameters.configuration.parsingMode: "default") oder Inhaltsverständnis-basierte Extraktion, sofern unterstützt. Jeder generierte Block muss die erforderlichen Berechtigungsmetadaten und den Quellkontext beibehalten. Das System unterstützt keine speziellen vom Kunden ausgewählten Parsing-Modi. Informationen zu ausgeschlossenen Modi und Wissensquelleneinstellungen finden Sie unter Unterstütztes Parsing und Inhaltsextraktion für die Aufnahme von Berechtigungen.Mandanten mit aktivierter Microsoft Entra Conditional Access werden nicht unterstützt. Die Einschränkungen des SharePoint Indexers gelten auch für die ACL-Aufnahme.
Aktualisierungen von Berechtigungen hängen von Benachrichtigungen über Änderungen an der Quelle und von der erfolgreichen Verarbeitung durch den Indexer ab. Unterstützte Änderungen im Nicht-Stammordner der Dokumentbibliothek können während der normalen inkrementellen Verarbeitung unveränderte untergeordnete Elemente aktualisieren. Siehe Synchronisieren von Berechtigungen zwischen indizierten und Quellinhalten für den Bereich und die Aktualisierungsoptionen.
Dieses Feature wird vom Azure-Portal nicht unterstützt.
Die folgenden Features werden nicht unterstützt:
SharePoint Informationsverwaltungsrichtlinien, die für den Benutzerzugriff gelten. Das System wertet diese Richtlinien zur Abfragezeit nicht aus, nimmt sie auf oder berücksichtigt sie nicht.
Freigabefähige Links für "Jeder" oder "Personen in Ihrer Organisation" und Erzwingung des Ablaufs von Freigabelinks. Verwenden Sie unterstützte explizite Benutzer- oder Gruppenzuweisungen, einschließlich der unterstützten geerbten Zuordnungen. Der Ablauf eines Freigabelinks macht eine separate explizite Berechtigung nicht rückgängig.
Die geschachtelte Gruppenmitgliedschaft unterstützt bis zu fünf Ebenen. Ein separater Grenzwert auf Standortebene gilt, wenn mehr als 10.000 anwendbare Microsoft Entra Gruppenprinzipale eine geschachtelte Auflösung erfordern. Siehe Unterstützte Gruppenbeziehungen.
Die folgenden Features werden bei SharePoint ACL-Aufnahme nicht unterstützt:
Wissensspeicher, einschließlich des Ressourcenspeichers, der für die Bildbereitstellung (Vorschau) im agentischen Abruf erforderlich ist. Daher wird die Bereitstellung von Bildern für Wissensquellen, die SharePoint-ACLs übernehmen, nicht unterstützt.
Die Bereicherung von Chat Completion weist Endpunkt- und Berechtigungseinschränkungen auf, wenn die SharePoint ACL-Erfassung aktiviert ist.
Unterstützung für das SharePoint-Berechtigungsmodell
Die Erfassung von Berechtigungen unterstützt die folgende Teilmenge des SharePoint-Berechtigungsmodells für Dokumente, Listenelemente und moderne ASPX-Websiteseiten.
| SharePoint-Feature | Beschreibung | Unterstützt | Notizen |
|---|---|---|---|
| Vererbung von Websites, Bibliotheken, Listen und Seiten | Website-→ Bibliothek/Liste → Ordner → Datei/Element/Seite. | ✔️ | Bei der Erfassung bewertet; effektive ACLs, berechnet pro Element. |
| Eindeutige ACLs für Ordner, Datei, Listenelement und Seite | Zugriff auf Elementebene. | ✔️ | Enthalten, wenn bei der ersten Erfassung vorhanden und bei nachfolgenden Ausführungen, in denen ACL-Änderungen für Elemente mit eindeutigen Berechtigungen erkannt werden. |
| SharePoint-Listenelemente | Berechtigungen für Listenelemente (allSiteLists und allSiteContent Container). |
✔️ | Erfordert die berechtigungen, die im Szenario "Berechtigungen nach ACL" aufgeführt sind. |
| ASPX-Websiteseiten | Berechtigungen auf modernen Websiteseiten (allSitePages und allSiteContent Containern). |
✔️ | Erfordert die berechtigungen, die im Szenario "Berechtigungen nach ACL" aufgeführt sind. |
| Microsoft Entra -Gruppen (Microsoft 365 und Sicherheit) | Gruppenbasierter Zugriff. | ✔️ | Gruppen-IDs sind enthalten, sofern sie in einen Microsoft Entra-Bezeichner (ID) aufgelöst werden können. |
| SharePoint Websitegruppen | Besitzer/Mitglieder/Besucher und benutzerdefinierte Websitegruppen. | ✔️ | Erfordert die Konfiguration der SharePoint gruppen. Gruppen-IDs werden mit dem spg: Präfix ausgegeben. |
| Freigabefähige „Jeder-Links“ oder „Personen in Ihrer Organisation-Links" | Organisationsweiter oder öffentlicher Zugriff. | ❌ | Verwenden Sie stattdessen unterstützte explizite Benutzer-/Gruppenzuweisungen. |
| Erzwingung des Ablaufs für Freigabelinks | Änderungen beim Zugriff basieren auf dem Ablauf eines Links. | ❌ | Die erneute Synchronisierung von Berechtigungen aktiviert diese nicht unterstützte Funktion nicht. |
| Externe/Gastbenutzer | Zugriff für Gäste. | ❌ | Nicht unterstützt. |
| Informationsverwaltungsrichtlinien | Richtlinien zum Definieren bestimmter Berechtigungsanforderungen. | ❌ | Nicht unterstützt. |
| Purview-Empfindlichkeitsetiketten | Sicherheit auf Dokumentebene für Datenschutz, Kategorisierung, Berechtigungen und Verschlüsselung | ❌ | Wird über ein separates Feature unterstützt: Bewahren und Respektieren von Vertraulichkeitskennzeichnungen. |
Unterstützte Gruppenbeziehungen
Die unterstützte Gruppenauflösung umfasst Microsoft Entra Gruppen, die in SharePoint Websitegruppen geschachtelt sind, bis zu fünf geschachtelte Gruppenebenen.
| Berechtigungszuordnung | Unterstützt | Leitlinien |
|---|---|---|
| Benutzer oder Microsoft Entra Gruppe, die dem SharePoint Element direkt zugewiesen ist | Ja | Der Indexer speichert die Benutzer- oder Microsoft Entra Gruppenobjekt-ID in den Berechtigungsmetadaten des Elements. |
| Der Benutzer erreicht eine zugewiesene Microsoft Entra Gruppe über geschachtelte Microsoft Entra-Gruppen. | Ja, bis zu fünf Ebenen | Eine Mitgliedschaft, die über die unterstützte Verschachtelungstiefe hinausgeht, gewährt über diesen Pfad keinen Zugriff. |
| Benutzer, der direkt einer SharePoint-Websitegruppe zugewiesen wurde, die Zugriff auf das Element hat | Ja | Konfigurieren sie SharePoint Gruppenunterstützung. |
| Microsoft Entra-Gruppe, die in einer SharePoint-Gruppe geschachtelt ist | Ja, innerhalb von fünf Ebenen | Konfigurieren sie SharePoint Gruppenunterstützung. Das unten aufgeführte Sicherheitsprinzipallimit auf Websiteebene gilt ebenfalls. |
| Mitgliedschaftspfad, der mehr als fünf geschachtelte Gruppenebenen erfordert | No | Wenn dies der einzige Berechtigungspfad des Benutzers ist, wird der Zugriff verweigert. Eine separate unterstützte direkte oder innerhalb des zulässigen Limits liegende Berechtigung kann weiterhin Zugriff gewähren. |
Nehmen Sie beispielsweise eine SharePoint-Gruppe an, die Zugriff auf ein Element hat. Die Entra-Gruppe G1 ist Mitglied der SharePoint-Gruppe; G2 ist Mitglied von G1, und dies setzt sich bis G6 fort. Ein Benutzer, der direktes Mitglied von G1, G2, G3, G4 oder G5 ist, kann über den entsprechenden Pfad mit einer bis fünf Ebenen Zugriff erhalten. Die ausschließliche Mitgliedschaft in G6 gewährt keinen Zugriff über diese Kette. Eine separate direkte Zuweisung an den Benutzer wird unabhängig ausgewertet.
Wenn eine Website über mehr als 10.000 anwendbare Microsoft Entra Gruppenprinzipale für die geschachtelte Auflösung verfügt, werden diese geschachtelten Mitgliedschaften nicht aufgelöst. Separate unterstützte Berechtigungen, z. B. direkte Benutzerzuweisungen oder die direkte Mitgliedschaft in einer SharePoint-Gruppe, können weiterhin angewendet werden. Dieser Schwellenwert zählt die anwendbaren Entra-Websiteprinzipale, nicht die Gruppen des Benutzers, SharePoint-Gruppen, indizierte Websites oder Schachtelungstiefe. Genau 10.000 wird nicht allein durch diesen Schwellenwert ausgeschlossen. Fehlende Ergebnisse finden Sie unter Problembehandlung für die SharePoint-Berechtigungsfilterung.
Wie hierarchische Berechtigungen ausgewertet werden
SharePoint Berechtigungen folgen der Hierarchie von Website → Bibliothek oder Liste → Ordner → Datei, Element oder Seite, es sei denn, die Vererbung ist unterbrochen.
Während der Aufnahme sammelt der Indexer Benutzer- und Gruppenbezeichner und berechnet die effektive ACL für jedes Element.
Berechtigungen nach ACL-Szenario
Die für die ACL-Erfassung erforderlichen Microsoft Entra-Anwendungsberechtigungen und Anmeldeinformationstypen hängen davon ab, welche Element- und Gruppentypen Sie indizieren. In der App-Registrierung werden alle Berechtigungen unter API-Berechtigungen>Berechtigung hinzufügen hinzugefügt, und die Verbundanmeldeinformation wird unter Zertifikate & Geheimnisse>Verbundanmeldeinformationen hinzugefügt. Eine schrittweise Anleitung und Screenshots finden Sie unter Schritt 3: Microsoft Entra-Anwendungsregistrierung erstellen und Konfigurieren der registrierten Anwendung mit einer verwalteten Identität.
| Szenario | API-Berechtigungen hinzufügen | Credential |
|---|---|---|
| ACLs für Dokumentbibliotheksdateien, wenn der Zugriff nur über Microsoft Entra Benutzer und Standardgruppen gewährt wird (Microsoft Entra Sicherheitsgruppen, Microsoft 365 Gruppen, E-Mail-aktivierte Sicherheitsgruppen) |
Microsoft Graph: Files.Read.All, Sites.FullControl.All (oder Sites.Selected für den bereichsbezogenen Zugriff) |
Geheimer Clientschlüssel oder Verbundanmeldeinformationen |
| ACLs für Dateien in Dokumentbibliotheken, wenn auch SharePoint-Websitegruppen (Besitzer, Mitglieder, Besucher oder benutzerdefinierte Websitegruppen) berücksichtigt werden müssen |
Microsoft Graph: Files.Read.All, Sites.FullControl.All (oder Sites.Selected)SharePoint: Sites.FullControl.All (oderSites.Selected) |
Verbundanmeldeinformationen (erforderlich) |
| ACLs für SharePoint-Listenelemente |
Microsoft Graph: Files.Read.All, Sites.FullControl.All (oder Sites.Selected),User.Read.AllSharePoint: Sites.FullControl.All (oderSites.Selected) |
Verbundanmeldeinformationen (erforderlich) |
| Inhalt und ACLs auf ASPX-Websiteseiten |
Microsoft Graph: Sites.FullControl.All (oder Sites.Selected), User.Read.All (behalten Sie Files.Read.All aus den obigen Zeilen bei, wenn Sie auch Dokumentbibliotheken oder Listen indizieren)SharePoint: Sites.FullControl.All (oderSites.Selected) |
Verbundanmeldeinformationen (erforderlich) |
Abfragezeitauflösung von SharePoint-Websitegruppen über sharePointConnectorAppRegistration |
Fügen Sie SharePoint hinzu: User.Read.All zur gleichen App-Registrierung, die vom Indexer verwendet wird. |
Verbundanmeldeinformationen (erforderlich) |
Hinweis
Wenn Sie eine Berechtigung hinzufügen, wählen Sie zwischen zwei API-Oberflächen aus: Microsoft Graph und SharePoint. Beide machen ähnlich benannte Berechtigungen verfügbar. Beispielsweise existiert
Sites.FullControl.Allin beiden. Fügen Sie jede Berechtigung unter der in der Tabelle angegebenen API-Oberfläche hinzu.Verwenden Sie immer eine Verbundanmeldeinformation, wenn im Szenario SharePoint-API-Berechtigungen hinzugefügt werden. Clientgeheimnisse funktionieren nur für die Zeile „Dokumentbibliothek nur für Microsoft Graph“.
User.Read.Allist für Listenelemente und ASPX-Websiteseiten erforderlich, da der Indexer diese Berechtigungen über die SharePoint REST-API liest, die nur die E-Mail des Benutzers zurückgibt. Der Indexer ruft dann Microsoft Graph auf, um jede E-Mail-Adresse ihrer Microsoft Entra-Objekt-ID zuzuordnen, und für diese Abfrage istUser.Read.Allerforderlich.Wenn Sie
Sites.Selectedverwenden, gewähren Sie der App vor der Indizierung expliziten Zugriff auf jede SharePoint-Zielwebsite.
Verbundanmeldeinformationen ermöglichen der App die Authentifizierung mithilfe einer vertrauenswürdigen verwalteten Identität anstelle eines Clientschlüssels. Die gleichen Verbundanmeldeinformationen decken sowohl die Erfassung (Indexer) als auch die Abfragezeitbewertung von SharePoint-Websitegruppen ab. Schritte zum Einrichten finden Sie unter Konfigurieren der registrierten Anwendung mit einer verwalteten Identität.
Bevor Sie die ACL-Erfassung aktivieren
Führen Sie die folgenden Schritte für Ihre registrierte Microsoft Entra Anwendung aus:
- Identifizieren Sie Ihr Szenario in der vorherigen Tabelle basierend auf dem, was Sie indizieren möchten (Dokumentbibliotheksdateien, Listenelemente, ASPX-Websiteseiten), und ob SharePoint Websitegruppen berücksichtigt werden müssen.
- Öffnen Sie Ihre App-Registrierung im Microsoft Entra Admin Center und wechseln Sie zu API-Berechtigungen>Berechtigung hinzufügen.
- Fügen Sie die für Ihr Szenario aufgeführten Microsoft Graph Berechtigungen hinzu. Administratorzustimmung erteilen.
- Wenn Ihr Szenario auch SharePoint Berechtigungen erfordert, wählen Sie Eine Berechtigung hinzufügen erneut aus, wählen Sie die API SharePoint aus, und fügen Sie
Sites.FullControl.All(oderSites.Selected) hinzu. Administratorzustimmung erteilen. - Konfigurieren Sie die Anmeldedaten:
- Für szenarien mit nur Microsoft Graph können Sie entweder einen geheimen Clientschlüssel (
Certificates & secrets Client secrets ) oder Verbundanmeldeinformationen verwenden. - Fügen Sie für jedes Szenario, das SharePoint Berechtigungen enthält, unter
Certificates & secrets Federated credentials eine Verbundanmeldeinformationen hinzu. Siehe Konfigurieren der registrierten Anwendung mit einer verwalteten Identität.
- Für szenarien mit nur Microsoft Graph können Sie entweder einen geheimen Clientschlüssel (
- Gewähren Sie der Anwendung Zugriff auf die Zielwebsites SharePoint Websites (insbesondere, wenn Sie
Sites.Selectedfür den bereichsbezogenen Zugriff verwenden), damit sie die Inhalte und Berechtigungen lesen kann, die Sie indizieren möchten.
Suchen der richtigen Microsoft Entra-IDs
Jeder Bezeichner wird an einem anderen Ort im Azure Portal angezeigt und einem bestimmten Konfigurationsfeld zugeordnet. Verwenden Sie diesen Abschnitt als Referenz, wenn Sie SharePoint ACL-Erfassung mit Verbundanmeldeinformationen konfigurieren. Diese Bezeichner werden in Unterstützung für SharePoint-Gruppen konfigurieren und in der Verbindungszeichenfolge der Datenquelle verwendet.
| Kennung | Portalstandort | Verwendet, wo | Notizen |
|---|---|---|---|
| Anwendungs-ID der Erfassungs-App (Client) |
App-Registrierungen><your-app>>Overview |
ApplicationId in der Verbindungszeichenfolge der Datenquelle; applicationId in sharePointConnectorAppRegistration |
Diese ID ist für die meisten Konfigurationsfelder korrekt. Auch als "Client-ID" bezeichnet. |
| Anwendungsobjekt-ID |
App-Registrierungen><your-app>>Overview (unter Anwendungs-ID (Client-ID)) |
Wird in der Foundry IQ-Konfiguration nicht verwendet | Verwechseln Sie dies nicht mit der Anwendungs-ID (Client-ID). Wird direkt unterhalb der Client-ID im selben Blatt angezeigt. |
| Objekt-ID für Dienstprinzipal |
Microsoft Entra ID>Enterprise-Anwendungen><your-app>>Verwalten von>Eigenschaften |
Wird in der Foundry IQ-Konfiguration nicht verwendet | Dies ist die Dienstprinzipaldarstellung der App. Es ist eine andere GUID als die App-Registrierungsobjekt-ID. |
| Verwaltete Identitäts-Haupt-ID | verwaltete Identitätsressource > oder das Foundry IQ-Dienst Identity-Blatt | Nicht direkt in foundry IQ-Datenquelle oder Indexkonfiguration verwendet | Wird intern verwendet, wenn Sie die Verbundidentitätsanmeldeinformationen für die App-Registrierung einrichten. Die Anmeldeinformationen, die Sie erstellen, vertrauen dieser Identität. |
| Objekt-ID der Verbundanmeldeinformationen |
App-Registrierungen>><your-app>Verwalten>Zertifikate & Geheimnisse>Verbundene Anmeldeinformationen><credential-name> |
Wird in der Foundry IQ-Konfiguration nicht verwendet | Verwenden Sie nicht die GUID des Anmeldeinformationseintrags der Verbundidentität für federatedCredentialId. |
| Anwendungs-ID für Verbundanmeldeinformationen | Systemseitig zugewiesen: Microsoft Entra ID>Unternehmensanwendungen><search-service>>; Benutzerseitig zugewiesen: <managed-identity-resource>>Eigenschaften |
FederatedCredentialApplicationId in der Verbindungszeichenfolge der Datenquelle; federatedCredentialId in sharePointConnectorAppRegistration |
Weitere Informationen zum Suchen der verwalteten Identität finden Sie unter Anwendungs-ID der Verbundanmeldeinformationen. |
Anwendungs-ID für Verbundanmeldeinformationen
Verwenden Sie für FederatedCredentialApplicationId in der Verbindungszeichenfolge der Datenquelle und für federatedCredentialId in der Indexdefinition die eigene Anwendungs-ID (Client-ID) der verwalteten Identität, nicht die ID der Erfassungs-App.
Vom System zugewiesene verwaltete Identität:
- Wechseln Sie zu Ihrem Foundry IQ-Service.
- Wählen Sie "Sicherheit + Netzwerkidentität>" aus.
- Notieren Sie sich auf der Registerkarte Vom System zugewiesen die Objekt-ID (Prinzipal).
- Wechseln Sie zu Microsoft Entra ID>Manage>Enterprise-Anwendungen.
- Suchen Sie nach Ihrem Foundry IQ-Dienstnamen, oder fügen Sie die Objekt-ID (Prinzipal) in das Suchfeld ein.
- Wählen Sie das Ergebnis aus, und öffnen Sie "Eigenschaften". Kopieren Sie die hier gezeigte Anwendungs-ID , bei der es sich um den Wert
FederatedCredentialApplicationIdin der Datenquelle undfederatedCredentialIdim Index handelt.
Vom Benutzer zugewiesene verwaltete Identität:
- Wechseln Sie zur vom Benutzer zugewiesenen verwalteten Identitätsressource.
- Wählen Sie Einstellungen>Eigenschaften aus.
- Kopieren Sie die Client-ID, bei der es sich um den Wert
FederatedCredentialApplicationIdin der Datenquelle undfederatedCredentialIdim Index handelt.
Konfigurieren Sie Ihren Foundry IQ-Dienst für die ACL-Erfassung und Erzwingung zur Abfragezeit
Diese Schritte konfigurieren Ihren Foundry IQ-Dienst für die ACL-Aufnahme und aktivieren die ACL-Durchsetzung zur Abfragezeit.
Auswählen, wo ACL-Felder aufgefüllt werden sollen
Wo Sie die ACL-Metadatenfelder zuordnen, hängt davon ab, ob der Indexer ein Dokument pro Quellelement oder mehrere Blöcke pro Quellelement schreibt.
| Szenario | Auffüllen von ACL-Feldern über | Warum? |
|---|---|---|
| Kein Skillset oder Skillset ohne Segmentierung; ein Suchdokument pro Quellelement |
Nur Indexerfeldzuordnungen (metadata_user_ids → UserIds, metadata_group_ids → GroupIdsund für SharePoint Gruppen metadata_spo_site_url → SharePointSiteUrl). |
Der Indexer schreibt ein einzelnes Dokument in den Zielindex, und Feldzuordnungen ordnen Quellmetadaten den Indexfeldern zu. |
Skillset mit Segmentierung (z. B. Textaufteilungs-Skill für integrierte Vektorisierung), ein einzelner Index mit übergeordneten Feldern, die in jedem Segment wiederholt werden (projectionMode: skipIndexingParentDocuments) |
Indexprojektionen im Skillset (mappings von /document/metadata_user_ids, /document/metadata_group_idsund für SharePoint Gruppen /document/metadata_spo_site_url). |
Das übergeordnete Dokument ist nicht indexiert; nur Textsegmente sind es. ACL-Werte müssen auf jeden Block projiziert werden, sodass Abfragezeitfilter auf den in Ergebnissen zurückgegebenen Block angewendet werden. Indexerfeldzuordnungen für diese Felder werden in diesem Modus umgangen. |
| Skillset mit Segmentierung, Muster mit zwei Indizes (übergeordneter Index + untergeordneter Segmentindex) | Beides: Indexerfeldzuordnungen füllen ACL-Felder im übergeordneten Index auf, Indexprojektionen füllen ACL-Felder im untergeordneten Blockindex auf. | Beide Indizes sind abfragbar, und jede benötigt die metadaten, nach denen sie filtert. |
In allen Segmentierungsszenarien muss jedes Segment die ACL-Felder enthalten. Berechtigungsfilter gelten pro Dokument, sodass ein Chunk, dem ACL-Felder fehlen, nicht an den richtigen Aufrufer zurückgegeben werden kann.
1. Datenquellenkonfiguration
Fügen Sie der userIds hinzu, um groupIds und indexerPermissionOptions zu erfassen. In diesem Beispiel wird die Standarddokumentbibliothek der Website ausgewählt. Verwenden Sie den Container und die Abfrageeinstellungen des Connectors für andere Auswahlen.
{
"name": "my-sharepoint-acl-datasource",
"type": "sharepoint",
"indexerPermissionOptions": ["userIds", "groupIds"],
"credentials": {
"connectionString": "<connection-string>;"
},
"container": {
"name": "defaultSiteLibrary",
"query": null
}
}
2. Hinzufügen von Berechtigungsfeldern zur Indexdefinition
Führen Sie die folgenden Felder und Eigenschaften in der Indexschemadefinition zusammen. In diesem Fragment werden der erforderliche Dokumentschlüssel und die Inhaltsfelder weggelassen. bewahren Sie sie in der vollständigen Definition auf.
Trennen Sie SharePoint Autorisierungsmetadaten von der Indexschlüsselidentität. Die folgenden SharePoint spezifischen Anforderungen erweitern die Quellmetadaten und die Schlüsselzuordnung und Codierungsanweisungen des Connectors.
| Quellfeld | Purpose | Ziel und Zuordnung |
|---|---|---|
metadata_spo_item_path |
Quellpfad für ACL-Nachschlage- und nur Berechtigungsupdates. | Erforderliches Feld Edm.String mit dem Namen metadata_spo_item_path. Verwenden Sie die implizite Zuordnung mit demselben Namen für ganze Dokumente und /document/metadata_spo_item_path in jeder Chunk-Projektion. |
metadata_user_ids |
Unterstützte Benutzerzuweisungen. | Zuordnen zu einem Collection(Edm.String) Feld mit permissionFilter: "userIds", z. B UserIds. .
Project /document/metadata_user_ids auf Blöcke. |
metadata_group_ids |
Unterstützte Microsoft Entra- und konfigurierte SharePoint-Websitegruppenzuweisungen. | Zuordnen zu einem Collection(Edm.String) Feld mit permissionFilter: "groupIds", z. B GroupIds. .
/document/metadata_group_ids auf Blöcke projizieren. |
metadata_spo_site_url |
Ursprungswebsite für Auflösung systemeigener SharePoint-Gruppe. | Zuordnen zu einem Edm.String Feld mit sharepointSiteUrl: true, z. B SharePointSiteUrl. .
Project /document/metadata_spo_site_url auf Blöcke; behalten Sie die Site jedes Elements für siteübergreifende Auswahlen bei. |
metadata_spo_site_library_item_id |
Bibliothekselementidentität für Bibliotheks- oder Ordnerauswahlen. | Ordnen Sie dem Ganzdokument- oder übergeordneten Indexschlüssel mithilfe der Schlüsselcodierungsanweisungen des Connectors zu. Projektionen generieren untergeordnete Schlüssel und Elternidentität. |
metadata_spo_site_asset_item_id |
Objekt-/Elementidentität für Listen-, Seiten- oder Auswahlen mit gemischten Inhalten. | Verwenden Sie anstelle des Bibliothekselementschlüssels für allSiteLists, allSitePagesund allSiteContent. Befolgen Sie die gleichen Codierungsanweisungen für den Schlüssel; ordnen Sie keine projektionsgenerierten Schlüssel oder übergeordneten Identitäten zu. |
{
"fields": [
{ "name": "metadata_spo_item_path", "type": "Edm.String", "retrievable": false },
{ "name": "UserIds", "type": "Collection(Edm.String)", "permissionFilter": "userIds", "filterable": true, "retrievable": false },
{ "name": "GroupIds", "type": "Collection(Edm.String)", "permissionFilter": "groupIds", "filterable": true, "retrievable": false }
],
"permissionFilterOption": "enabled"
}
Setzen Sie retrievable nur während der Entwicklung auf true, um Werte zu überprüfen. Das Ändern retrievable erfordert keine Indexneuerstellung.
3. Konfigurieren von Indexprojektionen in Ihrem Skillset (falls zutreffend)
Wenn Chunking aktiviert ist, wird das übergeordnete Dokument nicht in den Index geschrieben, wenn projectionModeskipIndexingParentDocuments ist. Übertragen Sie die ACL-Metadaten über indexProjections.selectors[].mappings für jeden Chunk.
Wenn Ihr Indexer ein Skillset mit Datenblöcken verwendet, z. B. die Fähigkeit "Textteilung" beim Aktivieren der integrierten Vektorisierung, ordnen Sie die Berechtigungsfelder und den erforderlichen Quellpfad jedem Abschnitt mithilfe von Indexprojektionen zu. Informationen zum Skillset-Schema finden Sie in der REST-API-Referenz der Datenebene 2026-10-01.
Dieses Beispiel zeigt die Skillset-Konfiguration für einen Zielabschnittsindex mit den Berechtigungsfeldern aus dem vorherigen Schritt. Das Ziel benötigt außerdem ein content Feld, einen Dokumentschlüssel und ein filterbares parentId Zeichenfolgenfeld, wie in "Indexprojektionen definieren" beschrieben. Projektionen generieren den Dokumentschlüssel und die übergeordnete ID; ordnen Sie diese Felder nicht selbst zu. Schließen Sie SharePointSiteUrl nur ein, wenn Sie SharePoint Gruppenunterstützung konfigurieren.
Der // Kommentar im folgenden Beispiel ist illustrativ und ist kein gültiger JSON-Code. Entfernen Sie sie, bevor Sie die Anforderung übermitteln.
PUT https://{service}.search.windows.net/skillsets/{skillset}?api-version=2026-10-01
{
"name": "my-skillset",
"skills": [
{
"@odata.type": "#Microsoft.Skills.Text.SplitSkill",
"name": "#split",
"context": "/document",
"inputs": [{ "name": "text", "source": "/document/content" }],
"outputs": [{ "name": "textItems", "targetName": "chunks" }]
}
// ... (other skills such as embeddings, entity recognition, etc.)
],
"indexProjections": {
"selectors": [
{
"targetIndexName": "chunks-index",
"parentKeyFieldName": "parentId",
"sourceContext": "/document/chunks/*",
"mappings": [
{ "name": "content", "source": "/document/chunks/*" },
{ "name": "metadata_spo_item_path", "source": "/document/metadata_spo_item_path" },
{ "name": "UserIds", "source": "/document/metadata_user_ids" },
{ "name": "GroupIds", "source": "/document/metadata_group_ids" },
{ "name": "SharePointSiteUrl", "source": "/document/metadata_spo_site_url" }
]
}
],
"parameters": {
"projectionMode": "skipIndexingParentDocuments"
}
}
}
Die Zuordnungen UserIds, GroupIds und SharePointSiteUrl lesen Metadaten auf Quellenebene, die vom SharePoint-Indexer (/document/metadata_*) ausgegeben werden, und schreiben die Werte in jedes Segment.
4. Konfigurieren der Indexerfeldzuordnungen für ACLs
Verwenden Sie Indexerfeldzuordnungen, wenn der Indexer ein Dokument pro Quellelement (ohne Blöcke) schreibt oder wenn Sie einen separaten übergeordneten Index zusammen mit einem Blockindex verwalten. Behalten Sie für einen Index nur mit Chunks die Projektionszuordnungen aus dem vorherigen Schritt bei projectionMode: skipIndexingParentDocuments. Sie benötigen keinen zusätzlichen Indexer fieldMappings, um diese Chunk-Felder aufzufüllen.
Ordnen Sie ACL-Rohmetadatenfelder von SharePoint zu Ihren Indexfeldern zu, neben der erforderlichen Indexerkonfiguration.
Für ein Dokument pro Quellelement wird für gleichnamige Quell- und Indexfelder metadata_spo_item_path die implizite Feldzuordnung verwendet. Verwenden Sie für Blöcke die direkte Projektionszuordnung im vorherigen Schritt.
Wenden Sie diese für Berechtigungen aktivierten Konfigurationsdeltas auf die Indexerkonfiguration des Basisconnectors an:
-
Bibliotheks- oder Ordnerauswahl: Bewahren Sie die
metadata_spo_site_library_item_idSchlüsselzuordnung und diebase64Encodezugehörige Zuordnungsfunktion auf. -
Listen- oder Seitenauswahlen: Für
allSiteListsoderallSitePagesersetzen Sie die Schlüsselzuordnungsquelle durchmetadata_spo_site_asset_item_id, wobei die Codierungsfunktion beibehalten wird. Behalten Sie die in Index SharePoint Listen oder Index-ASPX-Websiteseiten beschriebene Inhaltskonfiguration bei. -
Gemischte Auswahl: Für
metadata_spo_site_asset_item_idverwenden SieallSiteContentals Schlüsselzuordnungsquelle über die gesamte Auswahl hinweg, mit derselben Codierungsfunktion.
Aktivieren Sie für jede Auswahl userIds und groupIds auf der Datenquelle, behalten Sie das erforderliche Pfadfeld bei, und fügen Sie die folgenden ACL-Zuordnungen hinzu. Fügen Sie die Website-URL-Zuordnung hinzu, wenn Sie systemeigene SharePoint-Gruppen verwenden. Verwenden Sie für Chunk-only-Indizes die fünf Projektionszuordnungen im vorherigen Schritt, anstatt generierte Schlüssel oder die übergeordnete ID manuell zuzuordnen.
{
"fieldMappings": [
{ "sourceFieldName": "metadata_user_ids", "targetFieldName": "UserIds" },
{ "sourceFieldName": "metadata_group_ids", "targetFieldName": "GroupIds" }
]
}
5. Führen Sie den Indexer aus.
Der Indexer erfasst ACL-Metadaten bei der Ausführung. Nachdem Sie den Indexer erstellt oder aktualisiert haben, führen Sie den Indexer aus, und überwachen Sie den Status , um ACLs zusammen mit Inhalten aufzunehmen.
Informationen zur Aktualisierung der wiederkehrenden Berechtigung und zum Zurückfüllen vorhandener Indexe finden Sie unter Indizierte Berechtigungen aktualisieren. Die Schritte zum Zurückfüllen hängen davon ab, ob vorhandene Datensätze metadata_spo_item_path bereits enthalten sind.
6. Überprüfen der ACL-Erfassung
So bestätigen Sie, dass ACL-Werte richtig ausgefüllt sind:
- Legen Sie in Ihrer Indexdefinition
retrievablevorübergehend auftruefest fürUserIdsundGroupIds. Das Ändernretrievableerfordert keine Indexneuerstellung. - Führen Sie eine Abfrage mit erhöhten Leseberechtigungen aus, die
UserIdsundGroupIdsauswählt. Vergleichen Sie die Werte mit den Quellzuweisungen der unterstützten Quellen des Elements. Eine Sammlung kann leer sein, wenn der Zugriff über die andere gewährt wird. Überprüfen Sie bei Chunking-Szenarien die erwarteten Zuordnungen für jeden Block. - Senden Sie
retrievablenach der Überprüfung anfalsezurück.
Vergleichen Sie die Ergebnisse zulässiger und abgelehnter Testbenutzer mithilfe von Prüfungen zur Fehlerbehebung bei Abfragen. Ausgefüllte ACL-Felder allein belegen die Erzwingung zur Abfragezeit nicht.
Konfigurieren SharePoint Gruppenunterstützung
Der SharePoint Indexer kann SharePoint Websitegruppenberechtigungen (Besitzer, Mitglieder, Besucher und benutzerdefinierte Websitegruppen) für die Abfragezeitfilterung erfassen. Der Indexer gibt SharePoint-Gruppe IDs im metadata_group_ids Feld mit dem spg: Präfix aus, um sie von Microsoft Entra Gruppenobjekt-IDs zu unterscheiden.
Führen Sie nach dem Konfigurieren der ACL-Aufnahme die folgenden Schritte aus, um Ihrer Index- und Abfragekonfiguration die Auflösung von SharePoint-Websitegruppen hinzuzufügen.
Die folgenden Komponenten arbeiten zusammen, um die Auflösung von SharePoint-Websitegruppen zu ermöglichen:
| Bestandteil | Hierbei gilt: | Purpose |
|---|---|---|
sharePointConnectorAppRegistration (mit applicationId, tenantId, federatedCredentialId) |
Definition des Index | Stellt die Authentifizierungskonfiguration bereit, die für den Foundry IQ-Dienst erforderlich ist, um die SharePoint REST-API als aufrufenden Benutzer aufzurufen und die Websitegruppenmitgliedschaft zur Abfragezeit aufzulösen. |
SharePointSiteUrl Feld (mit sharepointSiteUrl: true) |
Indexschema + Feldzuordnung des Indexers von metadata_spo_site_url |
Gibt an, zu welcher SharePoint-Website ein Dokument gehört, damit die Auflösung von SP-Gruppen korrekt eingegrenzt wird. |
spg:-präfixierte Werte in GroupIds |
Dokumentberechtigungsmetadaten | Unterscheiden Sie SharePoint Websitegruppen-IDs von Microsoft Entra Gruppenobjekt-IDs. |
Identifiziert bei websiteübergreifender Quellauswahl die metadata_spo_site_url Ursprungswebsite jedes Elements, keine feste Website für den gesamten Index. Behalten Sie diesen Wert für jedes Dokument oder jeden Abschnitt bei, und gewähren Sie der konfigurierten Anwendung den erforderlichen Zugriff auf jede ausgewählte Website. Weitere Informationen finden Sie unter "Berechtigungen nach ACL"-Szenario und Auswählen, wo ACL-Felder aufgefüllt werden.
Ein Index mit einem markierten sharepointSiteUrl: true Feld unterstützt höchstens fünf unterschiedliche Website-URL-Werte. Überprüfen Sie die Websitegrenzwerte für SharePoint-Gruppe-Berechtigungen, bevor Sie Websites auswählen. Für größere Bereiche bewerten Sie separate Indizes und Wissensquellen, einschließlich Wissensbasiskapazität und Anwendungsrouting.
1. Voraussetzungen
- SharePoint-Indexer ist bereits für die ACL-Erfassung konfiguriert. Siehe Konfigurieren der Indexerfeldzuordnungen für ACLs.
- Microsoft Entra-App-Registrierung mit Anmeldeinformationen für eine Verbundidentität. Siehe Konfigurieren der registrierten Anwendung mit einer verwalteten Identität.
- REST-API
2026-10-01.
Hinweis
FederatedCredentialApplicationId in der Verbindungszeichenfolge der Datenquelle und federatedCredentialId in sharePointConnectorAppRegistration verwenden die Anwendungs-ID der verwalteten Identität. Die Eigenschaft applicationId in sharePointConnectorAppRegistration verwendet die Client-ID der Erfassungs-App. Informationen zum Auffinden der richtigen Werte finden Sie unter "Suchen der richtigen Microsoft Entra Bezeichner".
2. Konfigurieren des Indexes
Führen Sie die folgende Konfiguration in Ihre vollständige Indexdefinition ein und behalten Sie dabei deren Dokumentschlüssel- und Inhaltsfelder bei. Sie fügt sharePointConnectorAppRegistration und SharePointSiteUrl zusammen mit den ACL-Feldern hinzu. Behalten Sie permissionFilterOption: "enabled".
{
"name": "my-sharepoint-acl-index",
"sharePointConnectorAppRegistration": {
"applicationId": "<ingestion-app-client-id>",
"federatedCredentialId": "<managed-identity-application-id>",
"tenantId": "<sharepoint-tenant-id>"
},
"fields": [
{ "name": "metadata_spo_item_path", "type": "Edm.String", "retrievable": false },
{ "name": "UserIds", "type": "Collection(Edm.String)", "permissionFilter": "userIds", "filterable": true, "retrievable": false },
{ "name": "GroupIds", "type": "Collection(Edm.String)", "permissionFilter": "groupIds", "filterable": true, "retrievable": false },
{ "name": "SharePointSiteUrl", "type": "Edm.String", "sharepointSiteUrl": true, "filterable": false, "retrievable": false }
],
"permissionFilterOption": "enabled"
}
3. Konfigurieren der Indexerfeldzuordnungen
Ordnen Sie die SharePoint Metadatenfelder den Indexfeldern in einem einzigen kombinierten Zuordnungsblock zu. Die ersten beiden Zuordnungen sind dieselben, die für die standardmäßige ACL-Erfassung verwendet werden; die dritte Zuordnung aktiviert die Auflösung von SharePoint-Gruppen.
{
"fieldMappings": [
{ "sourceFieldName": "metadata_user_ids", "targetFieldName": "UserIds" },
{ "sourceFieldName": "metadata_group_ids", "targetFieldName": "GroupIds" },
{ "sourceFieldName": "metadata_spo_site_url", "targetFieldName": "SharePointSiteUrl" }
]
}
Wenn Ihr Skillset Dokumente in Blöcke aufteilt (z. B. mit der Fertigkeit zur Textaufteilung für die integrierte Vektorisierung), projizieren Sie stattdessen SharePointSiteUrl über indexProjections.selectors[].mappings auf jeden Block.
Siehe Auswählen, wo ACL-Felder aufgefüllt werden sollen.
4. Abfragen des Indexes
Es ist keine clientseitige Änderung erforderlich. Dasselbe x-ms-query-source-authorization-Token aktiviert sowohl die Microsoft Entra-Durchsetzung als auch die Durchsetzung von SharePoint-Websitegruppen. Der Foundry IQ-Dienst löst SharePoint-Gruppe-Mitgliedschaften serverseitig mithilfe von sharePointConnectorAppRegistration im Index auf.
Das Anforderungsformat finden Sie im allgemeinen Abfragebeispiel sowie im SharePoint-spezifischen Beispiel mit Erzwingung von SharePoint-Websitegruppen.
5. Überprüfen
Um zu bestätigen, dass sich SharePoint-Gruppe-IDs im Index befinden, führen Sie eine Abfrage mit erhöhten Leseberechtigungen aus, die GroupIds auswählt, und suchen Sie in der Antwort nach spg:-präfixierten Werten.
Berechtigungen zwischen indizierten und Quellinhalten synchronisieren
Inhalts- und Berechtigungsmetadaten werden über separate Verarbeitungsphasen in die Suche repliziert. Wählen Sie einen Abrufansatz basierend auf dem Ort der Autorisierung und der Verwaltung von Updates durch Ihre Anwendung aus.
Abrufansatz für Aktualität auswählen
Bevorzugen Sie remote SharePoint, wenn Ihre Anwendung Abrufe zum Zeitpunkt der Anforderung mithilfe des Berechtigungsmodells von SharePoint anstelle einer replizierten Berechtigungsuntermenge in Search benötigt. Dieser Ansatz bietet durch die Microsoft 365-Governance-Steuerelemente eine höhere Aktualität näher an SharePoint, ohne eine zusätzliche Suchsynchronisierungspipeline. Wählen Sie den indizierten Abruf für einen benutzerdefinierten Suchindex oder Push für die anwendungsgesteuerte Übermittlung aus.
| Entscheidung | Remote-SharePoint | Indiziertes SharePoint | Vom Kunden verwaltete Push-API |
|---|---|---|---|
| Autorisierungsstelle | Microsoft 365-Abruf im Namen des Benutzers unter Verwendung des SharePoint-Berechtigungsmodells und der Microsoft 365-Governancekontrollen. | Abfragezeitfilterung über eine replizierte Teilmenge von SharePoint Berechtigungen. | Abfragezeitfilterung über Berechtigungswerte, die Ihre Anwendung bereitstellt; keine automatische SharePoint ACL-Synchronisierung oder systemeigene Gruppenauflösung. |
| Aktualität von Inhalten und Berechtigungen | Keine zusätzliche Suchindexsynchronisierung; hängt von Microsoft 365 Verarbeitungs- und Remotequellenbeschränkungen ab. | Quellbenachrichtigungen und erfolgreiche Indizierungsverarbeitung aktualisieren das Replikat. Zeitpläne richten kein strenges Aktualitätsfenster ein. | Ihre Anwendung steuert den Zeitpunkt der Übermittlung, nicht die sofortige Sichtbarkeit in Abfragen. |
| Widerruf | Vorbehaltlich der Verarbeitung durch Microsoft 365; keine Zusage ohne Verzögerung. | Veraltete indizierte Berechtigungen können bis zur Verarbeitung der relevanten Aktualisierung beibehalten werden. | Ihre Anwendung erkennt widerrufene Berechtigungen, aktualisiert betroffene Datensätze und Chunks und überprüft die Ergebnisse. |
| Verantwortlichkeiten für Identitäten | Geben Sie die delegierte Benutzeridentität an, die von der Remotequelle benötigt wird. | Konfigurieren sie Anmeldeinformationen, unterstützte Gruppenauflösung und das Token des abfragenden Benutzers. | Bereitstellen unterstützter Berechtigungsidentitäten und Abfrageautorisierung; implementieren Sie die Quell-zu-Index-Berechtigungsübersetzung. |
| Anpassung | Abruf mit unterstützten Filtern und Metadaten eingrenzen; abhängig von den Funktionen der Retrieval-API. | Konfigurieren Sie indexschema, unterstützte Anreicherung, Blöcke und Vektoren. | Implementieren Sie Extraktions-, Indexschema-, Chunking-, Vektor- und Berechtigungsupdates in Ihrer Aufnahmepipeline. |
| Operations | Abruf und Microsoft 365-Abhängigkeiten überwachen; kein Search-Indexer zu planen. | Indexerläufe überwachen, Berechtigungen aktualisieren und Dokumente und Projektionen überprüfen. | Führen Sie die Aufnahmepipeline aus, und behandeln Sie Updatefehler , wie im folgenden Abschnitt beschrieben. |
| Netzwerk- und Richtliniengrenzen | Folgen Sie den Voraussetzungen und Einschränkungen der Remotequelle; dies ist keine Problemumgehung für Conditional Access. | Connectorbeschränkungen gelten. SharePoint Online verwendet öffentliche Endpunkte. | Ihre Anwendung besitzt ihre Quell- und Suchverbindungen; Push ändert SharePoint Richtlinienanforderungen nicht. |
| API- und Freigabebereich | Remotewissensquellen und die Copilot Retrieval API befinden sich in der Vorschau; befolgen Sie die Anleitung zur Remote-API. | SharePoint ACL-Aufnahme und -Filterung sind in der Regel mit REST 2026-10-01verfügbar.
Hinweise zu indizierten Wissensquellen verfügen über separate API- und Vorschauanforderungen. |
Die Berechtigungsaufnahme über die Push-REST-APIs ist allgemein verfügbar. Das verknüpfte Handbuch identifiziert die REST-API-Version, die in den Beispielen und in den Hinweisen zur SDK-Unterstützung verwendet wird. Informationen zum Berechtigungsfilterschema finden Sie in der REST-API-Referenz der Datenebene 2026-10-01. |
Beim indizierten Abruf, bei der Quellweitergabe, der Inhalts- und ACL-Verarbeitung, der Weitergabe von Gruppenmitgliedschaften, der Tokenerneuerung, der Zwischenspeicherung von Mitgliedschaften zur Abfragezeit und der Indexaktualisierung können jeweils die Sichtbarkeit beeinflussen. Ein angeforderter oder geplanter Start ist kein Abschluss der Verarbeitung. Ausführungen können ihr Intervall überschreiten oder auf Drosselung, Wiederholungen oder Fehlschläge stoßen. Zeitpläne, reset, reset-docs und die Neusynchronisierung von Berechtigungen sind keine Steuerelemente für die sofortige Aktualität.
Mit Push übernimmt Ihre Anwendung die SharePoint Änderungserkennung, Inhalts- und Berechtigungssynchronisierung, Extraktion, Blöcke und Vektoren, Löschungen und Bereinigung veralteter Datensätze, Wiederholungen, Sortierung, Abstimmung und Überwachung. Der Zeitpunkt der Übermittlung allein stellt keine strikte End-to-End-Aktualität sicher.
Behandeln von Autorisierungs- und Aktualisierungsfehlern
Wenn Ihre Anwendung keine gültige Benutzerautorisierung erhalten kann oder die Berechtigungsprüfung fehlschlägt, beenden Sie die Rückgabe geschützter Inhalte für diese Anforderung und zeigen Sie einen Fehler an. Wiederholen Sie den Vorgang nicht ohne das Benutzertoken, deaktivieren Sie die Berechtigungsfilterung oder verwenden Sie den erweiterten Diagnosezugriff nicht als benutzerseitigen Fallback. Wenden Sie diese Verantwortung auch auf von der Anwendung zwischengespeicherte Inhalte und generierte Antworten an.
Für eine vom Kunden verwaltete Pushpipeline:
- Überprüfen Sie das Indizierungsergebnis jedes Dokuments, einschließlich teilweiser Fehler in einer HTTP-Antwort
207. Verfolgen Sie fehlgeschlagene Schlüssel, und versuchen Sie bei wiederholbaren Fehlern den Vorgang mit Backoff erneut, gemäß Load a search index. - Serialisieren Sie Updates für denselben Schlüssel und führen Sie Wiederholungsversuche idempotent aus. Konsolidieren Sie Änderungen vor der Übermittlung; die Batchaktionsreihenfolge ist nicht definiert. Bewahren Sie in Ihrer Pipeline eine Quellversion oder einen Prüfpunkt auf, damit ein älterer erneuter Versuch keine widerrufene Berechtigung wiederherstellt.
- Übermitteln Sie die vollständige beabsichtigte ACL-Auflistung, wenn Sie ein Berechtigungsfeld ersetzen. Sammlungsaktualisierungen ersetzen die Sammlung, anstatt einzelne Berechtigungen anzufügen.
- Gleichen Sie Quellelemente mit indizierten Schlüsseln und den zugehörigen Blöcken ab. Entfernen Sie veraltete Dokumente, veraltete Chunks und Datensätze außerhalb des ausgewählten Quellbereichs mithilfe von Richtlinien zum Löschen von Dokumenten. Ein Update auf einen Schlüssel bereinigt keine anderen Schlüssel.
- Überprüfen Sie die Indizierungsergebnisse, die Abfragesichtbarkeit und den Zugelassenen und Verweigerten des Benutzerzugriffs, bevor Sie eine Aktualisierung als abgeglichen behandeln.
Indizierte Berechtigungen aktualisieren
Konfigurieren Sie einen kurzen wiederkehrenden Indexierungszeitplan entsprechend Ihren Anforderungen an die Aktualisierung von Berechtigungen. Das Mindestintervall ist fünf Minuten. Verwenden Sie die vorhandene Planungsdefinition und die Anleitung zur Zeitplankonfiguration.
Das Intervall ist kein Abschlusstermin oder eine Vereinbarung auf Dienstebene (Permission-Revocation Service Level Agreement, SLA). Die Ausführung kann verzögert werden, und eine überlappende Ausführung kann dazu führen, dass ein geplanter Start übersprungen wird. Weitere Informationen finden Sie unter FAQ zum Planungsverhalten. Berechtigungsänderungen gelangen erst dann in den Index, nachdem sie erkannt und erfolgreich verarbeitet wurden, nicht automatisch bei jedem geplanten Start. Ein wiederkehrender Zeitplan fordert keine vollständige Erneute Synchronisierung von Berechtigungen an.
Wenn Sie die ACL-Aufnahme aktivieren, werden bei der normalen inkrementellen Verarbeitung erkannte Berechtigungsänderungen auf Elementebene aktualisiert. Eine unterstützte Berechtigungsänderungsbenachrichtigung für einen Nicht-Stammdokumentbibliotheksordner bewirkt auch, dass der Indexer untergeordnete Untergeordnete Elemente im Gültigkeitsbereich aufzählt und die Quell-ACLs jedes Elements während einer nachfolgenden erfolgreichen Ausführung aktualisiert, auch wenn sich der untergeordnete Inhalt nicht geändert hat. Ein untergeordnetes Element mit eindeutigen Berechtigungen behält seine eigenen Quellzugriffsregeln bei, anstatt eine Kopie der ACL des Ordners zu erhalten.
Dieser Ordnerberechtigungspfad ist unabhängig von der Option für die Weitergabe bei Umbenennen und Verschieben und erfordert keine separate erneute Synchronisierung vollständiger Berechtigungen. Es wird nicht dasselbe Verteilungsverhalten für Website-, Bibliotheks-, Listen- oder Laufwerkstammänderungen oder für Benachrichtigungen über verpasste Quellen festgelegt.
| Bereich ändern | Automatisch erkannt | Empfohlene Maßnahme |
|---|---|---|
| Änderung der Berechtigungen für ein Element mit eindeutigen Berechtigungen (Datei, Listenelement oder Seite) erkannt | Ja | Führen Sie den Indexer aus, oder lassen Sie die Ausführung des Zeitplans zu, und überprüfen Sie dann die aktualisierten ACLs. |
| Inhaltsänderung für ein bestimmtes Element | Ja | Durch die Verarbeitung des geänderten Elements werden auch die effektiven ACLs erneut ausgewertet. |
| Unterstützte Benachrichtigung über Berechtigungsänderungen für Nicht-Stamm-Dokumentbibliotheksordner | Ja | Eine spätere erfolgreiche Ausführung aktualisiert untergeordnete Elemente innerhalb des Geltungsbereichs, einschließlich unveränderter Dateien. Untergeordnete Elemente mit eindeutigen Berechtigungen behalten ihre eigenen Quell-ACLs bei. |
| Änderung der Berechtigungen für Website, Bibliothek, Liste oder Laufwerkstamm; verpasste Benachrichtigung | Nicht durch den Pfad für Ordneraktualisierungen abgedeckt | Verwenden Sie permissions resync, um vorhandene indizierte ACLs zu aktualisieren, oder betroffene Dokumente zurückzusetzen, um deren Inhalte und ACLs erneut zu verarbeiten. Überprüfen Sie die Ergebnisse. |
| ACL-Aufnahme für einen vorhandenen Indexer aktiviert | Backfill erforderlich | Wenn vorhandene Datensätze bereits metadata_spo_item_path enthalten, verwenden Sie Berechtigungssynchronisierung. Fügen Sie andernfalls das erforderliche Feld und die entsprechende Projektionszuordnung hinzu, setzen Sie dann die betroffenen Quellenelemente zurück und verarbeiten Sie sie erneut, um ihre Pfade und ACLs zu befüllen. |
Diese Vorgänge gelten auch für den generierten Indexer einer indizierten SharePoint Wissensquelle. Das Hinzufügen eines Schemafelds allein befüllt vorhandene Datensätze nicht. Überprüfen Sie bei projizierten Indizes die Berechtigungs- und Quellmetadaten für die betroffenen Blöcke.
Behandeln Sie Änderungen im Quelllebenszyklus getrennt von der reinen Berechtigungsaktualisierung:
- Inhaltsänderungen: Verarbeiten Sie die betroffenen Inhalte und ihre Chunks erneut in einem normalen Indexerlauf oder durch gezieltes Zurücksetzen. Die erneute Synchronisierung von Berechtigungen führt die Extraktion oder Einbettung nicht erneut aus.
- Verschiebungen und Umbenennungen: Überprüfen Sie die inkrementellen Indizierungseinschränkungen des Connectors, und aktualisieren Sie bei Bedarf Quellauswahlpfade. Vergleichen Sie den aktuellen Quellpfad und die indizierte Identität mit den früheren Datensätzen und Blöcken. Behandeln Sie die Erneute Synchronisierung von Berechtigungen nicht als Schlüsselmigration.
- Löschungen: Der Connector erkennt Quelllöschungen bei nachfolgenden Ausführungen. Überprüfen Sie nach erfolgreicher Verarbeitung, ob die indizierten Dokumente des Quellelements und Chunks nicht vorhanden sind.
- Veraltete Datensätze oder Blöcke: Vergleichen Sie die erwarteten Quellelemente und projizierten untergeordneten Elemente mit tatsächlich indizierten Schlüsseln nach der Verarbeitung. Untersuchen Sie die verbleibenden Datensätze mithilfe von "Dokumente löschen"; eine erfolgreiche Aktualisierung der aktuellen Datensätze ist kein Beweis dafür, dass veraltete Datensätze entfernt wurden.
Durch Abfragen werden keine Indexer gestartet. Überwachen Sie den Ausführungsstatus auf Abschluss, Warnungen, Fehler und Elementanzahlen, und überprüfen Sie dann die Ergebnisse, die mit Berechtigungen gefiltert wurden. Eine erfolgreiche Ausführung allein weist keine durchgängige Aktualität nach.
Zurücksetzen bestimmter Dokumente
Verwenden Sie das Zurücksetzen bestimmter Dokumente , um Inhalte und ACLs für bekannte Dokumentschlüssel neu zu verarbeiten, und führen Sie dann den Indexer aus. Dieser Vorgang unterscheidet sich von einer Nur-Berechtigungsaktualisierung.
Erneutes Synchronisieren von ACLs über die gesamte Datenquelle
Verwenden Sie resync mit REST-API 2026-10-01 und options: ["permissions"]. Die nächste manuelle oder geplante Indexerausführung verarbeitet die Anforderung; überwachen Sie den Vorgang bis zum Abschluss. Die Anforderungsakzeptanz bedeutet nicht, dass die Verarbeitung abgeschlossen ist. Dieser Nur-Berechtigungsvorgang verwendet die vorhandenen metadata_spo_item_path Datensätze, um indizierte Dokumente und projizierte Blöcke zu aktualisieren, ohne das Skillset oder Einbettungen erneut auszuführen. Folgen Sie für Datensätze ohne Pfade den Hinweisen zum Backfill. Ein späterer normaler Inhaltslauf ist ein separater Vorgang.
Die Erneute Synchronisierung von Berechtigungen unterscheidet sich von Synchronisierungs-Wiederholungen, wodurch Inhalte während einer normalen Indizierungsausführung erneut verarbeitet werden können. Außerdem wird keine Unterstützung für organisationsweite Freigabelinks oder Ablaufdaten für Links hinzugefügt.
Bis die relevante Aktualisierung verarbeitet wird, können Abfragen veraltete indizierte ACLs verwenden. Vergleichen Sie nach der Verarbeitung die Ergebnisse eines berechtigten und eines abgelehnten Testbenutzers mithilfe der Prüfungen zur Problembehandlung von Abfragen.
Nach der Indizierung Ihrer Daten und ACLs können Sie den Index abfragen.
Problembehandlung
| Symptom | Ursache und Auflösung |
|---|---|
UserIds oder GroupIds sind in indizierten Dokumenten leer |
Wenn Ihr Skillset projectionMode: skipIndexingParentDocuments verwendet, umgeht der Indexer Feldzuordnungen für ACL-Felder. Legen Sie stattdessen die ACL-Felder bei jedem Chunk über indexProjections.selectors[].mappings fest. |
SharePoint Websitegruppen-IDs fehlen, oder GroupIds-Werte verfügen nicht über das Präfix spg: |
Vergewissern Sie sich, dass der Index mit der Konfiguration sharePointConnectorAppRegistration konfiguriert ist, das Feld SharePointSiteUrl mit sharepointSiteUrl: true vorhanden ist und das Mapping metadata_spo_site_url in den Feldzuordnungen des Indexers oder in den Indexprojektionen vorhanden ist. |
SharePointSiteUrl ist nach der Indizierung leer oder null, obwohl ACLs ansonsten korrekt befüllt werden |
Der Indexer gibt diese Metadaten unter metadata_spo_site_url, nicht metadata_sharepoint_site_url. Stellen Sie sicher, dass die Feldzuordnung des Indexers "sourceFieldName": "metadata_spo_site_url" verwendet. Wenn Ihr Skillset Indexprojektionen für in Blöcke aufgeteilte Dokumente verwendet, überprüfen Sie, ob die Quelle der Projektionszuordnung /document/metadata_spo_site_url ist. |
| Der Indexer gibt 401 oder 403 zurück. | Erteilen Sie der Administratorzustimmung sowohl für Microsoft Graph als auch für SharePoint API-Berechtigungen für Ihr Szenario. Verwenden Sie Verbundanmeldeinformationen anstelle eines Clientschlüssels, wenn das Szenario dies erfordert. Siehe Berechtigungen nach ACL-Szenario. |
| Berechtigungen sind veraltet, nachdem eine Quell-ACL-Änderung erfolgt. | Überprüfen Sie die erfolgreiche Verarbeitung und den Änderungsbereich in Berechtigungen zwischen indizierten und Quellinhalten synchronisieren. Unterstützte Ordnerbenachrichtigungen verwenden normale inkrementelle Verarbeitung; Andere Bereiche oder verpasste Benachrichtigungen können eine explizite Aktualisierung erfordern. |
| ACL-Erfassung meldet einen fehlenden Quellpfad | Fügen Sie das erforderliche metadata_spo_item_path Indexfeld und die zutreffende Projektionszuordnung hinzu, und setzen Sie die betroffenen Quellelemente zurück, und verarbeiten Sie sie erneut. Durch das Hinzufügen des Felds allein werden vorhandene Datensätze nicht befüllt, und die erneute Berechtigungssynchronisierung füllt keine fehlenden Pfade aus. Weitere Informationen finden Sie unter Hinzufügen von Berechtigungsfeldern und Anleitungen zum Zurückfüllen. |
federatedCredentialId wird bei der Konfiguration von sharePointConnectorAppRegistration abgelehnt |
Verwenden Sie die Anwendungs-ID der verwalteten Identität, nicht die Objekt-ID der Verbundidentität oder die Prinzipal-ID der verwalteten Identität. Siehe Anwendungs-ID für den Verbundidentitätsnachweis. |
Der Indexer gibt zurück 401 Unauthorized und FederatedCredentialApplicationId wird festgelegt. |
Überprüfen Sie, ob Sie die Anwendungs-ID der verwalteten Identität verwendet haben (zu finden unter Unternehmensanwendungen) und nicht die Anwendungs-ID (Client-ID) der Erfassungs-App (ApplicationId) oder irgendeine Objekt-ID. Verwenden Sie für eine vom Benutzer zugewiesene verwaltete Identität die Client-ID auf der Eigenschaftenseite der verwalteten Identitätsressource. Siehe "Suchen der richtigen Microsoft Entra-IDs". |
Informationen zu fehlenden, unerwarteten oder fehlgeschlagenen Abfragezeitergebnissen, nachdem ACL-Metadaten indiziert wurden, finden Sie unter Problembehandlung SharePoint Berechtigungsfilterung.