La fonction VaToolBxJavaLDAPSearch permet de se connecter à un serveur LDAP afin d'effectuer une recherche suivant un contexte donné, à partir d'un filtre de recherche, de la profondeur de recherche souhaitée (profondeur de niveau 1 ou jusqu'aux feuilles). Seuls les attributs souhaités des résultats sont récupérés en retour. Les paramètres nécessaires à la connexion au serveur LDAP sont le nom d'hôte, l'utilisateur, le mot de passe, la version du serveur LDAP.
Prérequis : il est nécessaire d'avoir dans le contexte d'exécution le fichier jndi.jar.
Ce fichier est inclus dans Tomcat 4.1. Sous Websphere 5, les classes de jndi.jar sont incluses dans server.jar.
Domaine d'application
Client Java,
Serveur Java,
Client Adélia Web,
Client Adélia Cloud.
Paramètres
ALPHA(n) |
Hote |
Nom de l'hôte. Ce nom peut optionnellement être préfixé par le protocole à utiliser, c'est-à-dire "ldap://" ou "ldaps://". L'utilisation de "ldaps://" permet d'activer la prise en charge de la connexion SSL. Par défaut, le protocole "ldap://" est utilisé. |
NUM_BIN_2 |
Port |
Numéro du port. |
NUM_BIN_2 |
Version |
Version du protocole LDAP (2 ou 3). |
ALPHA(n) |
Utilisateur |
Nom d'utilisateur. |
ALPHA(n) |
MotDePasse |
Mot de passe associé à l'utilisateur. |
ALPHA(n) |
Contexte |
Nom du contexte de recherche (ex : "O=HARDIS", "OU=ADELIA, O=HARDIS"). |
NUM_BIN_2 |
Niveau |
Niveau de recherche : 1 (OBJECT_SCOPE) ou 2 (SUBTREE_SCOPE). |
ALPHA(n) |
Filtre |
Filtre de recherche (ex : "objectClass=inetOrgPerson"). |
ALPHA(n) |
Attribut(m) |
Tableau des attributs à récupérer en retour de la recherche (ex : "member", "sn" (nom de famille), "cn" (nom complet), "givenname" (prénom), "uid" (ID utilisateur), "dn" (DN distinguished name), "mail" (adresse mail)). |
ALPHA(n) |
Resultats(m) |
Tableau des résultats. |
BOOL |
CodeRetour |
Code retour de l'opération : *VRAI si l'opération s'est déroulée correctement. *FAUX dans le cas contraire. |
Remarque : les seuls paramètres en sortie sont la table des résultats et le code retour.
Exemple
ALPHA(50) |
Hote |
NUM_BIN_2 |
Port |
NUM_BIN_2 |
Version |
ALPHA(50) |
User |
ALPHA(50) |
Password |
ALPHA(50) |
Contexte |
NUM_BIN_2 |
Niveau |
ALPHA(50) |
Filtre |
ALPHA(50) |
Attributs_SEL(2) |
ALPHA(250) |
Resultats(50) |
BOOL |
CodeRetour |
Hote |
= 'srvweb.hardis.fr' |
Port |
= 389 |
Version |
= 3 |
User |
= 'JDupont' |
Password |
= 'pwddupont' |
Contexte |
= 'O=HARDIS' |
Filtre |
= 'objectClass=inetOrgPerson' |
Attributs_SEL(1) |
= 'mail' |
Attributs_SEL(2) |
= 'member' |
APPELER_DLL 'VaToolBx' 'VaToolBxJavaLDAPSearch' Hote Port Version User Password Contexte Niveau Filtre Attributs_Sel Resultats CodeRetour
Liste des fonctions de la DLL VaToolBx par thème