LDAP LOGIN

La commande LDAP LOGIN ouvre une connexion en lecture seule sur le serveur LDAP désigné par le paramètre url avec les identifiants login et motDePasse fournis. Si elle est acceptée par le serveur, cette connexion sera utilisée pour toutes les recherches LDAP effectuées par la suite dans le process courant, jusqu'à ce que la commande LDAP LOGOUT soit exécutée (ou que le process soit terminé).

Dans url, passez l'URL complet du serveur LDAP auquel se connecter, incluant le scheme et le port (389 by default). Ce paramètre doit être conforme à la rfc2255.
Vous pouvez ouvrir une connexion sécurisée via TLS en passant un url qui débute par "ldaps" et qui utilise un numéro de port spécifique (par exemple "ldaps://svr.ldap.acme.com:1389"). Le serveur LDAP doit généralement disposer d'un certificat SSL (c'est le cas pour MS Active Directory). Il est fortement recommandé d'utiliser une connexion TLS lorsque le mot de passe est transmis en texte brut (voir ci-dessous).

Note : Si vous passez une chaîne vide dans le paramètre url, la commande tentera de se connecter au serveur LDAP par défaut disponible sur le domaine (cette fonction est destinée uniquement aux besoins liés aux tests, pour des raisons de performances elle ne doit pas être utilisée en production).

Dans login, passez le compte utilisateur sur le serveur LDAP et dans motDePasse, passez le mot de passe du compte. Le login peut prendre l'une des formes suivantes, en fonction de la configuration du serveur LDAP :

• un Distinguished Name (DN), par exemple "CN=John Smith,OU=users,DC=example,DC=com"
• un nom d'utilisateur (CN), par exemple "CN=John Smith"
• une adresse email, par exemple "johnsmith@4d.fr"
• un SAM-Account-Name, par exemple "jsmith".

Notez que les valeurs admises pour le login sont liées au mode de transmission du mot de passe, défini par le paramètre digest. Par exemple, dans une configuration par défaut de MS Active Directory :

• Lorsque le mode de transmission est LDAP mot de passe en digest MD5, la seule valeur acceptée pour une connexion utilisateur est le SAM-Account-Name.
• Lorsque le mode de transmission est LDAP mot de passe en clair (texte brut), le paramètre login peut contenir soit un DN, un CN ou une adresse email. Un SAM-Account-Name peut être utilisé s'il est précédé du nom de domaine (par exemple "dc-acme.com/jsmith").

Le paramètre digest vous permet de modifier le mode de transmission du mot de passe sur le réseau. Vous pouvez utiliser une des constantes suivantes, placées dans le thème "LDAP" :

Note : L'authentification avec un mot de passe vide vous permet d'activer le mode de connexion anonyme (s'il est autorisé par le serveur LDAP). Cependant, des erreurs pourront être générées si vous essayez d'effectuer des opérations non autorisées dans ce mode spécifique.

Si les paramètres de connexion sont valides, une connexion au serveur LDAP est ouverte dans le process 4D. Vous pouvez alors rechercher et récupérer des informations à l'aide des commandes LDAP.

N'oubliez pas d'appeler la commande LDAP LOGOUT lorsque la connexion au serveur LDAP n'est plus nécessaire.

Vous voulez vous connecter à un serveur LDAP et effectuer une recherche :

Cet exemple tente de se connecter à une application :