Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
ACL-aware extraction sur des bases de connaissances gérées
Lorsque la prise en compte des ACL est activée sur une source de données de base de connaissances gérée, vous filtrez les résultats des requêtes en transmettant un contexte utilisateur dans votre demande Retrieve. La base de connaissances gérée Bedrock renvoie uniquement les documents auxquels l'utilisateur fourni est autorisé à accéder. Pour un aperçu du fonctionnement de la prise en charge des ACL, du modèle d'identité, de la prise en charge des connecteurs et de vos responsabilités lors de son activation, consultezSensibilisation aux listes de contrôle d'accès.
Important
La prise en compte des ACL permet de ACL-aware filtrer et non d'autoriser. La base de connaissances gérée Bedrock n'authentifie pas les utilisateurs finaux. Votre application doit authentifier les utilisateurs et transmettre le contexte d'identité vérifié. Pour en savoir plus, consultez Sensibilisation aux listes de contrôle d'accès.
Utilisation de UserContext dans les demandes de récupération
Pour effectuer la ACL-aware récupération, incluez le userContext champ dans votre demande de récupération. userContextSpécifie l'identité de l'utilisateur. userIdIl s'agit toujours de l'adresse e-mail universelle de l'utilisateur associée à la source de données sous-jacente.
{ "knowledgeBaseId": "your-knowledge-base-id", "retrievalQuery": { "text": "your query" }, "userContext": { "userId": "user@example.com" } }
Si vous ne fournissez aucun résultat userContext dans une demande Retrieve, ACL-enabled les sources de données ne renvoient aucun résultat. Non-ACL les sources de données de la même base de connaissances renvoient normalement les résultats.
Comportement de récupération avec les ACL
Lorsque la prise en compte des ACL est activée, les comportements suivants s'appliquent :
-
Contexte utilisateur requis pour les sources de ACL-enabled données : si vous ne fournissez pas de contexte utilisateur dans une demande de récupération, les sources de ACL-enabled données ne renvoient aucun résultat. Non-ACL les sources de données de la même base de connaissances renvoient normalement les résultats.
-
L'absence de métadonnées ACL signifie inaccessible : si un document d'une source de ACL-enabled données ne possède aucune ACL (par exemple, le connecteur n'a pas réussi à extraire les autorisations ou le document est public), ce document n'est renvoyé à aucun utilisateur. Les autorisations manquantes sont considérées comme restreintes et non comme publiques.
-
Sources de données mixtes : vous pouvez avoir des sources de données à la fois ACL-enabled et des sources non ACL dans la même base de connaissances. Les documents provenant de sources de données autres que l'ACL sont renvoyés à tous les utilisateurs, quel que soit le contexte de l'utilisateur.
-
Résultats partiels — Lorsque la vérification ACL en temps réel refuse l'accès à certains documents, la réponse peut contenir moins de résultats que ceux demandés
maxResults. La base de connaissances gérée de Bedrock ne contient pas de documents supplémentaires. Votre application doit traiter les réponses avec moins de résultats que ceux demandés. -
Refuser les dérogations autorisées — Si un utilisateur apparaît à la fois dans une liste d'autorisation et dans une liste de refus pour un document, l'accès est refusé.
Note
Third-party les informations d'identification du fournisseur d'identité sont mises en cache pendant une heure maximum. L'accès peut se poursuivre jusqu'à ce que le cache soit actualisé.
Les modifications apportées aux autorisations de contrôle d'accès sont finalement cohérentes. Les mises à jour prennent généralement effet en quelques minutes.
Résolution des problèmes
Si la ACL-aware récupération ne renvoie aucun résultat ou des résultats inattendus, la cause est généralement spécifique au connecteur : autorisations, informations d'identification ou configuration de l'ACL. Consultez les instructions de dépannage relatives à votre connecteur :
