Créer un mappage d’attribut SCIM

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture
  • Créez un mappage d’attribut 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

    Voici les types de mappage d’attributs et leurs descriptions.
    Tableau 1. Types de mappages d’attributs
    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 mot de passe 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 Tout > Client SCIM > Mappage des ressources de fournisseur SCIM.
    2. A sélectionné le mappage de ressources 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’attribut 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 du fournisseur.

      Nom du schéma

      Nom du 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 (le 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

      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 e-mail professionnel, 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 comporter 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 comme travail, mobile, maison, etc

      Unique

      Option permettant d’identifier de façon unique une ressource entre les systèmes Client SCIM et 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 d’attributs au nom de la ServiceNow table. Si vous choisissez le mappage direct des attributs, vous devez définir ce champ.

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

      Nom du champ de base de données

      Le champ Nom du 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 direct des attributs, 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 du champ doivent être Aucun.

      Par exemple, la valeur du sous-attribut primaire de l’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 d’attribut complexe, un script peut fournir la valeur au niveau d’un attribut ou d’un sous-attribut.

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

      Script

      Script utilisé pour extraire la valeur de l’attribut.

      Le type de retour du script 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.