Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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éfixeSensExempleSe 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’attribut uid. 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.

QuestionActive DirectoryOpen IAM
Comptes verrouillésGet-ADUser -LDAPFilter '(lockoutTime>=1)'(&(objectClass=inetOrgPerson)(pwdAccountLockedTime=*))
Comptes sans e-mailGet-ADUser -LDAPFilter '(!(mail=*))'(&(objectClass=inetOrgPerson)(!(mail=*)))

Exercices

  1. Que retient (&(objectClass=inetOrgPerson)(|(title=Comptable)(title=Paie))) ?
  2. Écrivez le filtre des personnes dont le nom de famille commence par « Dur ».
  3. Écrivez le filtre des personnes dont l’identifiant n’est pas admin, sans retenir celles qui n’ont pas d’identifiant.
  4. Un collègue venu d’AD lance (sAMAccountName=jdupont) sur l’annuaire Open IAM et n’obtient rien. Pourquoi, et que doit-il écrire ?
  5. (pwdAccountLockedTime=*) ne renvoie rien alors qu’un compte est verrouillé. Donnez deux causes possibles.
Corrigés
  1. Les personnes dont la fonction est Comptable ou Paie.
  2. (&(objectClass=inetOrgPerson)(sn=Dur*)).
  3. (&(objectClass=inetOrgPerson)(uid=*)(!(uid=admin))). Sans (uid=*), le NON retiendrait aussi les personnes sans uid.
  4. sAMAccountName n’existe que dans AD ; l’identifiant d’un compte Open IAM est uid : (uid=jdupont).
  5. 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 sous ou=groups, ou une portée one au lieu de sub.

Pour aller plus loin