Contrôle d’accès au niveau du document dans Foundry IQ (Recherche Azure AI)

Note

Foundry IQ (Recherche Azure AI) fournit des API d’indexation et d’interrogation directes, ainsi que des API de source de connaissances et de base de connaissances de niveau supérieur pour une récupération gérée. Utilisez le portail Azure, les API REST ou SDK Azure pour configurer ces fonctionnalités, ou connecter des agents à des bases de connaissances dans le portail Microsoft Foundry.

Important

Les fonctionnalités ou fonctionnalités marquées (préversion) dans cet article sont en préversion publique et sont soumises aux conditions d’utilisation supplémentaires pour les préversions Microsoft Azure.

Pour connaître les conditions d’aperçu propres à Foundry IQ (Recherche Azure AI), consultez Fonctionnalités en préversion.

L’ingestion des ACL SharePoint et le filtrage des autorisations au moment de la requête, les ACL/RBAC ADLS Gen2 et le RBAC de conteneur d’objets blob standard sont généralement disponibles avec l’API REST du plan de données 2026-10-01. L’ingestion de liste de contrôle d’accès push est également en disponibilité générale. Microsoft Purview l’application des étiquettes de confidentialité reste en préversion.

Foundry IQ (Recherche Azure AI) prend en charge le contrôle d’accès au niveau du document, ce qui permet aux organisations d’appliquer des autorisations affinées au niveau du document, de l’ingestion des données par le biais de l’exécution des requêtes. Cette fonctionnalité est essentielle pour la création de systèmes IA agentiques sécurisés qui enracinent les données, d'applications de génération augmentée par la récupération (RAG) et de solutions de recherche en entreprise nécessitant des vérifications d’autorisation au niveau du document.

Approches pour le contrôle d’accès au niveau du document

Foundry IQ fournit cinq approches principales pour appliquer des autorisations au niveau du document, chacune adaptée à différentes sources de données et modèles d’identité.

Approche Description
Filtres de sécurité Comparaison de chaînes. Votre application transmet une identité d'utilisateur ou de groupe sous forme de chaîne, ce qui remplit un filtre dans une requête et exclut les documents qui ne correspondent pas à la chaîne.

Les filtres de sécurité sont une technique permettant d’obtenir un contrôle d’accès au niveau du document. Cette approche n’est pas liée à une API afin de pouvoir utiliser n’importe quelle version ou package.
Étendues ACL / RBAC de type POSIX L'identité Microsoft Entra de l'utilisateur délégué est évaluée par rapport aux métadonnées d'autorisation prises en charge. L’ingestion d’étendue RBAC d’étendue ADLS Gen2 et adLS Gen2, l’ingestion d’étendue RBAC du conteneur d’objets blob standard et le filtrage des autorisations de requête sont généralement disponibles dans l’API 2026-10-01REST. L’ingestion push push gérée par le client est également en disponibilité générale. D’autres fonctionnalités conservent leur disponibilité documentée ; toutes les stratégies d’autorisation de stockage ne sont pas prises en charge. Pour obtenir des conseils sur l’API et le Kit de développement logiciel (SDK), consultez Récupérer les métadonnées d’autorisations de liste de contrôle d’accès.
Étiquettes de confidentialité Microsoft Purview (version préliminaire) Indexeur extrait les étiquettes de confidentialité définies dans Microsoft Purview à partir de sources de données prises en charge (Stockage Blob Azure, ADLS Gen2, SharePoint dans Microsoft 365, OneLake). Ces étiquettes sont stockées en tant que métadonnées et évaluées au moment de la requête pour appliquer l'accès utilisateur en fonction des jetons Microsoft Entra et des attributions de stratégie Purview. Les étiquettes sont également exposées par le biais de sources de connaissances et de la réponse de récupération agentique, ce qui permet aux agents IA et aux applications de conversation consommant une base de connaissances de recevoir le même filtrage prenant en charge les étiquettes. Cette approche aligne l'autorisation Foundry IQ avec le modèle de Microsoft Information Protection de votre entreprise.
SharePoint dans les listes de contrôle d’accès Microsoft 365 Les indexeurs Foundry IQ extraient les métadonnées d’autorisation prises en charge et les utilisent pour les vérifications d’accès au moment de la requête avec l’API REST 2026-10-01. Pour connaître le sous-ensemble d’autorisations indexées, les limites de groupe, le comportement de synchronisation et la configuration, consultez Utiliser un indexeur SharePoint pour ingérer les métadonnées d’autorisation.
Autorisations de source OneLake (version préliminaire) Utilise des emplacements sources indexés et une autorisation OneLake au moment de la requête plutôt que des listes de contrôle d’accès utilisateur et de groupe copiées. Consultez Conserver les autorisations OneLake.

Pour les sources de connaissances indexées, ingestionPermissionOptions ne peut pas être combinée avec assetStore. Par conséquent, l’affichage d’images (version préliminaire) n’est pas disponible lorsque l’ingestion des autorisations au niveau du document en mode natif est activée.

Analyse syntaxique et extraction de contenu prises en charge pour l’ingestion des autorisations

Lorsque vous activez les autorisations natives au niveau du document pour SharePoint, ADLS Gen2 ou Stockage Blob, utilisez l’analyse de documents standard ou par défaut et l’extraction de contenu. Conservez les métadonnées d’autorisation et le contexte source de chaque élément source tout au long de l’ingestion.

Vous pouvez également utiliser extraction basée sur Content Understanding, lorsqu’elle est prise en charge par votre source de données et votre API. Configurez chaque bloc généré pour conserver les métadonnées d’autorisation requises et le contexte source. La segmentation en aval prise en charge n’est pas la même que la sélection d’un mode d’analyse source spécialisé.

Pour l’API REST 2026-10-01, utilisez les paramètres de la ressource que vous configurez :

Resource REST, propriété Configuration
SharePoint, ADLS Gen2 ou indexeur d’objets blob parameters.configuration.parsingMode Utiliser default pour l’analyse de document standard.
Source de connaissances d’objet blob, y compris ADLS Gen2 azureBlobParameters.ingestionParameters.contentExtractionMode minimal est l’option d’extraction par défaut ; standard sélectionne l’extraction basée sur Content Understanding. Conservez les mappages d’autorisation et de contexte source générés.
Source de connaissances indexée SharePoint indexedSharePointParameters.ingestionParameters.contentExtractionMode minimal est l’option d’extraction par défaut ; utilisez standard pour l’extraction basée sur Content Understanding, lorsqu’elle est prise en charge. Configurez l’extraction via l’API source de connaissances, et non en modifiant les paramètres d’analyseur générés.

La source contentExtractionMode de connaissances et l’indexeur parsingMode sont des paramètres différents. En particulier, minimal n’est pas un mode d’analyse en texte brut spécialisé. Pour connaître les définitions REST, consultez Indexeurs - Créer et Sources de connaissances - Créer ou mettre à jour.

Les autres modes d’analyse sélectionnés par le client ne sont pas pris en charge pour le moment avec les autorisations au niveau du document. Ne sélectionnez pas :

  • Analyse JSON (json).
  • Analyse de tableau JSON (jsonArray) ou analyse de plusieurs documents JSON en enregistrements distincts.
  • Analyse de lignes JSON (jsonLines).
  • Analyse de fichiers CSV ou de texte délimité (delimitedText).
  • Analyse spécifique au texte brut (text).
  • Analyse spécifique à Markdown (markdown).
  • Tout autre mode qui crée, fractionne, modifie ou mappe plusieurs enregistrements logiques à partir d’un élément source sans contrat de propagation d’autorisations pris en charge.

Ces restrictions concernent les modes d’analyse, et non les extensions de fichier ou le format du contenu extrait. Par exemple, un fichier texte brut traité avec l’analyse default n’utilise pas le mode spécialisé text. La sortie Markdown de Content Understanding n’est pas le mode d’analyse de la source markdown.

Pour connaître les mappages de segments et les métadonnées sources requises, consultez les instructions d’autorisation SharePoint, les conseils d’autorisation ADLS Gen2 et les conseils d’étendue RBAC d’objet blob.

Faire confiance à la source des permissions indexées

Le filtrage des autorisations à l’exécution de la requête évalue les métadonnées d’autorisation associées à un enregistrement indexé. Séparément, votre conception d’ingestion doit établir qui est autorisé à choisir l’identité de cet enregistrement et à accorder l’accès à son contenu. Une clé de document sélectionne un enregistrement pour les mises à jour ou les opérations de fusion ; ce n’est pas un mécanisme de contrôle d’accès.

Pour l’ingestion via un connecteur natif, suivez la configuration spécifique à la source et préservez l’association entre le contenu de la source, l’identité et les autorisations dérivées du connecteur. Pour l’ingestion push gérée par le client, l’éditeur autorisé fournit la clé et les valeurs d’autorisation. Le filtrage de chaînes géré par l’application dépend également de l’authentification et de la construction du filtre de l’application.

Ne traitez pas un contenu ordinaire de moindre confiance comme des métadonnées d’autorisation faisant autorité, au seul motif qu’un nom de champ correspond. Passez en revue les auteurs sources, les administrateurs d’ingestion, les mappages implicites et explicites, les sorties d’enrichissement et les éléments enfants projetés. Pour l’ingestion d’objets blob, utilisez la liste de contrôle de configuration des identités et des autorisations. Cet examen est distinct de la mise à jour des autorisations.

Choisir une approche

Utilisez les critères suivants pour identifier l’approche qui correspond le mieux à vos exigences de source de données, de modèle d’identité et de conformité.

Scénario Approche recommandée Pourquoi
Système de gestion des identités personnalisé ou infrastructure de sécurité non Microsoft. Filtres de sécurité indépendante des API, en disponibilité générale et fondée sur une simple correspondance de chaînes.
Microsoft Entra autorisations d’utilisateur et de groupe envoyées à un index, à des ACL ADLS Gen2 indexées ou à des étendues RBAC de conteneur indexées à partir d’ADLS Gen2 et de Stockage Blob Azure. Étendues ACL / RBAC de type POSIX Utilise les métadonnées d’autorisation natives pour l’application au moment de la requête. Le schéma, l’indexation push et le contrôle au moment de la requête sont généralement disponibles dans l’API REST 2026-10-01; l’ingestion spécifique à la source a des exigences de disponibilité distinctes.
Contenu d’entreprise déjà régi par les stratégies de protection des informations de Microsoft Purview. Étiquettes de sensibilité Microsoft Purview Réutilise les affectations de classification et de stratégie centralisées dans Foundry IQ.
Contenu provenant de SharePoint dans Microsoft 365 (bibliothèques, listes, pages de site ASPX). SharePoint dans les listes de contrôle d’accès Microsoft 365 Évalue le sous-ensemble d’autorisations prises en charge et synchronisées dans Recherche. Pour la récupération côté source au moment de la requête ou la soumission de mises à jour contrôlées par le client, comparez les approches de récupération SharePoint et leur actualité.

Modèle de filtrage de sécurité à l’aide de filtres

Pour les scénarios où l’intégration des étendues ACL/RBAC natives n’est pas viable, utilisez des filtres de chaîne de sécurité pour réduire les résultats en fonction des critères d’exclusion. Le modèle inclut les composants suivants :

  • Pour stocker des identités d’utilisateur ou de groupe, créez un champ de chaîne dans l’index.
  • Chargez l’index à l’aide de documents sources qui incluent des listes de contrôle d’accès associées.
  • Incluez une expression de filtre dans votre logique de requête afin d’effectuer une correspondance sur la chaîne de caractères.
  • Au moment de la requête, obtenez l’identité de l’appelant.
  • Transmettez l’identité de l’appelant comme chaîne de filtre.
  • Les résultats sont limités pour exclure les correspondances qui n'incluent pas la chaîne d'identité de l'utilisateur ou du groupe.

Vous pouvez utiliser des API push ou pull model. Étant donné que cette approche est indépendante de l’API, vous devez simplement vérifier que l’index et la requête ont des chaînes valides (identités) pour l’étape de filtrage.

Cette approche est utile pour les systèmes avec des modèles d’accès personnalisés ou des infrastructures de sécurité non Microsoft. Pour plus d’informations sur cette approche, consultez Filtres de sécurité pour filtrer les résultats dans Foundry IQ.

Schéma de prise en charge native des autorisations ACL de type POSIX et des autorisations d’étendue RBAC

Le filtrage natif des autorisations utilise des ID d’objet utilisateur et de groupe Microsoft Entra indexés et des étendues RBAC de conteneur de stockage.

Azure Data Lake Storage (ADLS) Gen2 prend en charge les listes de contrôle d’accès sur les répertoires et les fichiers. Utilisez un indexeur ADLS Gen2 ou une source de connaissances Blob configurée pour ADLS Gen2 pour ingérer des ACL et des étendues RBAC de conteneur prises en charge avec l’API 2026-10-01REST. Pour Stockage Blob standard, l’indexeur Blob ou la source de connaissances ingère des étendues RBAC de conteneur, et non pas des listes de contrôle d’accès par fichier.

Pour le contenu sécurisé par la liste de contrôle d’accès, utilisez l’accès de groupe par rapport à l’accès utilisateur individuel pour faciliter la gestion. Le modèle inclut les composants suivants :

Les requêtes filtrées par autorisation native distinguent l’appelant de l’utilisateur dont les autorisations de document sont évaluées :

  • Authorization contient le jeton de l’appelant pour le contrôle d’accès en fonction des rôles (RBAC) de Search. Un principal de service d’application ou une identité managée peut appeler Search avec le rôle approprié, tels que Lecteur des données d’index de recherche ou Contributeur des données d’index de recherche.
  • x-ms-query-source-authorization porte le jeton d’un utilisateur délégué pour l’évaluation des autorisations de document. Les groupes sont des métadonnées d’autorisation, et non des identités portant des jetons.

Une application qui peut appeler Search n’est pas nécessairement prise en charge en tant que sujet des autorisations de document. Par exemple, une application autorisée peut utiliser une lecture avec élévation de privilèges sur un index non Purview, mais cette déviation administrative n’évalue pas l’appartenance à la liste de contrôle d’accès de l’application. Pour connaître les flux de jetons pris en charge et les limites spécifiques aux opérations, consultez les limites des jetons d’application.

Utilisez le flux de travail de l’API Push pour charger le contenu et les métadonnées d’autorisation natives.

Utilisez les API du modèle pull (indexeur) pour les ACL ADLS Gen2 et les étendues de conteneur, ou les étendues de conteneur d’objets blob standard, avec l’API REST 2026-10-01.

Récupérer les métadonnées des autorisations ACL pendant l’ingestion

La manière de récupérer les autorisations ACL varie selon que vous envoyez une charge utile de documents ou que vous utilisez l’indexeur ADLS Gen2.

Pour l’ingestion d’autorisations d’objet blob ADLS Gen2 et standard, utilisez l’API REST 2026-10-01. Vérifiez les journaux de modification du Kit de développement logiciel (SDK) pour la prise en charge de cette API et des propriétés requises. La disponibilité REST GA n’établit pas l’état de préparation du package SDK.

L’ingestion push ACL est généralement disponible. Le guide push inclut un 2026-10-01 flux de travail REST. Consultez les journaux de modification du SDK pour la prise en charge des filtres d’autorisation et de l’ingestion ACL/RBAC :

Pour l’approche du modèle Push :

  1. Créez un schéma d’index avec des filtres d’autorisation à l’aide de l’API REST ou d’un package Kit de développement logiciel (SDK) Azure qui prend en charge les propriétés requises.
  2. Envisagez d’utiliser le Kit de développement logiciel (SDK) Microsoft Graph pour obtenir des identités de groupe ou d’utilisateur.
  3. Utilisez les Index Documents ou l’API Kit de développement logiciel (SDK) Azure équivalente pour envoyer (push) des documents et leurs métadonnées d’autorisation associées dans l’index de recherche.

Pour l’approche d’indexeur ADLS Gen2 du modèle pull ou la source de connaissances Blob (ADLS Gen2) :

  1. Vérifiez que les fichiers du répertoire sont sécurisés à l’aide du modèle de contrôle d’accès ADLS Gen2.
  2. Utilisez Indexers - Create (API REST), Knowledge Sources - Create (API REST) ou une API Kit de développement logiciel (SDK) Azure équivalente pour créer l’indexeur, l’indexeur et la source de données.

Si votre ensemble de compétences segmente les documents ADLS ou Blob, renseignez les autorisations sur chaque segment protégé via des projections d’index, et non seulement les mappages de champs d’indexeur.

Métadonnées source pour l’ingestion d’autorisations

Le contexte source et les attributions d’autorisations ont des finalités différentes. Conservez les chemins d’accès source en tant que valeurs brutes, et non comme des clés encodées, des URL de citation ou des ID parents générés.

Source et scénario Métadonnées et objectif de la source Mappage et disponibilité
ACLs utilisateur/groupe nommés ADLS Le champ metadata_storage_path (Edm.String) obligatoire identifie la source. metadata_user_ids et metadata_group_ids contiennent des listes de contrôle d’accès effectives. Mapper les listes de contrôle d’accès aux Collection(Edm.String) champs annotés userIds et groupIds. Conservez le chemin d’accès sur les enregistrements et les blocs. GA en 2026-10-01.
RBAC ADLS uniquement metadata_storage_path est requis pour l’ingestion d’autorisations ADLS, même sans champs de liste de contrôle d’accès. metadata_rbac_scope identifie le conteneur. Associez la portée à un champ Edm.String annoté rbacScope. Le chemin d’accès requis n’est pas utilisé pour copier les attributions de rôles. GA en 2026-10-01.
ADLS avec ACL/RBAC mixtes Chemin d’accès source, ACL utilisateur/groupe effectives et étendue de conteneur. Conservez tous les champs configurés sur les enregistrements et les blocs projetés. Toute autorisation prise en charge indépendante peut autoriser l’accès. GA en 2026-10-01.
Standard Blob RBAC metadata_rbac_scope identifie le conteneur ; un chemin d’accès par document n’est pas nécessaire pour calculer cette étendue. Les pipelines sources de connaissances générés incluent encore metadata_storage_path. Mappez l’étendue scalaire à un champ rbacScope annoté sur des documents et des blocs. Aucune inférence de liste de contrôle d’accès au fichier ADLS. GA en 2026-10-01.
ACLs SharePoint metadata_spo_item_path fournit un contexte d’élément ; metadata_spo_site_url fournit le contexte du site. Les listes et les pages utilisent également metadata_spo_site_asset_item_id. Utilisez le schéma SharePoint spécifique à la source et les instructions de projection. La disponibilité et les exigences de SharePoint sont indépendantes de l’étendue de la disponibilité générale du stockage.

Pour obtenir des définitions de schéma directes, des mappages faisant autorité, des pipelines générés et une correction d’enregistrement existant, consultez l’ingestion d’autorisations ADLS et l’ingestion d’étendue RBAC d’objet blob.

Pour les listes de contrôle d’accès sources ADLS qui accordent un accès étendu tout en excluant les identités nommées, consultez Implicite blocklistsnon pris en charge.

Modèle d’ingestion des autorisations ACL de base pour SharePoint dans Microsoft 365

Pour le contenu indexé SharePoint, Foundry IQ peut stocker les autorisations sources prises en charge en tant que métadonnées et les utiliser pour filtrer les résultats de la requête. Utilisez l’indexeur SharePoint dans Microsoft 365 avec l’API REST 2026-10-01 pour cette configuration d’autorisation, ou un package SDK qui prend en charge la fonctionnalité.

Pour connaître les exigences d’autorisation, les relations de groupe prises en charge, la synchronisation des autorisations et les limitations, consultez Utiliser un indexeur SharePoint pour ingérer des métadonnées d’autorisation.

Si votre ensemble de compétences segmente des documents (par exemple, avec la compétence Fractionnement de texte pour la vectorisation intégrée), les champs ACL passent des mappages de champs d’indexeur aux projections d’index. Consultez Choisir où renseigner les champs ACL.

Modèle pour les étiquettes de confidentialité Microsoft Purview (version préliminaire)

Lorsque vous activez l’ingestion des étiquettes, Foundry IQ extrait les métadonnées de sensibilité des sources de données prises en charge. Ces sources de données incluent Stockage Blob Azure, Azure Data Lake Storage Gen2 (ADLS Gen2), SharePoint dans Microsoft 365 et Microsoft OneLake. Les étiquettes extraites sont stockées dans l’index en même temps que le contenu du document.

Au moment de la requête, Foundry IQ vérifie l'étiquette de confidentialité de chaque document, le jeton Microsoft Entra de l'utilisateur et les stratégies Purview de l'organisation pour déterminer l'accès. Le système retourne des documents uniquement si l’identité et les autorisations basées sur l’étiquette de l’utilisateur autorisent l’accès sous les stratégies Purview configurées.

Ce modèle inclut les composants suivants :

  • Configurez votre index, votre source de données et votre indexeur (à des fins de planification) à l’aide de l’API 2026-11-01-preview REST ou d’un sdk en préversion qui prend en charge l’ingestion d’étiquette Purview.
  • Activez une identité managée affectée par le système sur votre service Foundry IQ. Les identités managées attribuées par l’utilisateur ne sont pas prises en charge pour l’extraction des étiquettes Purview. La propre identité du service doit disposer des autorisations Purview élevées. Votre administrateur général de locataire ou administrateur de rôle privilégié accorde ensuite l’accès requis pour permettre au service Foundry IQ de s’authentifier auprès de Microsoft Purview et d’extraire les métadonnées d’étiquette.
  • Appliquez des étiquettes de confidentialité aux documents avant l’indexation afin que le système puisse les reconnaître et les conserver pendant l’ingestion.
  • Au moment de la requête, attachez un jeton de Microsoft Entra valide via l’en-tête x-ms-query-source-authorization à chaque demande de requête. Foundry IQ évalue le jeton et les métadonnées d’étiquette associées pour appliquer le contrôle d’accès basé sur l’étiquette.

L’application des étiquettes de confidentialité Purview est limitée aux scénarios à locataire unique et nécessite l’authentification RBAC. Pendant la préversion, elle est prise en charge uniquement par le biais de l'API REST et de SDK Azure. Les API Autocomplete et Suggest ne sont actuellement pas disponibles pour les index compatibles avec Purview.

Où les étiquettes de confidentialité sont exposées

Avant que le système puisse appliquer des étiquettes au moment de la requête ou les retourner dans les réponses de récupération, vous devez d’abord synchroniser les métadonnées d’étiquette dans l’index. Les deux chemins de consommation décrits dans cette section dépendent de cette étape de synchronisation. Vous pouvez synchroniser des étiquettes soit en configurant un indexeur Foundry IQ directement avec une source de données prise en charge, soit en activant l’option d’ingestion équivalente lors de la création d’une source de connaissances. Dans les deux cas, votre environnement doit respecter les prérequis de configuration de synchronisation des métadonnées d’étiquette de confidentialité (identité managée, RBAC sur le service Foundry IQ et les autorisations requises Microsoft Purview et de source de données). Pour connaître la configuration de l’indexeur de bout en bout, consultez Utiliser les indexeurs Foundry IQ pour ingérer des étiquettes de confidentialité Microsoft Purview. Pour l’ingestion pilotée par la source de connaissances, définissez ingestionPermissionOptions de façon à inclure sensitivityLabel lors de la création de la source de connaissances.

Après avoir synchronisé les étiquettes, deux chemins de requête consomment les mêmes métadonnées d’étiquette indexées. Choisissez le chemin qui correspond à la façon dont votre application appelle Foundry IQ :

Si la source de connaissances pointe vers un index découpé en segments, par exemple alimenté par une vectorisation intégrée ou par une compétence personnalisée de division du texte, l’ensemble de compétences doit également projeter l’étiquette de confidentialité vers chaque ligne de segment. En l'absence de cette projection, les références au niveau des segments ne sont pas filtrées.

Pour plus d’informations, consultez Utiliser les indexeurs Foundry IQ pour ingérer des étiquettes de confidentialité Microsoft Purview.

Appliquer des autorisations au niveau du document au moment de la requête

L’application des contrôles sur les requêtes basée sur des jetons est une fonctionnalité transversale qui s’applique aux étendues ACL et RBAC de type POSIX, aux étiquettes de confidentialité Microsoft Purview et aux modèles de listes de contrôle d’accès (ACL) SharePoint dans Microsoft 365. En utilisant les requêtes natives basées sur des jetons, Foundry IQ valide le jeton Microsoft Entra de l’appelant à chaque requête et restreint les ensembles de résultats aux seuls documents que l’appelant est autorisé à lire conformément aux ACL du document, à condition que les métadonnées ACL du document soient synchronisées avec l’index.

Lorsque vous joignez le jeton de l’utilisateur à une requête via l’en-tête x-ms-query-source-authorization, Foundry IQ :

  1. Extrait du jeton les déclarations d’utilisateur, de groupe et de portée.
  2. Compare ces revendications aux métadonnées d’autorisation stockées en même temps que les documents indexés (entrées ACL, étendues RBAC, affectations d’étiquettes Purview ou SharePoint ACL).
  3. Retourne uniquement les documents dont les métadonnées d’autorisation synchronisées accordent l’accès de l’appelant.

Actualisation de l’autorisation

L’application du temps des requêtes utilise des métadonnées d’autorisation stockées, mais la fraîcheur dépend du type d’autorisation. Les ACL des utilisateurs et des groupes ADLS sont des instantanés indexés : les modifications apportées uniquement aux ACL utilisent une actualisation automatique activée par défaut, environ quotidienne lors des exécutions normales éligibles, ou une resynchronisation explicite des autorisations. Les portées RBAC du conteneur identifient les ressources, et non les attributions de rôles ; l’autorisation de l’utilisateur délégué est évaluée séparément lors de la requête, en tenant compte de la propagation et des caches. La résolution d’appartenance au groupe a également son propre comportement de propagation et de mise en cache.

Pour SharePoint, le traitement incrémentiel couvre les modifications détectées au niveau des éléments ainsi que les modifications prises en charge des autorisations des dossiers non racine, y compris les descendants inchangés. D’autres périmètres ou des notifications manquées peuvent nécessiter une actualisation explicite. Consultez Synchroniser les autorisations entre le contenu indexé et le contenu source pour le tableau des scénarios et les limitations en matière de délais.

L’actualisation des autorisations ne permet pas une révocation immédiate ni un contrat SLA d’actualisation à l’échelle du corpus. Pour connaître les étapes opérationnelles, les échecs, la cohérence des segments et le nettoyage, consultez la synchronisation ADLS, l’actualisation de la portée Blob et la synchronisation SharePoint. L’ingestion par poussée personnalisée reste chargée de synchroniser ses métadonnées.

Pour connaître les étapes d’implémentation de requête de bout en bout, consultez l’application des ACL et du RBAC au moment de la requête dans Foundry IQ.

Avantages du contrôle d’accès au niveau du document

Le contrôle d’accès au niveau du document natif dans Foundry IQ offre des avantages concrets par rapport au filtrage côté application :

  • Réduit le code d’autorisation personnalisé : Foundry IQ gère la résolution de groupe et le filtrage des autorisations pris en charge pendant l’exécution de la requête.
  • S’aligne sur les contrôles de conformité existants : La réutilisation des métadonnées d’autorisations de Microsoft Entra, de Microsoft Purview et de SharePoint permet de maintenir les résultats de recherche cohérents avec le système d’identité source. Passez en revue le modèle de synchronisation d’autorisations pour chaque source afin de comprendre ses limitations.
  • Respecte les autorisations de la source après chaque synchronisation ACL : Pour les approches basées sur des jetons (ACL, étendues RBAC, étiquettes Purview, SharePoint ACL), l’application au moment de la requête utilise les métadonnées d’autorisation que le mécanisme de synchronisation spécifique à la source documenté (exécution de l’indexeur, mise à jour de l’API push ou actualisation Purview) a déjà écrites dans l’index.
  • Améliore les performances par rapport à l’élagage après exécution de la requête : Le filtrage dans le pipeline de recherche est plus rapide que le chargement de jeux de résultats plus volumineux dans votre application pour les élaguer dans celle-ci, en particulier lorsque le volume de requêtes est élevé.
  • Réutilise votre infrastructure d’identité existante : les identités Microsoft Entra et SharePoint font foi pour les décisions de contrôle d’accès, ce qui réduit la duplication des identités et la charge opérationnelle liée à la maintenance d’un magasin parallèle d’autorisations.

Tutoriels et exemples

Explorez le contrôle d’accès au niveau du document dans Foundry IQ avec d’autres articles et exemples.