OpenLDAP et ldapsearch : annuaire Oracle Net sur Ubuntu, sauvegarde et journalisation
Commandes ldapsearch, installation d'OpenLDAP sur Ubuntu, schéma Oracle Net, sauvegarde/restauration, mot de passe admin et logs.
OpenLDAP peut servir d'annuaire pour la résolution de noms Oracle Net (en remplacement de tnsnames.ora) et ldapsearch est l'outil principal pour l'interroger, ou pour interroger un Active Directory. Cet article rassemble les commandes essentielles : concepts, requêtes, installation sur Ubuntu, chargement du schéma Oracle, sauvegarde et restauration, journalisation et changement du mot de passe admin. Les noms d'hôtes, domaines et identifiants sont génériques.
Concepts
Chaque unité LDAP est une entrée (objet). Attributs courants des DN (voir la RFC 2253) :
| Attribut | Signification |
|---|---|
| DN | Nom distinctif de l'entrée |
| CN | commonName |
| L | localityName |
| ST | stateOrProvinceName |
| O | organizationName |
| OU | organizationalUnitName |
| C | countryName |
| STREET | streetAddress |
| DC | domainComponent |
| UID | userid |
Le DIT (Directory Information Tree) se parcourt soit avec un DN complet pour atteindre une entrée précise, soit avec un DN de base et un filtre (attribut=valeur) pour trouver les entrées en dessous.
Interroger avec ldapsearch
Active Directory, bind simple, base DN et filtre :
ldapsearch -x -h ldap.contoso.com -D "user@example.com" -W -b "OU=USERS,DC=contoso,DC=com" "CN=john*" | less
ldapsearch -x -h ldap.contoso.com -D "user@example.com" -W -b "OU=USERS,DC=contoso,DC=com" '(uid=testuser1)'
ldapsearch -x -h ldap.contoso.com -D "user@example.com" -W -b "OU=USERS,DC=contoso,DC=com" -s sub "(cn=*)" cn mail sn
ldapsearch -x -h ldap.contoso.com -D "user@example.com" -W -b "OU=USERS,DC=contoso,DC=com" "(mail=*gue*)" cn mail sn
Compter les utilisateurs et les membres d'un groupe :
ldapsearch -x -h ldap.contoso.com -b "dc=contoso,dc=com" -D "user@example.com" -W -s sub '(&(objectCategory=person)(objectClass=user))' | grep "cn:" | wc -l
ldapsearch -x -h ldap.contoso.com -b "dc=contoso,dc=com" -D "user@example.com" -W -s sub '(&(objectCategory=person)(objectClass=user)(memberOf=CN=app_group,OU=GROUP,DC=contoso,DC=com))' | grep "cn:" | wc -l
Découvrir les naming contexts et lire la racine :
ldapsearch -x -b '' -s base '(objectclass=*)' namingContexts
ldapsearch -x -b 'dc=example,dc=com' -s base '(objectclass=*)'
Entrées de services Oracle Net (orclNetService) :
ldapsearch -x -H ldap://ldapserver01 -b "cn=OracleContext,dc=example,dc=com"
ldapsearch -x -H ldap://ldapserver01 -b "dc=example,dc=com" -s sub "(&(objectclass=orclNetService)(cn=db-test*))"
ldapsearch -x -H ldap://ldapserver01 -b "dc=example,dc=com" -s sub "objectclass=*"
Erreurs courantes : l'erreur 32 signifie que l'objet référencé n'existe pas (DN erroné) ; l'erreur 49 est un échec de connexion générique, le serveur ajoute ses propres sous-codes (un DN admin incorrect est la cause habituelle).
Paquets clients : sudo apt-get install ldap-utils (Debian/Ubuntu), yum install openldap-clients (RHEL/CentOS). Sous Windows, wmic useraccount get name,sid liste les comptes locaux et leurs SID.
Installer OpenLDAP sur Ubuntu
Définir le nom d'hôte et la résolution de noms :
sudo hostnamectl set-hostname ldapserver01.example.com
sudo hostnamectl
sudo vim /etc/hosts
127.0.0.1 localhost
192.0.2.11 ldapserver02
192.0.2.10 ldapserver01.example.com
Installer les paquets (l'assistant demande le domaine et le mot de passe admin ; dpkg-reconfigure slapd le relance) :
sudo apt update
sudo apt -y install slapd ldap-utils
sudo slapcat
Base DN, utilisateurs et groupes
basedn.ldif :
dn: ou=people,dc=example,dc=com
objectClass: organizationalUnit
ou: people
dn: ou=groups,dc=example,dc=com
objectClass: organizationalUnit
ou: groups
ldapadd -x -D cn=admin,dc=example,dc=com -W -f basedn.ldif
Générer un hash avec sudo slappasswd, puis créer ldapusers.ldif :
dn: uid=app_user,ou=people,dc=example,dc=com
objectClass: inetOrgPerson
objectClass: posixAccount
objectClass: shadowAccount
cn: app_user
sn: user
userPassword: {SSHA}<HASH>
loginShell: /bin/bash
uidNumber: 2000
gidNumber: 2000
homeDirectory: /home/app_user
ldapadd -x -D cn=admin,dc=example,dc=com -W -f ldapusers.ldif
Schéma Oracle Net
Pour charger des schémas, cn=config doit avoir un root DN et un mot de passe. Ajouter ces lignes dans /etc/ldap/slapd.d/cn=config/olcDatabase={0}config.ldif, puis redémarrer slapd :
olcRootDN: cn=admin,cn=config
olcRootPW: <PASSWORD>
sudo systemctl restart slapd
sudo ldapadd -x -W -f alias.ldif -D "cn=admin,cn=config"
sudo ldapadd -x -W -f oidbase.ldif -D "cn=admin,cn=config"
sudo ldapadd -x -W -f oidnet.ldif -D "cn=admin,cn=config"
sudo ldapadd -x -W -f oidrdbms.ldif -D "cn=admin,cn=config"
Les fichiers LDIF de schéma dérivent du schéma LDAP d'Oracle Net (documentation Oracle). Les anciens clients Oracle peuvent nécessiter des binds LDAP v2 ; les activer avec olcAllowsbind_v2.ldif :
dn: cn=config
add: olcAllows
olcAllows: bind_v2
ldapmodify -x -W -D "cn=admin,cn=config" -f olcAllowsbind_v2.ldif
Pour l'annuler, utiliser delete: olcAllows à la place de add: olcAllows dans un second LDIF appliqué de la même façon.
Lire la configuration
En root, slapd n'a pas besoin de tourner :
slapcat -b cn=config
slapcat -b cn=config -a "(|(cn=config)(olcDatabase={1}hdb))"
Ou via la socket locale :
ldapsearch -Y EXTERNAL -H ldapi:/// -b cn=config
ldapsearch -Y EXTERNAL -H ldapi:/// -b cn=config "(|(cn=config)(olcDatabase={1}hdb))"
ldapsearch -D "cn=admin,cn=config" -W -b cn=config
Sauvegarde et restauration
Sauvegarder l'arbre et la configuration :
sudo slapcat -b dc=example,dc=com -l backup.ldif
sudo tar -cvf ldap_conf.tar /etc/ldap
Restaurer :
sudo systemctl stop slapd
slapadd -c -b dc=example,dc=com -F /etc/ldap/slapd.d -l backup.ldif
sudo tar -xvf ldap_conf.tar -C /
sudo systemctl start slapd
-c continue en cas d'erreur (par exemple une entrée déjà présente), -F indique le répertoire de configuration et -l le fichier LDIF.
Changer le mot de passe admin
Générer un hash (le chemin du module dépend de la distribution : /usr/lib/ldap sous Debian, /usr/lib64/openldap sous CentOS 7 et openSUSE, /usr/local/libexec/openldap pour une compilation depuis les sources) :
slappasswd -h '{SSHA}' -o module-load=pw-sha2.la -o module-path=/usr/lib/ldap
Puis l'appliquer à la base de configuration et à la base de données (adminPassword_config.ldif et adminPassword.ldif) :
dn: olcDatabase={0}config,cn=config
changetype: modify
replace: olcRootPW
olcRootPW: {SSHA}<HASH>
dn: olcDatabase={1}mdb,cn=config
changetype: modify
replace: olcRootPW
olcRootPW: {SSHA}<HASH>
sudo ldapmodify -x -W -D "cn=admin,cn=config" -f adminPassword_config.ldif
sudo ldapmodify -x -W -D "cn=admin,cn=config" -f adminPassword.ldif
Activer la journalisation
Vérifier le niveau actuel :
sudo ldapsearch -x -W -D "cn=admin,cn=config" -b cn=config "(objectClass=olcGlobal)" olcLogLevel -LLL
slapdlog.ldif (utiliser olcLogLevel: none pour désactiver) :
dn: cn=config
changeType: modify
replace: olcLogLevel
olcLogLevel: stats
sudo ldapmodify -x -W -D "cn=admin,cn=config" -f slapdlog.ldif
Rediriger local4 vers un fichier dédié avec rsyslog (/etc/rsyslog.d/10-slapd.conf) :
$template slapdtmpl,"[%$DAY%-%$MONTH%-%$YEAR% %timegenerated:12:19:date-rfc3339%] %app-name% %syslogseverity-text% %msg%\n"
local4.* /var/log/slapd.log;slapdtmpl
sudo systemctl restart rsyslog
sudo less /var/log/slapd.log
Ajouter /var/log/slapd.log à la liste de fichiers de /etc/logrotate.d/rsyslog pour le faire tourner. Pour tracer le trafic lui-même : tcpdump -i <interface> port 389.
Remarques
-Wdemande le mot de passe : éviter de le passer sur la ligne de commande.- Un bind simple (
-x) envoie le mot de passe en clair sauf avec LDAPS ou StartTLS. - L'overlay
auditlog(/usr/lib/ldap/auditlog.la) peut être chargé pour tracer les modifications.