Mapper des utilisateurs et des groupes externes aux Now Platform utilisateurs

Recherche IA Les mappages d’utilisateurs externes vous permettent de configurer des alias d’utilisateur et de groupe définis en externe pour Now Platform les utilisateurs. Recherche IA utilise ces principaux de sécurité aliasés pour appliquer des filtres de sécurité de contenu qui contrôlent l’accès des utilisateurs aux résultats de recherche indexés à partir de documents externes.

Vous pouvez utiliser des noms d’utilisateur et de groupe externes mappés lors de la définition des autorisations d’accès pour les documents externes que vous ingérez pour l’indexation via l’API d’ingestion de contenu externe.

Vue d'ensemble

Pour configurer les mappages utilisateur pour la sécurité du contenu externe, vous devez effectuer les étapes suivantes :

1. Créez une ou plusieurs tables de mappage utilisateur. Pour obtenir des instructions sur cette procédure, reportez-vous à la section Créer une table de mappage d’utilisateurs.
2. Liez une ou plusieurs de vos tables de mappage d’utilisateurs à chacune de vos sources indexées de contenu externe. Pour obtenir des détails sur cette tâche, reportez-vous à Lier les tables de mappage utilisateur aux sources indexées de contenu externe.
   Remarque :

   Si aucun mappage n’est trouvé pour l’utilisateur actuel Now Platform , Recherche IA seul l’utilisateur peut afficher les résultats de recherche pour les documents externes dont l’autorisation everyone est définie sur vrai. Cela peut se produire si aucune table de mappage d’utilisateur n’est liée à la source indexée d’un résultat de recherche, ou si aucun mappage pour l’utilisateur actuel Now Platform n’existe dans les tables de mappage d’utilisateur lié de la source indexée.
3. Importez les mappages utilisateur dans vos tables de mappage utilisateur avec l’icône Recherche IA API de mappage des utilisateurs externes.

Les utilisateurs disposant du ais_high_security_admin rôle peuvent examiner les enregistrements d’historique pour les opérations d’importation afin de vérifier que les mappages d’utilisateurs sont importés correctement. Pour obtenir des instructions sur cette procédure, reportez-vous à la section Afficher les enregistrements d’historique pour les opérations d’importation de mappage des utilisateurs.

Mappage d’utilisateur externe Types principaux de sécurité

Recherche IA Les alias de mappage utilisateur peuvent inclure des principaux de sécurité d’utilisateur et de groupe définis en externe.

Type principal de sécurité mappé	Description
Groupe défini de façon externe	L’utilisateur Now Platform spécifié dans le mappage d’utilisateur hérite des autorisations d’accès au niveau du groupe pour tous les groupes externes avec alias. Par exemple, si vous définissez le groupe report-users externe comme alias pour Now Platform l’utilisateur [e-mail], Recherche IA permet [e-mail] d’afficher les résultats de recherche indexés pour les documents externes qui incluent une autorisation d’accès en lecture pour report-users.
Utilisateur défini de façon externe	L’utilisateur Now Platform spécifié dans le mappage d’utilisateurs hérite des autorisations d’accès au niveau de l’utilisateur pour tous les utilisateurs externes avec alias. Par exemple, si vous définissez un utilisateur ad\abel-tuter externe comme alias d’utilisateur Now [e-mail], Recherche IA permet [e-mail] d’afficher les résultats de recherche indexés pour les documents externes qui incluent une autorisation d’accès en lecture pour ad\abel-tuter.

Créer une table de mappage d’utilisateurs

Définissez une table pour stocker les alias d’utilisateur et de groupe définis en externe pour Now Platform les utilisateurs.

Avant de commencer

Il Contenu externe pour Recherche IA module d’extension (com.glide.ais.external_content) doit être activé dans votre instance.

Rôle requis : ais_admin

Pourquoi et quand exécuter cette tâche

Les tables de mappage utilisateur stockent les mappages utilisateur à utiliser avec des documents externes disposant d’autorisations d’accès. Chaque mappage spécifie des alias d’utilisateur et de groupe définis en externe pour un utilisateur individuel Now Platform . Recherche IA utilise les mappages liés à la source indexée d’un document externe pour déterminer si un Now Platform utilisateur peut afficher l’enregistrement indexé du document.

Toutes les tables de mappage des utilisateurs étendent la Recherche IA table Base de mappage des utilisateurs pour la recherche externe [ais_external_search_user_mapping].

Procédure

1. Accédez à la Tous > Recherche IA > Contenu externe > Créer un mappage utilisateur.
2. Entrez un nom pour votre table de mappage d’utilisateurs.
3. Sélectionnez Envoyer.
   Le formulaire Dictionnaire de votre nouvelle table de mappage d’utilisateurs s’affiche.

Que faire ensuite

Importez les mappages des utilisateurs dans votre nouvelle table de mappage des utilisateurs. Pour obtenir une vue d’ensemble de ce processus, reportez-vous à la section Importation de mappages d’utilisateurs. Pour plus d’informations sur le point de terminaison d’API pertinent, consultez Recherche IA API de mappage des utilisateurs externes.

Lier les tables de mappage utilisateur aux sources indexées de contenu externe

Spécifiez les tables de mappage utilisateur que vous souhaitez Recherche IA utiliser pour les documents externes ingérés via une source indexée.

Avant de commencer

Il Contenu externe pour Recherche IA module d’extension (com.glide.ais.external_content) doit être activé dans votre instance.

La table source de la source indexée doit être une table de schéma de contenu externe.

Rôle requis : ais_admin

Pourquoi et quand exécuter cette tâche

Les mappages d’utilisateurs liés à une source indexée définissent les alias d’utilisateur et de groupe externes pour Now Platform les utilisateurs. Recherche IA utilise ces mappages pour déterminer les autorisations d’accès effectives d’un utilisateur lorsque sa recherche correspond à un enregistrement de la source indexée.

Un mappage utilisateur peut être lié à n’importe quel nombre de sources indexées, et vous pouvez lier plusieurs mappages utilisateur à une seule source indexée.

Remarque :

Si aucun mappage n’est trouvé pour l’utilisateur actuel Now Platform , Recherche IA seul l’utilisateur peut afficher les résultats de recherche pour les documents externes dont l’autorisation everyone est définie sur vrai. Cela peut se produire si aucune table de mappage d’utilisateur n’est liée à la source indexée d’un résultat de recherche, ou si aucun mappage pour l’utilisateur actuel Now Platform n’existe dans les tables de mappage d’utilisateur lié de la source indexée.

Procédure

1. Accédez à la Tous > Recherche IA > Recherche IA Index > Sources indexées.
2. Ouvrez l’enregistrement de source indexée auquel vous souhaitez lier les mappages d’utilisateurs.
3. Dans la liste connexe Relations de la source de données de la Recherche IA table de mappage des utilisateurs pour la recherche externe, effectuez les étapes suivantes pour chaque mappage d’utilisateur que vous souhaitez lier à la source indexée :
   1. Sélectionnez Nouveau.
   2. Renseignez les champs du formulaire Relation de la source de données de la Recherche IA table de mappage des utilisateurs pour recherche externe.
   3. Sélectionnez Envoyer.
      Le nom de la table de mappage utilisateur apparaît dans la liste connexe.

Importation de mappages d’utilisateurs

Vous pouvez utiliser l’API Recherche IA de mappage des utilisateurs externes pour importer des mappages entre Now Platform les utilisateurs et les utilisateurs et groupes définis en externe.

Pour définir un mappage utilisateur pour l’importation, vous avez besoin des informations suivantes :

• Adresse e-mail qui identifie de manière unique un Now Platform utilisateur dans la table Utilisateur [sys_user].
• La liste des groupes définis en externe que vous souhaitez utiliser comme alias pour l’utilisateur Now Platform . Cette liste peut être vide.
• La liste des utilisateurs définis en externe que vous souhaitez utiliser comme alias pour l’utilisateur Now Platform . Cette liste peut être vide.

Pour plus d’informations sur l’importation de mappages d’utilisateurs, consultez Recherche IA API de mappage des utilisateurs externes.

Afficher les enregistrements d’historique pour les opérations d’importation de mappage des utilisateurs

Passez en revue les résultats de vos opérations d’importation de mappage des utilisateurs, y compris les données, les messages de journal et toutes les erreurs. Procédez comme suit pour vérifier que vos mappages d’utilisateurs sont importés correctement.

Avant de commencer

Rôle requis : ais_admin, ais_high_security_adminet import_transformer.

Pourquoi et quand exécuter cette tâche

Recherche IA crée un jeu d’importation pour chaque lot de mappages d’utilisateurs que vous importez via Recherche IA API de mappage des utilisateurs externes. Les historiques de transformation de ces jeux d’importation fournissent un aperçu des résultats de vos opérations d’importation de mappage des utilisateurs.

Procédure

1. Élevez-le ais_high_security_admin au rôle en effectuant les étapes suivantes :
   1. Effectuez l’action appropriée pour votre version de l’interface utilisateur :

      Version d’interface utilisateur	Action
      Interface utilisateur Next Experience	Dans la bannière, sélectionnez l’icône de votre compte pour ouvrir le menu utilisateur, puis sélectionnez Élever le rôle.
      Interface utilisateur principale	Dans la bannière, sélectionnez votre nom pour ouvrir le menu utilisateur, puis sélectionnez Élever les privilèges des rôles.

      Une boîte de dialogue s’affiche, affichant une liste de vérification de vos rôles privilégiés disponibles.

      

   2. Dans la boîte de dialogue, sélectionnez l’option ais_high_security_admin , puis sélectionnez Mettre à jour (dans Next Experience l’interface utilisateur) ou OK.
      La page se recharge et un indicateur de rôle élevé s’affiche à côté de votre nom d’utilisateur dans le menu utilisateur. Dans Next Experience l’interface utilisateur, cet indicateur affiche les noms des rôles privilégiés actifs. Dans Interface utilisateur principale, l’indicateur affiche l’icône de rôle élevé ( ).

      

      Remarque :

      Lorsque la page se recharge à nouveau, toutes les modifications non enregistrées sont perdues.
2. Accédez à la Tous > Recherche IA > Contenu externe > Historique des importations de mappages de l'utilisateur.
3. Pour chaque enregistrement d’historique d’importation de mappage d’utilisateur que vous souhaitez examiner, procédez comme suit :
   1. Ouvrez l’enregistrement de l’historique des importations de mappage des utilisateurs.
   2. Dans le formulaire Enregistrement de l’historique de mappage des utilisateurs de Recherche IA contenu externe, sélectionnez le lien connexe Afficher l’historique de transformation .
      La table Historique des transformations [sys_import_set_run] s’ouvre, avec un filtre appliqué au jeu d’importation à partir de l’enregistrement d’historique des importations de mappage de l’utilisateur sélectionné.
   3. Ouvrez l’enregistrement de l’historique des transformations.
   4. Passez en revue les résultats des jeux d’importation sur le formulaire, les erreurs dans la liste connexe Erreurs de ligne du jeu d’importation et les messages de journal dans la liste connexe Journal d’importation.