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

Recettes de requêtes LDAP

Des requêtes toutes faites pour les questions d’administration courantes, chacune expliquée. Elles ne s’exécutent nulle part : copiez la commande et lancez-la vous-même. Chaque recette est aussi disponible dans l’installeur (/aide/ldap/recettes), où ses paramètres se modifient et où elle se charge dans le constructeur de requêtes. Les exemples supposent la base dc=exemple,dc=fr et la date indiquée.

Comptes

Comptes bloqués par un administrateur

Identifiant comptes-bloques-par-un-administrateur · niveau intermédiaire

Comptes verrouillés sans limite de durée par un administrateur : le délai de déverrouillage automatique ne les libère pas.

Pourquoi ça marche. ppolicy réserve la valeur 000001010000Z de pwdAccountLockedTime au verrouillage sans fin, posé à la main : le filtre cherche exactement cette valeur.

Filtre :

(pwdAccountLockedTime=000001010000Z)

Commande :

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 \
  '(pwdAccountLockedTime=000001010000Z)' uid cn mail pwdAccountLockedTime

Équivalent Active Directory :

Get-ADUser -LDAPFilter '(userAccountControl:1.2.840.113556.1.4.803:=2)' -SearchBase 'DC=exemple,DC=fr' -SearchScope Subtree -Properties userAccountControl
  • -SearchBase : les unités d’Open IAM (ou=users, ou=groups…) n’existent pas dans AD ; la recherche part de la racine du domaine.
  • AD désactive un compte par le bit 2 (ACCOUNTDISABLE) de userAccountControl ; la règle d’appariement 1.2.840.113556.1.4.803 (ET bit à bit) teste ce bit.

Remarques

  • pwdAccountLockedTime n’est lisible que par cn=openiam-admins, le Service Desk et le titulaire.

Comptes créés depuis N jours

Identifiant comptes-crees-recemment · niveau débutant

Comptes créés au cours des N derniers jours : arrivées récentes à vérifier.

Pourquoi ça marche. L’annuaire date chaque entrée à sa création dans createTimestamp ; on garde celles dont la date est postérieure à « aujourd’hui moins N jours ».

Filtre :

(&(objectClass=inetOrgPerson)(createTimestamp>={depuis}))
ParamètreSignificationTypeDéfautBornes
{depuis}Créés depuis (jours) (Nombre de jours écoulés depuis la création.)nombre de jours écoulés301 à 3650

Exemple (depuis = 30, le 3 novembre 2026 à 12:00:00 UTC) :

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)(createTimestamp>=20261004120000Z))' uid cn mail createTimestamp

Équivalent Active Directory :

Get-ADUser -LDAPFilter '(whenCreated>=20261004120000.0Z)' -SearchBase 'DC=exemple,DC=fr' -SearchScope Subtree -Properties whenCreated
  • -SearchBase : les unités d’Open IAM (ou=users, ou=groups…) n’existent pas dans AD ; la recherche part de la racine du domaine.

Remarques

  • createTimestamp est un attribut opérationnel : il faut le demander par son nom ou par +, ce que fait la commande.

Comptes inactifs depuis N jours

Identifiant comptes-inactifs · niveau débutant

Comptes qui ne se sont pas connectés à l’annuaire depuis N jours : candidats à une revue des accès.

Pourquoi ça marche. OpenLDAP enregistre la date de la dernière connexion réussie dans pwdLastSuccess (overlay lastbind). On garde les comptes dont cette date est antérieure à « aujourd’hui moins N jours ».

Filtre :

(&(objectClass=inetOrgPerson)(pwdLastSuccess<={depuis}))
ParamètreSignificationTypeDéfautBornes
{depuis}Inactifs depuis (jours) (Nombre de jours sans connexion réussie.)nombre de jours écoulés901 à 3650

Exemple (depuis = 90, le 3 novembre 2026 à 12:00:00 UTC) :

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)(pwdLastSuccess<=20260805120000Z))' uid cn mail pwdLastSuccess

Équivalent Active Directory :

Get-ADUser -LDAPFilter '(lastLogonTimestamp<=134304048000000000)' -SearchBase 'DC=exemple,DC=fr' -SearchScope Subtree -Properties lastLogonTimestamp
  • -SearchBase : les unités d’Open IAM (ou=users, ou=groups…) n’existent pas dans AD ; la recherche part de la racine du domaine.
  • lastLogonTimestamp n’est mis à jour qu’avec un retard de plusieurs jours (14 par défaut) : comptez large.

Prérequis

  • Overlay lastbind (olcLastBind: TRUE), installé par Open IAM.

Remarques

  • Un compte qui ne s’est jamais connecté n’a pas pwdLastSuccess : voir la recette « Comptes jamais utilisés ».

Comptes jamais utilisés

Identifiant comptes-jamais-utilises · niveau débutant

Comptes qui ne se sont jamais connectés à l’annuaire.

Pourquoi ça marche. pwdLastSuccess n’apparaît qu’après une première connexion réussie : le NON d’une présence, (!(pwdLastSuccess=*)), retient les comptes qui n’ont pas cet attribut.

Filtre :

(&(objectClass=inetOrgPerson)(!(pwdLastSuccess=*)))

Commande :

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)(!(pwdLastSuccess=*)))' uid cn mail createTimestamp pwdLastSuccess

Équivalent Active Directory :

Get-ADUser -LDAPFilter '(!(lastLogonTimestamp=*))' -SearchBase 'DC=exemple,DC=fr' -SearchScope Subtree -Properties lastLogonTimestamp,whenCreated
  • -SearchBase : les unités d’Open IAM (ou=users, ou=groups…) n’existent pas dans AD ; la recherche part de la racine du domaine.

Prérequis

  • Overlay lastbind (olcLastBind: TRUE), installé par Open IAM.

Remarques

  • Un compte créé avant l’activation de lastbind figure ici même s’il a servi : croisez avec sa date de création (createTimestamp).

Comptes verrouillés

Identifiant comptes-verrouilles · niveau débutant

Comptes verrouillés par la politique de mots de passe après trop d’échecs de connexion, ou par un administrateur.

Pourquoi ça marche. La politique de mots de passe (ppolicy) pose pwdAccountLockedTime sur un compte qu’elle verrouille et le retire au déverrouillage : il suffit de chercher les comptes qui portent cet attribut.

Filtre :

(&(objectClass=inetOrgPerson)(pwdAccountLockedTime=*))

Commande :

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

Équivalent Active Directory :

Get-ADUser -LDAPFilter '(lockoutTime>=1)' -SearchBase 'DC=exemple,DC=fr' -SearchScope Subtree -Properties lockoutTime
  • -SearchBase : les unités d’Open IAM (ou=users, ou=groups…) n’existent pas dans AD ; la recherche part de la racine du domaine.
  • AD remet lockoutTime à 0 au déverrouillage : (lockoutTime=*) renverrait aussi les comptes déverrouillés.

Remarques

  • pwdAccountLockedTime n’est lisible que par cn=openiam-admins, le Service Desk et le titulaire : avec un autre compte, la recherche ne renvoie rien.

Mots de passe

Mots de passe inchangés depuis N jours

Identifiant mots-de-passe-anciens · niveau intermédiaire

Comptes dont le mot de passe n’a pas changé depuis N jours.

Pourquoi ça marche. ppolicy enregistre la date du dernier changement dans pwdChangedTime. Avec une validité de V jours, les mots de passe qui expirent sous N jours sont ceux inchangés depuis V − N jours. Le préréglage ANSSI d’Open IAM n’impose pas d’expiration : la recette sert alors à repérer les mots de passe anciens.

Filtre :

(&(objectClass=inetOrgPerson)(pwdChangedTime<={depuis}))
ParamètreSignificationTypeDéfautBornes
{depuis}Inchangés depuis (jours) (Nombre de jours depuis le dernier changement de mot de passe.)nombre de jours écoulés3651 à 3650

Exemple (depuis = 365, le 3 novembre 2026 à 12:00:00 UTC) :

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)(pwdChangedTime<=20251103120000Z))' uid cn mail pwdChangedTime

Équivalent Active Directory :

Get-ADUser -LDAPFilter '(pwdLastSet<=134066448000000000)' -SearchBase 'DC=exemple,DC=fr' -SearchScope Subtree -Properties pwdLastSet
  • -SearchBase : les unités d’Open IAM (ou=users, ou=groups…) n’existent pas dans AD ; la recherche part de la racine du domaine.
  • pwdLastSet à 0 signifie « doit changer son mot de passe à la prochaine connexion ».

Remarques

  • pwdChangedTime n’est lisible que par cn=openiam-admins, le Service Desk et le titulaire.
  • Un compte importé avec son mot de passe peut ne pas avoir pwdChangedTime : il n’apparaît pas ici.

Groupes

Membres d’un groupe

Identifiant membres-d-un-groupe · niveau débutant

Comptes membres directs d’un groupe d’Open IAM.

Pourquoi ça marche. L’overlay memberof tient à jour, sur chaque compte, la liste de ses groupes (memberOf) : chercher memberOf égal au DN du groupe donne ses membres.

Filtre :

(memberOf={groupe})
ParamètreSignificationTypeDéfautBornes
{groupe}Groupe (Nom (cn) d’un groupe sous ou=groups.)nom de groupeopeniam-admins—

Exemple (groupe = openiam-admins) :

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 \
  '(memberOf=cn=openiam-admins,ou=groups,dc=exemple,dc=fr)' uid cn mail memberOf

Équivalent Active Directory :

Get-ADUser -LDAPFilter '(memberOf:1.2.840.113556.1.4.1941:=cn=openiam-admins,ou=groups,dc=exemple,dc=fr)' -SearchBase 'DC=exemple,DC=fr' -SearchScope Subtree -Properties memberOf
  • -SearchBase : les unités d’Open IAM (ou=users, ou=groups…) n’existent pas dans AD ; la recherche part de la racine du domaine.
  • Adaptez le DN du groupe à l’arborescence d’AD (CN=…,OU=…,DC=…) ; la règle 1.2.840.113556.1.4.1941 (« dans la chaîne ») suit aussi les groupes imbriqués.

Remarques

  • Membres directs seulement : l’overlay dynlist d’Open IAM ne sert qu’aux groupes dynamiques (groupOfURLs).

Qualité des données

Comptes sans adresse e-mail

Identifiant comptes-sans-mail · niveau débutant

Comptes qui n’ont pas d’adresse e-mail.

Pourquoi ça marche. (!(mail=*)) est le NON d’une présence : il retient les entrées qui n’ont aucune valeur pour mail.

Filtre :

(&(objectClass=inetOrgPerson)(!(mail=*)))

Commande :

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)(!(mail=*)))' uid cn sn givenName

Équivalent Active Directory :

Get-ADUser -LDAPFilter '(!(mail=*))' -SearchBase 'DC=exemple,DC=fr' -SearchScope Subtree
  • -SearchBase : les unités d’Open IAM (ou=users, ou=groups…) n’existent pas dans AD ; la recherche part de la racine du domaine.

Remarques

  • Self Service Password ne peut pas envoyer à ces comptes de lien de réinitialisation.