Créer un mappage d’attribut SCIM

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture
  • Créez un mappage d’attributs SCIM et utilisez-le comme source unique de ressource pour les champs de table ServiceNow .

    Avant de commencer

    Rôles requis : admin

    Pourquoi et quand exécuter cette tâche

    Vous trouverez ci-dessous les types de mappage d’attributs et leurs descriptions.
    Tableau 1. Types de mappage d’attribut
    Type de mappage d’attribut Description
    Direct L’attribut SCIM est renseigné à l’aide des champs Nom de la table de base de données et Nom du champ de base de données .
    Constante L’attribut SCIM est renseigné à l’aide d’une valeur par défaut spécifiée.
    Script/Personnalisé L’attribut SCIM est renseigné à l’aide de la valeur de retour d’un script. Cet attribut nécessite l’activation de l’option Exécuter le script.
    Remarque :
    • L’attribut password n’est pas pris en charge
    • Un exemple de mappage d’attributs pour les ressources Utilisateur et Groupe fait partie du système de base. Vous pouvez utiliser et configurer les mappages en fonction de vos besoins, ou vous pouvez créer un nouvel enregistrement.

    Procédure

    1. Accédez à la Tous > Client SCIM > Mappage des ressources de fournisseur SCIM.
    2. Sélectionnez le mappage de ressource SCIM créé pour la configuration.
    3. Dans la liste connexe Mappages d’attributs SCIM, cliquez sur Nouveau.
      Mappage des ressources de fournisseur SCIM
    4. Renseignez les champs du formulaire.
      Tableau 2. Formulaire Mappages d’attributs SCIM
      Champs Description
      Mappage des ressources de fournisseur

      Mappage d’attributs pour une combinaison fournisseur-ressource.

      Si ce champ n’est pas renseigné automatiquement, utilisez l’option de recherche. Sélectionnez l’enregistrement Mappage des ressources de fournisseur.

      Nom du schéma

      Nom de schéma de l’attribut SCIM pour lequel le mappage doit être défini.

      Par exemple, urn:ietf:params:scim:schemas:core:2.0:User.

      Attribut

      Attribut pour lequel le mappage doit être défini. Par exemple, userName.

      Sous-attribut

      Sous-attribut (cas échéant) pour lequel le mappage doit être défini.

      Par exemple, s’il existe un attribut de type complexe comme name.familyName, alors l’attribut est name et le sous-attribut est familyName.

      Type de champ

      Le type de données Attribut SCIM. Ce champ est renseigné automatiquement à partir des schémas définis par le fournisseur SCIM.

      Par exemple, booléen.

      Multivaleur

      Plusieurs valeurs affectées à l’attribut. Un attribut peut avoir plusieurs valeurs, comme l’e-mail professionnel, l’e-mail personnel ou un autre e-mail.

      Par exemple, emails.

      Ce champ est renseigné à l’aide des schémas définis par le fournisseur SCIM.

      Condition de filtre

      Certains attributs à valeurs multiples peuvent contenir des informations supplémentaires qui peuvent être spécifiées à l’aide d’une condition de filtre. Les choix de condition de filtre sont renseignés à l’aide des schémas définis par le fournisseur SCIM.

      Par exemple, l’attribut phoneNumbers a plusieurs types tels que travail, mobile, domicile, etc

      Unique

      Option permettant d’identifier de façon unique une ressource entre les systèmes du client SCIM et du fournisseur SCIM. Les attributs à valeurs multiples ne peuvent pas être marqués comme uniques.

      Par exemple, pour une ressource utilisateur, l’attribut username peut être rendu unique.

      Nom de table de base de données Utilisez ce champ pour mapper le nom de la table attributaire au nom de la ServiceNow table. Si vous choisissez le mappage d’attribut direct, vous devez définir ce champ.

      Par exemple, l’attribut username SCIM peut être mappé au champ Utilisateur dans le champ Nom de la table de base de données .

      Nom du champ de base de données

      Le champ Nom de champ de base de données mappe l’attribut SCIM au ServiceNow nom de champ à mapper avec l’attribut SCIM. Si vous choisissez le mappage d’attribut direct, vous devez définir ce champ.

      Par exemple, l’attribut username SCIM peut être mappé au champ ID d’utilisateur dans le champ Nom du champ de base de données .

      Valeur par défaut

      Détails sur la valeur par défaut transmise au fournisseur SCIM.

      Peut être utilisé sile mappage d’attribut direct du champ renvoie null, ou si la valeur par défaut peut être utilisée pour renvoyer une valeur codée en dur.

      Dans le cas d’une valeur codée en dur, le nom de la table de base de données et le nom de champ doivent être Aucun.

      Par exemple, la valeur du sous-attribut primaire d’un e-mail professionnel peut être codée en dur comme vrai.

      Exécuter le script

      Option permettant d’extraire la valeur de l’attribut via le script.

      Cette option est requise pour les attributs à valeurs multiples qui ne contiennent pas de condition de filtre. Pour un type complexe d’attribut, un script peut fournir la valeur au niveau d’un attribut ou d’un sous-attribut.

      Par exemple, l’attribut Members de la ressource de groupe n’a aucune condition de filtre. Ainsi, l’option de script doit être définie au niveau de l’attribut parent de l’attribut Members .

      Script

      Script utilisé pour extraire la valeur d’attribut.

      Le type de script de retour doit être une chaîne ou un JSON converti en chaîne.

      La sortie du script doit être au format approprié, comme prévu par le fournisseur pour cet attribut.

    5. Cliquez sur Envoyer.