Comprendre les filtres LDAP
Ce que vous allez comprendre
- Lire un filtre LDAP et dire en une phrase quelles entrées il retient.
- Écrire un filtre simple : égalité, présence, ET, OU, NON, comparaison de date.
- Traduire un filtre Active Directory courant pour l’annuaire Open IAM, et l’inverse.
- Expliquer pourquoi une recherche ne renvoie rien : compte, TLS, base, portée ou droits.
Prérequis : savoir ouvrir un terminal. Comptez une demi-heure, exercices compris.
Le problème concret
L’annuaire contient des milliers d’entrées : comptes, groupes, comptes de service. Pour savoir quels comptes sont verrouillés, ou qui ne s’est pas connecté depuis trois mois, on ne parcourt pas l’annuaire à la main. On lui envoie un filtre, c’est-à-dire une condition qu’il teste sur chaque entrée. Il ne renvoie que les entrées pour lesquelles la condition est vraie. La RFC 4515 fixe la syntaxe. Elle est courte, mais déroutante au premier abord, surtout quand on vient d’Active Directory.
L’analogie
Pensez au tri du courrier d’une mairie. La consigne « toutes les lettres adressées au service des sports, sauf les publicités » combine une condition (le destinataire), une exclusion (le NON) et un ET implicite. Un filtre LDAP est cette même consigne, écrite pour que la machine n’ait qu’une lecture possible. Chaque condition est entre parenthèses, et l’opérateur se place devant ce qu’il combine.
Le modèle
Une condition
Une condition s’écrit (attribut opérateur valeur) :
(mail=jean.dupont@exemple.fr)
Ce filtre retient les entrées dont l’adresse e-mail est jean.dupont@exemple.fr. Les autres
opérateurs s’écrivent de la même façon : (cn=Dup*) (commence par), (pwdAccountLockedTime=*)
(l’attribut est présent), (createTimestamp>=20260101000000Z) (supérieur ou égal). La liste
complète est dans Opérateurs des filtres LDAP.
Combiner des conditions
On combine par un préfixe placé devant les conditions, dans une parenthèse de plus :
| Préfixe | Sens | Exemple | Se lit |
|---|---|---|---|
& | ET | (&(objectClass=inetOrgPerson)(mail=*)) | les personnes qui ont une adresse e-mail |
| | OU | (|(cn=Dupont)(cn=Durand)) | les entrées nommées Dupont ou Durand |
! | NON | (!(mail=*)) | les entrées sans adresse e-mail |
Les combinaisons s’imbriquent : (&(objectClass=inetOrgPerson)(!(mail=*))) se lit « les
personnes qui n’ont pas d’adresse e-mail ». Pour lire un filtre long, partez de l’extérieur et
nommez chaque parenthèse.
Ce que LDAP n’a pas
- Pas de « différent de ». On écrit le NON d’une égalité,
(!(uid=jdupont)). Ce filtre retient aussi les entrées qui n’ont pas l’attributuid. Pour les exclure, ajoutez(uid=*)dans un ET. - Pas de « strictement ».
>=et<=incluent la borne.(!(a>=v))signifie « strictement inférieur à v ».
Caractères spéciaux et dates
Dans une valeur, *, (, ), \ et le caractère NUL s’écrivent \2a, \28, \29, \5c et
\00. Ainsi (cn=*) cherche les entrées qui ont un nom, et (cn=\2a) un nom égal à une étoile.
OpenLDAP écrit les dates en GeneralizedTime UTC : 20261103120000Z pour le 3 novembre 2026 à
12:00 UTC. Active Directory utilise souvent un autre format, FILETIME. La
table de correspondance indique la conversion de chaque
attribut.
Base, portée et droits
Le filtre ne suffit pas. La recherche part d’une base (ou=users,dc=exemple,dc=fr pour les
comptes d’Open IAM) et descend selon une portée (base, one ou sub). Elle se fait avec un
compte de liaison, c’est-à-dire le compte avec lequel vous vous connectez. L’annuaire Open IAM
refuse les connexions anonymes et exige TLS (ldaps://). Il ne montre certains attributs, comme
pwdAccountLockedTime, qu’aux administrateurs, au Service Desk et au titulaire.
ldapsearch -H ldaps://annuaire.exemple.fr -x \
-D 'uid=votre-identifiant,ou=users,dc=exemple,dc=fr' -W \
-b 'ou=users,dc=exemple,dc=fr' -s sub -LLL \
'(&(objectClass=inetOrgPerson)(pwdAccountLockedTime=*))' uid cn mail pwdAccountLockedTime
-W demande le mot de passe au lancement : il n’apparaît jamais dans la commande.
D’Active Directory à OpenLDAP
La syntaxe est la même des deux côtés. Ce sont les attributs qui changent. sAMAccountName
devient uid, lockoutTime devient pwdAccountLockedTime, lastLogonTimestamp devient
pwdLastSuccess, et la classe user devient inetOrgPerson. Avec PowerShell, Get-ADUser
cherche déjà des comptes, donc la condition de classe disparaît du filtre.
| Question | Active Directory | Open IAM |
|---|---|---|
| Comptes verrouillés | Get-ADUser -LDAPFilter '(lockoutTime>=1)' | (&(objectClass=inetOrgPerson)(pwdAccountLockedTime=*)) |
| Comptes sans e-mail | Get-ADUser -LDAPFilter '(!(mail=*))' | (&(objectClass=inetOrgPerson)(!(mail=*))) |
Exercices
- Que retient
(&(objectClass=inetOrgPerson)(|(title=Comptable)(title=Paie)))? - Écrivez le filtre des personnes dont le nom de famille commence par « Dur ».
- Écrivez le filtre des personnes dont l’identifiant n’est pas
admin, sans retenir celles qui n’ont pas d’identifiant. - Un collègue venu d’AD lance
(sAMAccountName=jdupont)sur l’annuaire Open IAM et n’obtient rien. Pourquoi, et que doit-il écrire ? (pwdAccountLockedTime=*)ne renvoie rien alors qu’un compte est verrouillé. Donnez deux causes possibles.
Corrigés
- Les personnes dont la fonction est Comptable ou Paie.
(&(objectClass=inetOrgPerson)(sn=Dur*)).(&(objectClass=inetOrgPerson)(uid=*)(!(uid=admin))). Sans(uid=*), le NON retiendrait aussi les personnes sansuid.sAMAccountNamen’existe que dans AD ; l’identifiant d’un compte Open IAM estuid:(uid=jdupont).- Le compte de liaison n’a pas le droit de lire
pwdAccountLockedTime, que seuls les administrateurs, le Service Desk et le titulaire peuvent lire. Autre cause possible : la base ou la portée ne couvrent pas le compte, par exemple une recherche sousou=groups, ou une portéeoneau lieu desub.
Pour aller plus loin
- Recettes de requêtes LDAP : des filtres tout faits, expliqués, avec leur commande et leur équivalent AD.
- Correspondance Active Directory ↔ OpenLDAP.
- Dans l’installeur, le constructeur de requêtes (
/aide/ldap/requete) écrit un filtre et l’explique condition par condition. Il n’exécute rien sur l’annuaire.