---
sourceDocument: Brésil Sécurité de la plateforme
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/platform-security

 Release :

    - brazil

ft:locale :

    - fr-FR

ft:publication_title :

    - Brésil Sécurité de la plateforme

ft:clusterId :

    - psec

bundleId :

    - psec

workflow :

    - Platform


---

# Écriture de scripts LDAP

# Écriture de scripts LDAP {#ariaid-title1}

Rversion finale: Brazil  
Mis à jour 10 sept. 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture  
Créez des cartes de transformation, des scripts et des règles métier personnalisés pour spécifier les exigences lors de l'importation de données.
Les cartes de transformation personnalisées doivent inclure des scripts `de transformation onStart` et `onAfter` .  
Le script `onStart` doit appeler l'include `de script LDAPUtils` et commencer la journalisation. Par exemple, la carte de transformation d'importation d'utilisateur LDAP a un script `onStart` qui utilise ce code :

    gs.include ( "LDAPUtils" ) ; var ldapUtils  = new LDAPUtils ( ) ;
    ldapUtils. setLog (log ) ;

Le script `onAfter` doit appeler la fonction `addMembers` . Par exemple :

    ldapUtils.addMembers (source , target ) ;

## Définir les utilisateurs Active Directory désactivés sur inactifs {#ariaid-title2}

Utilisez le script suivant pour désactiver automatiquement des utilisateurs lorsque l'utilisateur AD associé est désactivé.

### Avant de commencer

Rôle requis : admin

### Pourquoi et quand exécuter cette tâche

Vous pouvez identifier les utilisateurs Active Directory désactivés en vérifiant la valeur de l'attribut `userAccountControl` . Cette règle s'exécute chaque fois que la valeur `userAccountControl` change et désactive les comptes d'utilisateurs si le contrôle de compte d'utilisateur signifie un compte AD désactivé.

Utilisez le script suivant pour désactiver automatiquement des utilisateurs lorsque l'utilisateur AD associé est désactivé.

### Procédure

1. Configurez le formulaire Utilisateur et créez un champ de nombre entier appelé Contrôle de compte utilisateur.
2. Ajoutez le mappage pour userAccountControl (externe) au nouveau champ.
3. Créez une règle métier avec les propriétés suivantes :  
   {#t_SetDisabledADUsersToInactive__table_uc1_bhs_gq__entry__2}

   | Champ de règle métier | Valeur |
   |-|-|
   | Nom | Désactiver les utilisateurs AD |
   | Table | Utilisateur \[sys_user\] |
   | Quand | avant |
   | Condition | current.u_user_account_control.changes() |
   [Tableau 1. Désactiver la règle métier des utilisateurs AD]

   {#t_SetDisabledADUsersToInactive__table_uc1_bhs_gq}

   Le champ Script doit contenir les éléments suivants :  

       var disabledFlag = 2;
       //perform a bitwise comparison on userAccountControl to see if the 2 bit flag is enabled
       if (current.u_user_account_control & disabledFlag) {
         gs.log('Disabling user: ' + current.user_name + 'userAccountControl=' + current.u_user_account_control);
         current.active='false';
         current.locked_out='true';
       }

## Affecter des valeurs de champ LDAP {#ariaid-title3}

Vous pouvez utiliser un script pour affecter une valeur à n'importe quel champ pour lequel il existe un mappage de champ.
Par exemple, pour affecter une valeur au champ sys_user.société, créez une carte de champs pour le champ Société et ajoutez un script de transformation de :  

    company = "Don's Sporting Goods";

## Exclure des utilisateurs LDAP particuliers {#ariaid-title4}

Si vous ne pouvez pas filtrer complètement la liste d'utilisateurs LDAP à l'aide des propriétés de filtre LDAP, vous pouvez exclure les utilisateurs avec un script de carte.
Une fois que vous avez exécuté la logique pour identifier un utilisateur qui ne doit pas être importé, définissez le champ user_name sur une chaîne vide et cet utilisateur ne sera pas importé.  

    user_name='';

Une façon d'identifier les utilisateurs à filtrer consiste à rechercher une chaîne dans l'attribut `distinguishedName` . Par exemple, ce script exclut les comptes qui ne sont pas dans une unité d'utilisateur Vous pouvez utiliser ce script si vous avez trop d'unités organisationnelles d'utilisateurs à inclure dans l'option LDAP de l'unité organisationnelle cible.  

    //vdn is a variable mapped to distinguishedName
    gs.include("LDAPUtils");
    var vdn = source.getElement(this.distinguishedName);
    if (vdn.indexOf('OU=Users')<0) {
      user_name='';
      gs.log('LDAP Import Skipping User: ' + vdn);
    }

Une méthode de filtrage plus complexe consiste à utiliser des expressions régulières.  

    //vcn is a variable mapped to cn
    //vdn is a variable mapped to distinguishedName
    //c is the regular expression string
    gs.include("LDAPUtils");
    var vdn = source.getElement(this.distinguishedName);
    var vcn = source.getElement(this.cn);
    var c = /^[a-z][a-z][a-z][0-9][0-9][0-9]$/;
    var nvcn = vcn.toLowerCase();
    //test to see if the cn is in the form of 3 letters followed by 3 numbers, only import these
    if (c.test(nvcn)) {
    	user_name = nvcn;
    } else {
    	gs.log("LDAP import rejected username: " + vcn + " for DN: " + vdn);
    	user_name = "";
    }


