Cette page est en cours de rédaction.
Apportez votre aide…
Un serveur d'annuaire avec OpenLDAP
Ce document est la traduction du HowTo présenté à l'adresse https://wiki.ubuntu.com/OpenLDAPServer.
LDAP signifie Lightweight Directory Access Protocol, c'est une version simplifiée du protocole X500. Vous pourrez trouver une présentation détaillée sur Wikipédia.
Pour expliquer rapidement, toutes les informations sont stockées dans un arbre. Vous devez déterminer l'arborescence des annuaires ou, autrement dit, des informations de l'arbre (Directory Information Tree). Nous allons commencer ici avec un exemple simple contenant seulement 2 nœuds en plus de la racine :
- Le nœud "People" , où seront stockés vos utilisateurs,
- Le nœud "Groups" , où seront enregistrés vos groupes.
Vous devez commencer par déterminer ce que sera la racine de votre LDAP. Par défaut, votre arbre peut être déterminé à partir de votre domaine Internet. Si votre domaine est exemple.com , votre racine sera dc=exemple,dc=com .
Installation
Avant tout, installons le daemon du serveur ldap (slapd) sur le serveur. Pour cela, il suffit d'installer les paquets slapd.
On vous demandera votre mot de passe administrateur et votre nom de domaine. Renseignez-les. Parfois on ne vous demandera que le mot de passe et on ne vous demandera rien concernant le nom de domaine car l'installeur récupère directement le nom de domaine de la machine. Si vous souhaitez renseigner ces champs faites :
sudo dpkg-reconfigure slapd
Voici brièvement les réponses attendues pour une installation standard :
1.Passer la configuration d'OpenLDAP ? non 2.Nom de domaine ? example.com 3.Nom de votre société ? masociété 4.Quelle base de donnée ? hdb 5.Voulez-vous que la base de donnée soit effacée lorsque slapd est purgé ? oui 6.Supprimer les anciennes bases de données ? oui 7.Mot de passe administrateur ? VotreMotDePasse 8.Confirmer ce mot de passe ? VotreMotDePasse 9.Authoriser le protocol LDAPv2 ? non
Mais seulement quelques changements seront effectués sur la configuration par défaut. Tout le reste va se jouer dans le fichier /etc/ldap/slapd.conf.
Nous allons commencer par enregistrer le mot de passe administrateur (de LDAP) dans le fichier de configuration en éditant ce fichier. Ce serait une folie de vouloir enregistrer votre mot de passe en clair donc nous allons générer votre mot de passe en chiffré avec la commande :
sudo slappasswd
On obtient quelque chose dans ce genre :
sudo slappasswd New password: Re-enter password: {SSHA}d2BamRTgBuhC6SxC0vFGWol31ki8iq5m
Cet exemple montre la définition de votre mot de passe en utilisant le mot de passe "secret". (D'après l'implémentation de SSHA, votre résultat peut varier) .
Éditez le fichier /etc/ldap/ldap.conf avec les droits administrateurs.
S'il n'est pas déjà présent, créez ce fichier avec les droits administrateurs. On renseigne alors les informations suivantes :
ldap_version 3 URI ldap://localhost:389 SIZELIMIT 0 TIMELIMIT 0 DEREF never BASE dc=example, dc=com
Toutes les informations relatives à slapd.d (dossier remplaçant slapd.conf) sont maintenant inscrites au moment où on lance la commande dpkg-reconfigure slapd
Remplir LDAP
L' annuaire a été créé lors de l'installation, il est maintenant temps de le remplir. Il sera rempli avec des entrées classiques qui seront compatibles avec la structure d'un annuaire (pour un annuaire partagé), avec les comptes classiques (pour une authentification Web par exemple) et avec les comptes Unix (posix).
L'annuaire LDAP peut être rempli par des fichiers ldif (ldif signifie ldap directory interchange format). Vous pouvez commencer en créant ce fichier d'exemple (init.ldif) :
# fichier de données : ~/init.ldif dn: dc=example,dc=com objectClass: dcObject objectClass: organizationalUnit dc: example ou: Example Dot Com dn: ou=people,dc=example,dc=com objectClass: organizationalUnit ou: people dn: ou=groups,dc=example,dc=com objectClass: organizationalUnit ou: groups dn: uid=lionel,ou=people,dc=example,dc=com objectClass: inetOrgPerson objectClass: posixAccount objectClass: shadowAccount uid: lionel sn: Porcheron givenName: Lionel cn: Lionel Porcheron displayName: Lionel Porcheron uidNumber: 1000 gidNumber: 10000 gecos: Lionel Porcheron loginShell: /bin/bash homeDirectory: /home/lionel shadowExpire: -1 shadowFlag: 0 shadowWarning: 7 shadowMin: 8 shadowMax: 999999 shadowLastChange: 10877 mail: lionel.porcheron@example.com postalCode: 31000 l: Toulouse o: Example mobile: +33 (0)6 xx xx xx xx homePhone: +33 (0)5 xx xx xx xx title: System Administrator postalAddress: initials: LP dn: cn=example,ou=groups,dc=example,dc=com objectClass: posixGroup cn: example gidNumber: 10000 displayName: Example group
Dans l'exemple ci-dessus, la structure de l'annuaire, c'est-à-dire un utilisateur et un groupe ont été créés. Dans d'autres exemples vous auriez pu voir le paramètre "objectClass: top" ajouté dans plusieurs entrées, mais c'est le comportement par défaut donc pas besoin de le mettre :)
Maintenant ajoutez vos entrées à LDAP :
- Arrêtez le daemon :
sudo /etc/init.d/slapd stop
- Supprimer ce qui a été ajouté automatiquement à l'installation :
sudo rm -rf /var/lib/ldap/*
Ajouter les données :
sudo slapadd -l ~/init.ldif
Entry (cn=example,ou=groups,dc=example,dc=com), attribute 'displayName' not allowed slapadd: dn="cn=example,ou=groups,dc=example,dc=com" (line=46): (65) attribute 'displayName' not allowed
Il faut commenter la ligne 46 comme ceci :
#displayName: Example group
Puis refaire :
sudo rm -rf /var/lib/ldap/*
Donner les droits de lecture aux fichiers de la base de données
sudo chown -R openldap:openldap /var/lib/ldap
N'oublions pas de relancer ldap :
sudo /etc/init.d/slapd start
Nous allons pouvoir vérifier que les données ont été correctement ajoutées avec les outils du paquet ldap-utils
. Pour effectuer une recherche dans les annuaires LDAP il vous suffit de faire :
ldapsearch -xLLL -b "dc=example,dc=com" uid=lionel sn givenName cn dn: uid=lionel,ou=people,dc=example,dc=com cn: Lionel Porcheron sn: Porcheron givenName: Lionel
Une rapide explication :
- -x désactive l'authentification SASL
- -LLL empêche l'affichage des informations LDIF
- -b indique la branche utilisée
NE PAS OUBLIER d'ajouter le user qui doit administrer le service ldap au group openldap à créer lors de l'installation du paquet ou bien de donner les bons droits sur les fichiers /etc/ldap/ldap.conf et /var/lib/ldap/*
Convertir un csv en ldif
Ci dessous un script bash convertissant un csv en ldif. Il faut évidemment le personnaliser selon vos besoins. Il lui manque de: supprimer les doublons, les valeurs nulles, les têtes de colonne ainsi que les espaces et caractères spéciaux dans l'uid.
#!/bin/bash # Le script et le fichier source doivent être dans le home. # Le script ne supprime ni les doublons, ni les valeurs nulles, ni les têtes de colonne. # Il faudrait aussi supprimer les espaces et les caractères spéciaux dans les uid=$nom$prenom source=source.csv # Le fichier source cible=cible.ldif # Le fichier cible > $cible # Nettoyage du fichier cible. while read line # On lit le fichier, et pour chaque ligne... do nom=$(echo $line | cut -d ";" -f2) # On entre dans la variable $nom la deuxième colonne (-f2). prenom=$(echo $line | cut -d ";" -f3) # Remarquez le séparateur qui est le ";". On pourrait changer. rue=$(echo $line | cut -d ";" -f4) cp=$(echo $line | cut -d ";" -f5) ville=$(echo $line | cut -d ";" -f6) tel=$(echo $line | cut -d ";" -f7) mobile=$(echo $line | cut -d ";" -f8) courriel=$(echo $line | cut -d ";" -f9) # A partir de la ligne suivante exportation par un echo. # C'est ici que vous pouvez modifier le contenu du ldif. # Il faudrait y ajouter une condition pour ne pas afficher les champs vides. echo "dn: uid=$nom$prenom,ou=fideles,dc=example,dc=com objectClass: inetOrgPerson objectClass: organizationalPerson objectClass: posixAccount objectClass: shadowAccount objectClass: person objectClass: top cn: $nom $prenom gidNumber: 100 givenName: $prenom homeDirectory: hd homePhone: $tel mobile: $mobile mail: $courriel street: $rue postalCode: $cp $ville sn: $nom uid: $nom$prenom uidNumber: 100 " >> $cible # Écriture dans le fichier cible. done < $source # Lecture de la source.
Utiliser votre serveur LDAP
Maintenant que votre serveur est prêt et démarré vous pouvez :
- Authentifier vos utilisateurs dans l'annuaire comme expliqué dans la documentation LDAPClientAuthentication
- Authentifier vos utilisateurs via une applications web
- Utiliser l'annuaire comme une base de données pour votre client mail
- Et bien plus encore !!!
De manière plus concrète, il existe des solutions simples à installer et qui vous permettent un excellent accès à votre annuaire, que ce soit en visualisation comme en création/édition.
phpLDAPadmin
Pré-requis
- Avoir un serveur WEB installé, voir LAMP.
- La version 12.04 LTS d'Ubuntu. (La 13.10 étant incompatible avec phpLDAPadmin : https://bugs.launchpad.net/ubuntu/+source/phpldapadmin/+bug/1246170)
Installation
Vous devez installer les paquets apt://phpldapadmin.
Et on y accède via http://votre_domaine.com/phpldapadmin/
Attention, le login est : "cn=admin,dc=example,dc=com".
Problème : Memory Limit low
Si lorsque vous allez sur l'interface web de phpldapadmin, vous avez cette erreur :
Memory Limit low. Your php memory limit is low - currently 16M
Éditer en admin le fichiers php.ini :
cd /etc/php5/apache2/ sudo nano php.ini
trouvez la section suivante et changez la valeur memory_limit = 16M en mettant 50M :
;;;;;;;;;;;;;;;;;;; ; Resource Limits ; ;;;;;;;;;;;;;;;;;;; max_execution_time = 30 ; Maximum execution time of each script, in seconds max_input_time = 60 ; Maximum amount of time each script may spend parsing request data ;max_input_nesting_level = 64 ; Maximum input variable nesting level memory_limit = 50M ; Maximum amount of memory a script may consume (16MB)
Il suffit ensuite de recharger la configuration de apache pour que la modification soit prise en compte :
sudo /etc/init.d/apache2 reload
puis relancer votre serveur ldap :
sudo /etc/init.d/slapd restart
Réplication des données LDAP
Le service LDAP peut vite devenir un service hautement critique dans votre système d'information : tout dépend (ou peut dépendre) de LDAP :
- Authentification
- Autorisation
- Mail
- …
Ce serait donc une bonne idée de créer un système redondant. Le mini HOWTO ci-dessous vous permettra de le faire.
Introduction
Avec OpenLDAP 2.2 (sur Breezy et Dapper), la réplication est basée sur une communication maître-esclave.
ATTENTION
Vous devez vous rappeler que les modifications devraient toujours être faites sur le maître ! Si vous modifiez un esclave, les modifications seront perdues dès la synchronisation suivante :/
Le maître
Sur le maître, vous devez modifier la section "base de donnée" du fichier de configuration /etc/ldap/slapd.conf
pour ajouter une instruction de réplication.
L'exemple suivant montre une réplication sur le serveur ldap-2.example.com
avec le Manager user et le mot de passe secret.
Le fichier de log est l'emplacement où les données seront stockées avant d’être envoyées sur le(s) serveur(s) esclave(s).
zcat /usr/share/doc/slapd/examples/slapd.conf.gz > /etc/ldap/slapd.conf sed -i "s/SLAPD_CONF=/SLAPD_CONF=\/etc\/ldap\/slapd.conf/g" /etc/default/slapd sed -i "s/dbconfig/#dbconfig/g" /etc/ldap/slapd.conf systemctl daemon-reload systemctl restart slapd.service
replica uri=ldap://ldap-2.example.com:389 binddn="cn=Manager,dc=example,dc=com" bindmethod=simple credentials=secret replogfile /var/lib/ldap/replog
Il ne reste plus qu'a redémarrer votre serveur LDAP :)
Le(s) Esclave(s)
Sur le(s) serveur(s) esclave(s) , il vous suffit d'autoriser votre serveur maître à mettre à jour la base de donnée LDAP. Pour cela ajoutez les lignes suivantes dans votre /etc/ldap/slapd.conf
à la section base de données :
updatedn cn=Manager,dc=example,dc=com updateref ldap://ldap-1.example.com
Redémarrez votre serveur LDAP (l'esclave).
Liens
- Un GUI pour LDAP (Disponible dans les dépots)
Contributeurs : Sp4rKy puis remis (un peu) en page et déplacé par bastnic, Kenny432.