Les annuaires : LDAP et Active Directory
Partie 3 sur 4
5Nommer une entrée : RDN, DN et LDIF
5.1Le modèle de nommage
Le modèle de nommage (ou de désignation) définit la façon dont les objets sont nommés et classés. Les objets sont classés hiérarchiquement et possèdent un espace de noms homogène : d’un annuaire à l’autre, un objet de même classe porte le même nom, ce qui garantit l’interopérabilité, c’est-à-dire la capacité de fonctionner ensemble.
LDAP version 3 désigne un objet de deux façons. Le nom relatif (RDN, Relative Distinguished Name) est composé d’une paire (ou de plusieurs) clé et valeur, par exemple cn=Pillou ou c=fr. Il doit respecter des critères : un objet n’a qu’un seul RDN ; il doit être unique dans la branche, c’est-à-dire à un même niveau ; il peut être composé de plusieurs attributs, il est alors dit multivalué (par exemple cn=pillou+sn=jeff) ; et l’on conseille de choisir comme RDN un attribut obligatoire. Le nom distinctif (DN, Distinguished Name) est le moyen d’identifier un objet de façon unique dans l’arbre : on le construit en prenant le RDN de l’entrée et en y ajoutant, l’un derrière l’autre, ceux de ses parents jusqu’à la racine. Le DN est donc la concaténation de tous les RDN de ses ascendants (figure 2).
dn: uid=ada,ou=people,dc=example,dc=org
Ici le RDN est uid=ada, et le reste désigne les ancêtres : le service people, puis la racine, écrite avec des composants de domaine (dc, domain component) : dc=example,dc=org correspond au nom de domaine example.org. La norme recommande en effet de compléter le DN, qui ne contient aucune information sur la localisation de l’annuaire lui-même, par l’adresse DNS du serveur (voir le DNS). On rencontre aussi une forme ancienne, o=exemple,c=fr (une organisation dans un pays), qui suit la logique de X.500 ; la forme par composants de domaine s’est généralisée, en particulier avec Active Directory. On voit aussi des DN comme uid=ada,cn=lovelace,givenname=augusta, qui mélangent des attributs sans hiérarchie réelle : à éviter. Un bon DN reflète une structure d’organisation réelle.
5.2Le format LDIF
LDAP fournit un format d’échange en texte simple, LDIF, pour importer et exporter un annuaire. La majorité des serveurs le gèrent, d’où une grande interopérabilité. Voici l’entrée d’une personne, avec des données d’exemple :
dn: uid=ada,ou=people,dc=example,dc=org objectClass: inetOrgPerson cn: Ada Martin sn: Martin givenName: Ada mail: ada.martin@example.org mail: ada@example.org telephoneNumber: +33 1 23 45 67 89
La syntaxe est la suivante. Chaque entrée commence par sa ligne dn:, suivie de lignes attribut: valeur. Un numéro d’identification positif facultatif peut précéder la ligne dn. Chaque nouvelle entrée est séparée de la précédente par une ligne vide. Un attribut peut s’écrire sur plusieurs lignes : les lignes de suite commencent par un espace ou une tabulation. Pour donner plusieurs valeurs à un attribut, on répète la ligne nom: valeur (comme les deux adresses ci-dessus). Quand une valeur contient un caractère spécial (non imprimable, espace en début de valeur, deux-points), l’attribut est suivi de deux deux-points (::) et la valeur est codée en base64 (un codage qui représente n’importe quelles données avec un alphabet de 64 caractères sûrs). La syntaxe générale s’écrit aussi entre chevrons, dn: <distinguished name> et <attribut> : <valeur>.
Pour s’exercer
Exercice 2 : lire un DN
Soit cn=Jeanne Durand,ou=compta,ou=paris,dc=example,dc=org. Donnez le RDN, le parent direct et la racine. Pourquoi ce DN ne peut-il pas désigner deux personnes ?
Voir la réponse
Le RDN est cn=Jeanne Durand ; le parent direct est ou=compta,ou=paris,dc=example,dc=org ; la racine est dc=example,dc=org. Un DN est unique : le RDN est unique dans sa branche, et la suite des RDN des ancêtres désigne un chemin unique de la racine à l’entrée. Deux homonymes dans le même service doivent donc recevoir un RDN différent (par exemple en ajoutant l’identifiant uid).
Exercice 3 : écrire une entrée LDIF
Écrivez l’entrée de Bob Lefèvre, classe inetOrgPerson, dans ou=people,dc=example,dc=org, avec l’adresse bob@example.org.
Voir la réponse
dn: uid=bob,ou=people,dc=example,dc=org objectClass: inetOrgPerson cn: Bob Lefèvre sn: Lefèvre mail: bob@example.org
Le è n’est pas un caractère ASCII : certains outils exigent alors un codage en base64 avec ::. cn et sn sont obligatoires dans cette classe.
6OpenLDAP : monter son propre annuaire
De nombreux tutoriels expliquent comment installer et utiliser un serveur LDAP libre, OpenLDAP (« projet libre de serveur d’annuaire conforme à la norme LDAP 3 », dérivé de l’implémentation de l’université du Michigan, sous licence GNU GPL, donc gratuit et dont les sources sont publiques). Ceux qui décrivent une version ancienne (1.2) sont dépassés : beaucoup de gestes ont changé. Voici l’essentiel, d’abord la méthode d’autrefois, puis ce qu’on fait aujourd’hui.
6.1Les composants et l’installation
OpenLDAP comprenait quatre éléments : le serveur LDAP slapd (le démon, un programme qui tourne en arrière-plan), une passerelle LDAP vers X.500 appelée ldapd, le serveur de réplication slurpd, et des outils d’administration. Aujourd’hui, la passerelle a disparu, et slurpd a été supprimé dans la version 2.4 au profit d’un mécanisme de réplication intégré à slapd, nommé syncrepl (de mémoire). La version courante est de la série 2.6.
Autrefois, l’installation se faisait de deux façons : par un paquet RPM (le format de paquets de Red Hat et Mandrake) avec une commande du type rpm -ivh openldap-1.2.9-5mdk.i586.rpm, ou en compilant les sources : se mettre en administrateur (root), décompresser l’archive dans /usr/local/src avec tar zxvf, copier le modèle Make-common.dist en Make-common, y décommenter des lignes (pour construire slapd, choisir le gestionnaire de base de données gdbm de GNU), régler dans un fichier d’en-tête la machine par défaut (LDAPHOST) et la base de recherche par défaut, puis compiler. Aujourd’hui, une seule commande suffit : sudo apt install slapd ldap-utils sous Debian et Ubuntu, sudo dnf install openldap-servers openldap-clients sous Fedora. Les répertoires, eux, sont restés proches : /etc/openldap (ou /etc/ldap sous Debian) pour la configuration, /var/lib/ldap pour l’annuaire, et /usr/share/openldap pour la documentation et des outils, dont ceux qui migrent un système de comptes NIS existant (Network Information Service, les « pages jaunes » d’Unix) vers LDAP. Les pages de manuel (man) et les commandes se trouvent dans les répertoires habituels.
6.2Préparer la configuration
On commence par faire l’inventaire des objets et des informations à stocker. Prenons pour projet une gestion centralisée des carnets d’adresses d’un intranet doté d’une messagerie Qmail : chaque utilisateur était décrit par son prénom et son adresse électronique, et tous feraient partie d’une société fictive située en France, d’où la racine o=exemple,c=fr (o pour organization, c pour country). Le même raisonnement vaut pour vous, avec une racine du type dc=example,dc=org.
Les fichiers de configuration sont dans /etc/openldap. Le texte en citait trois : slapd.conf (racine de l’annuaire, administrateur principal et son mot de passe, droits d’accès par défaut, fichiers d’objets et de syntaxe à utiliser, règles d’accès aux entrées et aux attributs) ; les fichiers d’objets en oc.conf (object classes), par défaut slapd.oc.conf, qui déclarent chaque objet ; les fichiers d’attributs en at.conf (attribute types), par défaut slapd.at.conf, qui donnent la syntaxe de chaque attribut. On pouvait créer des objets ou attributs personnalisés dans de nouveaux fichiers, inclus par la directive include. Depuis la version 2.3, ce modèle à fichiers est remplacé par une configuration stockée dans l’annuaire lui-même, sous une branche cn=config, modifiable à chaud ; le fichier slapd.conf est dit obsolète, mais on le rencontre encore.
# extrait de slapd.conf, dans l'esprit des premières versions include /etc/openldap/slapd.at.conf include /etc/openldap/slapd.oc.conf pidfile /var/run/slapd.pid argsfile /var/run/slapd.args suffix "dc=example,dc=org" rootdn "cn=admin,dc=example,dc=org" directory /var/lib/ldap defaultaccess read
Que signifient ces lignes ? include charge les autres fichiers ; pidfile et argsfile sont les fichiers qui retiennent le numéro du processus et les arguments du serveur ; suffix définit la racine de l’annuaire ; rootdn désigne le compte d’administration de l’annuaire (« un nom arbitraire, et pas forcément un utilisateur du système ») ; directory donne le répertoire de stockage ; defaultaccess read accorde par défaut le droit de lecture à tous. Il comprenait aussi une ligne pour vérifier ou non la conformité aux classes d’objets (schemacheck) et le mot de passe de l’administrateur écrit en clair. Ce fichier contient le mot de passe en clair : il faut donc impérativement fixer ses droits à rw------- avec chmod 600. C’est une très mauvaise pratique : aujourd’hui, on y met une empreinte (un mot de passe brouillé, produit par la commande slappasswd) et jamais le mot de passe lui-même (voir les mots de passe).
6.3Les droits d’accès : l’ordre compte
Les droits se donnent avec la directive access, dont voici la syntaxe : access to <une partie de l'arbre> [by <une personne> <droits>], avec les droits none (aucun), search (rechercher), read (lire) et write (écrire). Un point est essentiel : l’ordre d’écriture des règles a une grande importance. Un exemple : si une règle donne le droit de recherche seul sur la branche o=exemple,c=fr et qu’une règle suivante donne le droit de lecture sur l’ensemble c=fr, la première protège la sous-branche. Si l’on inverse l’ordre, la règle large est la première à correspondre et elle seule est appliquée ; la protection de la sous-branche disparaît. On écrit donc les règles les plus précises en premier, les plus générales ensuite. C’est exactement la logique des règles d’un pare-feu (voir le pare-feu).
6.4Démarrer le serveur
Autrefois, pour que le serveur démarre automatiquement aux « niveaux d’exécution » 3, 4 et 5 de Linux (les niveaux d’exécution, run levels, étaient les états de démarrage du système, du mode texte au mode graphique) et s’arrête aux niveaux 0, 1, 2 et 6, on tapait chkconfig --level 345 ldap on et chkconfig --level 0126 ldap off, commandes qui créaient des liens symboliques de type S70ldap et K40ldap dans les répertoires rc3.d à rc6.d ; puis on lançait /etc/rc.d/init.d/ldap start. Aujourd’hui, un seul geste remplace tout cela : sudo systemctl enable --now slapd.
6.5Remplir l’annuaire avec ldapadd
Pour saisir des informations, on crée d’abord deux fichiers texte au format LDIF : l’un pour la société, qui est la racine, l’autre pour une personne. Dans notre exemple, le premier fichier, racine.ldif, contient :
dn: dc=example,dc=org objectClass: dcObject objectClass: organization dc: example o: Exemple description: Annuaire de test
On l’ajoute avec ldapadd :
ldapadd -x -D "cn=admin,dc=example,dc=org" -W -f racine.ldif
Le paramètre -D donne le DN du compte avec lequel on se connecte, -W demande à l’écran le mot de passe (jamais affiché), et -f indique le fichier LDIF à insérer. L’option -w secret donne aussi le mot de passe sur la ligne de commande, en clair : elle ne devrait servir qu’à la mise au point de scripts. C’est en réalité une mauvaise idée même là, car la ligne de commande est visible des autres utilisateurs de la machine ; on préfère la lecture du mot de passe dans un fichier protégé. On ajoute l’option -x (authentification simple). Le serveur répond adding new entry "dc=example,dc=org". Pour ajouter une personne, on écrit sur le même modèle un fichier personne.ldif (voir l’entrée d’Ada à la partie 5.2). Deux remarques : plusieurs personnes peuvent figurer dans le même fichier en les séparant par une ligne blanche ; et on peut mettre un attribut mail sur un objet person qui ne le prévoit pas, grâce à la directive schemacheck off qui désactive la vérification du schéma. Cette dérogation est à éviter : le schéma est justement là pour garantir la qualité des données, et on utilise plutôt la classe inetOrgPerson, qui prévoit mail.
6.6Chercher avec ldapsearch
ldapsearch -x -b "dc=example,dc=org" "(objectClass=person)" ldapsearch -x -b "dc=example,dc=org" "(cn=Martin*)" ldapsearch -x -b "dc=example,dc=org" "(mail=*@example.org)" cn mail
L’option -b précise le point de départ de la recherche (la « base »). Le deuxième argument est un filtre, écrit entre parenthèses : le premier cherche tous les objets de la classe person (les utilisateurs saisis), le deuxième toutes les entrées dont le nom commence par Martin (l’étoile remplace n’importe quels caractères), le troisième les adresses d’un domaine, en ne demandant que les attributs cn et mail. On peut combiner les filtres avec & (et), | (ou), ! (non) : (&(objectClass=person)(sn=Martin)).
6.7Modifier et supprimer
Autant le dire sans détour : « la modification de l’annuaire n’est pas une opération facile ». Il faut d’abord écrire dans un fichier les modifications à faire, puis lancer ldapmodify. Pour changer le téléphone d’Ada :
dn: uid=ada,ou=people,dc=example,dc=org changetype: modify replace: telephoneNumber telephoneNumber: +33 1 98 76 54 32
ldapmodify -x -v -D "cn=admin,dc=example,dc=org" -W -f modif.ldif
La directive replace remplace une valeur ; on peut aussi add (ajouter une valeur à un attribut, ou un attribut à l’objet, ce que l’on note +description=...) ou delete (supprimer un attribut, par exemple le courriel). Pour supprimer une entrée entière, on utilise ldapdelete, avec le DN complet de l’objet à détruire et le compte qui exécute l’opération ; l’option -v (verbose, mode bavard) affiche deleting entry "...".
ldapdelete -x -v -D "cn=admin,dc=example,dc=org" -W "uid=bob,ou=people,dc=example,dc=org"
Enfin, pour réinitialiser complètement l’annuaire, il faut détruire la base existante en vidant le répertoire /var/lib/ldap (avec une commande de suppression récursive), puis relancer le serveur après avoir porté les changements dans la configuration. C’est une opération irréversible : on ne la fait qu’avec une sauvegarde.
Pour s’exercer
Exercice 4 : l’ordre des règles
Dans OpenLDAP, vous voulez que tout le monde lise l’annuaire, sauf la branche ou=rh, réservée au groupe RH. Dans quel ordre écrivez-vous les règles access ?
Voir la réponse
D’abord la règle précise : access to dn.subtree="ou=rh,dc=example,dc=org" by group="cn=rh,ou=groups,dc=example,dc=org" read by * none, ensuite la règle générale : access to * by * read. Dans l’ordre inverse, la règle générale correspondrait la première et la protection de la branche RH disparaîtrait.