LDAP

Introductie

Om een centrale plaats te hebben om authenticatie te doen voor www.hcc.nl en sub-sites zoals een forum, is gekozen voor het gebruik van een LDAP database/directory. Hierin wordt alleen opgeslagen wat nodig is voor het functioneren van de site. Andere persoonsgegevens en HCC specifieke gegevens komen in een (MySQL) database. Dit kan ook een tabel binnen de Drupal omgeving zijn.

LDAP server keuze

De voor de hand liggende keuze is OpenLDAP. Echter zijn er geluiden gehoord dat OpenLDAP niet zou schalen. Alternatieven zijn b.v. 389server maar die is erg slecht gesupport onder Ubuntu. Voorlopig starten we met OpenLDAP.

Loadbalanced

Er zijn twee servers (hcc-ldap-lb1 en hcc-ldap-lb2) die achter een loadbalancer in preferred server mode staat zodat het verkeer altijd naar server1 gestuurd wordt. Beide servers houden elkaar up-to-date. In de gewone situatie zullen alle reads en writes naar server1 gaan en server2 wordt door server1 bijgewerkt. Valt server1 weg, dan zal de loadbalancer overschakelen naar server2 waar vanaf dan de read en writes plaatsvinden. Zodra server1 weer beschikbaar is, wordt die bijgewerkt en zal weer master worden. Dit is nog niet getest en hoe de timing precies is, is nog niet duidelijk...

Installatie

Installatie van OpenLDAP is simpel:

aptitude install slapd ldap-utils

Als er gebruikgemaakt wordt van php scripts, is het ook nodig php5-cli en php5-ldap te installeren. De configuratie van OpenLDAP is sinds Karmic Koala iets gecompliceerder geworden. cn=config wordt nog steeds gebruikt maar tijdens installatie wordt alleen een skeleton configuratie geïnstalleerd. Er wordt niet meer gevraagd om een password tijdens de installatie en met "dpkg-reconfigure slapd" zet alleen de skeleton configuratie terug. Je moet zelf de database, root dn en acl's opzetten (als root of met sudo). Run dpkg-reconfigure slapd om terug te gaan naar een lege directory.

UPDATE: in Oneiric Ocelot (11.10) is weer wel de mogelijkheid gegeven bij installatie een database aan te maken. Default wordt echter de fqdn hostname gebruikt. Bij dpkg-reconfigure kan het gewenste domein wel opnieuw gegeven worden. De initiële configuratie staat in /usr/share/slapd/slapd.init.ldif.

Locatie bestanden

Om de benodigde bestanden op de server te krijgen zal scp gebruikt moet worden. Upload alles in een privé subdirectory. Copiëer daarna alles naar de juiste plaats en verander de owner in root.

• Alle ldif bestanden gaan naar /usr/local/hobbynet/lib
• init_ldap gaat naar /usr/local/hobbynet/bin
• etc/ldap/schema/hcc_schema.* gaan naar /etc/ldap/schema
• etc/ldap/schema/ppolicy.ldif gaat naar /etc/ldap/schema

Initiële database

Direct na installatie (of na dpkg-reconfigure slapd) staat er een werkende doch lege directory in OpenLDAP. Access is alleen geregeld voor root. Dit heeft te maken met het feit dat vanaf Karmic Koala OpenLDAP alleen het minst noodzakelijke bevat om slapd te starten.

slapd.init.ldif

Bij installatie/reconfiguratie wordt /usr/share/slapd/slapd.init.ldif ingelezen. Zie aldaar.

init_ldap script

Het lokale script init-ldap doet een reset van de initiële Openldap configuratie. Dit heeft tot gevolg dat de DIT dc=hcc,dc=nl met een rootDN cn=admin,dc=hcc,dc=nl reeds aangemaakt worden. Alles wat we toegevoegd/gewijzigd willen hebben in de cn=config volgt daarna. Dit wordt afgesloten met een restart van de slapd server. Na een korte delay wordt in een aantal stappen de eigelijke data geladen. Deze is verschillend op de test servers en de productie servers.

Het (plain text) password van cn=admin,dc=hcc,dc=nl moet bij het aanroepen van init_ldap op de commandline worden meegegeven. Tijdens de dpkg-reconfigure moet het password nog 2x gegeven worden. Gebruik ook de OpenLDAP Admin Guide.

Het init_ldap script bevat allerlei logic om op meerdere ldap servers gedraaid te kunnen worden. In grote lijnen valt het script in een aantal blokken uiteen:

• voorbereidingen om "dpkg-reconfigure slapd" te draaien
• definities van input files
• check host
• bouwen van het skelet van de nieuwe directory
• laden van de data

Zie voor details het script zelf b.v. op ldap2 (in /usr/local/hobbynet/bin).

upd_ldap script

Om na het volledig laden van de database updates te kunnen doen is er een 2de (afgeleid) script upd_ldap dat vooral bedoeld is om te voorkomen dat telkens alle username/password gegevens via het zeer trage SOAP/XMLRPC interface van HenZ gehaald moeten worden. Ook het inlezen van bijna 90.000 records in ldap is een tijdrovende zaak. Hiertoe zet Hans alleen de mutaties klaar (veel handwerk). Omdat het tevens om aanpassingen in de kaderrollen gaat, worden die eerst allemaal verwijderd met het php script "leeg-kader-rol.php". Daarna worden vervolgens de mutaties ingelezen (delete/add), de username/passwords (wizzard informatie) ge-update en tenslotte alle rollen weer toegevoegd. Zodra er een dagelijkse cron job draait zal dit ingewikkelde proces vervangen worden door een mechanisme dat gebruik maakt van een XMLRPC koppeling richting ldap server.

onderdelen van init_ldap

Init_ldap is opgezet om stap voor stap de database op te bouwen. Hieronder een beschrijving van de losse ldif bestanden die ingelezen worden. Incidenteel wordt een ldif gewijzigd; kijk altijd in de actuele bestanden!

add-schema.ldif

Omdat wij een aantal eigen attributes en Objectclasses hebben toegevoegd aam het schema, moeten deze aan OpenLDAP worden toegevoegd. Het schema moet nog wel worden omgezet naar ldif format. Hiertoe wordt het onderstaande schema in /etc/ldap/schema geplaatst als hcc_schema.schema. Vervolgens worden de stappen uitgevoerd zoals beschreven in de Ubuntu Server guide, onder Modifying the slapd Configuration Database. De resulterende output file cn=hcc_schema.ldif moet dan nog naar /etc/ldap/schema/hcc_schema.ldif gecopieerd worden. Als dit proces herhaald moet worden, start dan met een lege output directory en verwijder een eventueel achter gebleven cn=hcc_schema.ldif bestand. Hieronder het schema:

# HCC schema
#
attributetype ( 1.3.6.1.4.1.12795.1.1
        NAME 'hccRegio'
        DESC 'HCC regio code'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15
        SINGLE-VALUE )

attributetype ( 1.3.6.1.4.1.12795.1.2
        NAME 'hccIg'
        DESC 'HCC interesse groep'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )

attributetype ( 1.3.6.1.4.1.12795.1.3
        NAME 'hccLogin'
        DESC 'HCC loginnaam'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15
        SINGLE-VALUE )

attributetype ( 1.3.6.1.4.1.12795.1.4
        NAME 'hccLidNummer'
        DESC 'HCC lidnummer'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15
        SINGLE-VALUE )

attributetype ( 1.3.6.1.4.1.12795.1.5
        NAME 'hccRol'
        DESC 'Kader/kernlid rol'
        EQUALITY caseIgnoreMatch
        SUBSTR caseIgnoreSubstringsMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.15 )

attributetype ( 1.3.6.1.4.1.12795.1.6
        NAME 'hccCode'
        DESC 'HCC code'
        EQUALITY octetStringMatch
        SYNTAX 1.3.6.1.4.1.1466.115.121.1.40{128} )

objectclass ( 1.3.6.1.4.1.12795.2.1
        NAME 'hccOrgPerson'
        DESC 'HCC Lid'
        SUP top
        STRUCTURAL
        MUST ( hccRegio $ hccLogin $ hccLidNummer $ userPassword $ sn )
        MAY ( hccIg $ hccRol $ hccCode $ cn)
        )

objectclass ( 1.3.6.1.4.1.12795.2.2
        NAME 'hccGroupOfNames'
        DESC 'HCC group of names (DNs)'
        SUP top
        STRUCTURAL
        MUST ( cn )
        MAY ( member $ description )
        )

De extra schema's worden middels een include toegevoegd. Ppolicy is op gelijke wijze als hcc_schema tot .ldif geconverteerd.

#######################################
## add-schema.ldif                   ##
#######################################
include: file:///etc/ldap/schema/hcc_schema.ldif
include: file:///etc/ldap/schema/ppolicy.ldif

modify_config.ldif

SSL/TLS instelling toevoegen in de ldap configuratie. Toegevoegd worden de certificaat gegevens om met TLS te kunnen werken. Het loglevel wordt op STATS gezet. Dit geeft niet teveel logging maar is toch goed bruikbaar. De @...@ strings worden tijdens het draaien van het init_ldap script vervangen door specifieke waarden voor de server. Dit om op alle servers (ook test servers) één en hetzelfde script te kunnen gebruiken. Er zijn nog enkele van deze temmplates.

#######################################
## modify-config.tmpl                ##
#######################################
dn: cn=config
add: olcTLSCACertificateFile
olcTLSCACertificateFile: /etc/ssl/certs/CAcert_org.pem
-
add: olcTLSCertificateFile
olcTLSCertificateFile: /etc/ssl/private/@CERT@.crt
-
add: olcTLSCertificateKeyFile
olcTLSCertificateKeyFile: /etc/ssl/private/@CERT@.key
-
replace: olcLogLevel
olcLogLevel: stats

Om de logging in een apart bestand te krijgen moet in /etc/rsyslog.d een extra bestand openldap.conf geplaatst worden.

local4.*   -/var/log/openldap.log

Tevens willen we logrotate op dit bestand. Plaats in /etc/logrotate.d het bestand openldap met de volgende inhoud

/var/log/openldap.log
{
        rotate 4
        weekly
        missingok
        notifempty
        compress
        delaycompress
        sharedscripts
        postrotate
                reload rsyslog >/dev/null 2>&1 || true
        endscript
}

modify-hdb.ldif

Hier worden de wijzigingen op de backend db gemaakt. Er worden een aantal attributes ge-indexeerd en de search SizeLimit wordt op unlimited gezet. Cache sizes verschillen per server en worden vervangen door actuele waarden. (zie: init_ldap)

#######################################
## modify-hdb.tmpl                   ##
#######################################
dn: olcDatabase={1}hdb,cn=config
add: olcDbIndex
olcDbIndex: entryUUID,entryCSN eq
olcDbIndex: cn,sn eq,pres,sub
olcDbIndex: hccLidNummer,hccLogin,hccRol eq,pres,sub
-
add: olcSizeLimit
olcSizeLimit: unlimited
-
add: olcDbCachesize
olcDbCachesize: @CSIZE@
-
add: olcDbIDLcacheSize
olcDbIDLcacheSize: @ISIZE@
-
replace: olcDbCheckpoint
olcDbCheckpoint: 1024 5
-
replace: olcAccess
olcAccess: to attrs=userPassword
  by self write
  by anonymous auth
  by dn="cn=admin,dc=hcc,dc=nl" write
  by dn.one="ou=beheer,dc=hcc,dc=nl" write
  by * none
olcAccess: to attrs=hccLogin
  by self write
  by dn="cn=admin,dc=hcc,dc=nl" write
  by dn.one="ou=beheer,dc=hcc,dc=nl" write
  by dn="cn=drupal-hcc-nl,ou=klanten,dc=hcc,dc=nl" read
  by dn="cn=webapps,ou=klanten,dc=hcc,dc=nl" search
  by * none
olcAccess: to *
  by self read
  by dn="cn=admin,dc=hcc,dc=nl" write
  by dn.one="ou=beheer,dc=hcc,dc=nl" write
  by dn.one="ou=klanten,dc=hcc,dc=nl" read
  by * none

Ppolicy overlay

• vanuit LDAP de minimale lengte van een wachtwoord afdwingen
• in LDAP SSHA versleuteling activeren
  (olcPPolicyHashCleartext: TRUE)

#######################################
## add-ppolicy.ldif                  ##
#######################################
dn: cn=module{0},cn=config
changetype: modify
add: olcModuleLoad
olcModuleLoad: ppolicy

dn: olcOverlay=ppolicy,olcDatabase={1}hdb,cn=config
changetype: add
objectClass: olcConfig
objectClass: olcOverlayConfig
objectClass: olcPPolicyConfig
olcOverlay: ppolicy
olcPPolicyDefault: cn=default,ou=policies,dc=hcc,dc=nl
olcPPolicyHashCleartext: TRUE

The default ppolicy looks like this:

dn: cn=default,ou=policies,dc=hcc,dc=nl
objectClass: pwdPolicy
objectClass: device
cn: default
pwdCheckQuality: 1
pwdMinLength: 8
pwdAttribute: 2.5.4.35
pwdAllowUserChange: TRUE

Syncrepl overlay

Om twee servers met elkaar in sync te houden is nog wat aanvullende configuratie nodig. In onze situatie zal altijd maar één server bevraagd worden; bij een failover van de loadbancer zal dus de andere server gebruikt worden. Bij het teruggaan naar server 1 zal de directory bijgewerkt worden. Wij gebruiken de z.g. Mirror Mode. Zie de LDAP Admin Guide. Mirror configuratie is specifiek per server!

#######################################
## add-syncrepl.tmpl                 ##
#######################################
dn: cn=config
changetype: modify
replace: olcServerID
olcServerID: @SID@

dn: cn=module{0},cn=config
changetype: modify
add: olcModuleLoad
olcModuleLoad: syncprov

dn: olcOverlay=syncprov,olcDatabase={1}hdb,cn=config
changetype: add
objectClass: olcOverlayConfig
objectClass: olcSyncProvConfig
olcOverlay: syncprov
olcSpCheckpoint: 100 5
olcSpSessionlog: 100

dn: olcDatabase={1}hdb,cn=config
changetype: modify
add: olcSyncRepl
olcSyncRepl: rid=@RID@
  provider=ldap://@PROVIDER@
  binddn="cn=admin,dc=hcc,dc=nl" bindmethod=simple credentials="@PASSWORD@"
  searchbase="dc=hcc,dc=nl"
  type=refreshAndPersist
  interval=00:00:00:10
  retry="5 5 300 5"
  timeout=1
  starttls=yes
-
add: olcMirrorMode
olcMirrorMode: TRUE

De andere server krijgt ServerID 2 en de provider is het IP adres van de andere server.

Unique overlay

Deze overlay dient er voor te zorgen dat het attribuut hccLogin een unike waarde bevat.

#######################################
## add-unique.ldif                   ##
#######################################
dn: cn=module{0},cn=config
changetype: modify
add: olcModuleLoad
olcModuleLoad: unique

dn: olcOverlay=unique,olcDatabase={1}hdb,cn=config
changetype: add
objectClass: olcOverlayConfig
objectClass: olcUniqueConfig
olcOverlay: unique
olcUniqueAttribute: hcclogin

hcc-*.ldif

Deze stappen vullen de db met entries op ou level en onderhangende data zoals vaste gegevens over regio's en ig's.

• hcc-beheer.ldif - bevat de beheer accounts
• hcc-klanten.ldif - bevat de klanten accounts
• hcc-kader_converted.ldif - de basisgegevens van de kader leden (uit LIDgg)
• hcc-kader-member.ldif - bevat de groepering gegevens van de kaderleden
• hcc-kader-rol.ldif - bevat de kader functies
• hcc-nl-ww.ldif - bevat de encrypted passwords van de kaderleden NADAT ze de Wizzard hebben doorlopen
• hcc-ou.ldif - bevat de organizational units beheer, leden, klanten en policies.
• hcc-ppolicy.ldif - bevat de default password policy.

Niet meer gebruikt:

• hcc-functies.csv - bevat de afkortingen van de fuctionarissen
• hcc-groeperingen.csv - bevat de afkortingen van de regio's en de interessegroepen
• hcc-groeperingen.ldif - het resultaat van gen-groepringen

SSL/TLS beveiliging

Gebruik de juiste .pem bestanden in /etc/ssl/certs en /etc/ssl/private. Voer een c_rehash . uit in /etc/ssl/certs om de cache te updaten (indien CAcert_org.pem nieuw werd toegevoegd). De ownership is belangrijk. Hiertoe wordt de groep "openldap" toegevoegd aan de groep ssl-cert.

adduser openldap ssl-cert

Als dit fout gaat, doe dan eerst:

apt-get install ssl-cert

Zet het certificaat en de private key in de juiste groep:

chgrp ssl-cert /etc/ssl/private/hobby.nl.*
chmod 440      /etc/ssl/private/hobby.nl.key

Het resultaat is dan als volgt:

root@hcc-ldap-lb1:~# ls -l /etc/ssl/private/hcc* 
-rw-r--r-- 1 root     ssl-cert 1724 Nov 22 20:47 hobby.nl.crt
-r--r----- 1 root     ssl-cert 1679 Nov 22 20:25 hobby.nl.key

root@hcc-ldap-lb1:~# grep openldap /etc/group
ssl-cert:x:114:openldap
openldap:x:118:

LDAP Clients

Er zijn meerdere LDAP clients. De meest populaire zijn Apache Directory Studio en phpLdapAdmin. De eerste is veel uitgbreider maar vereist een Java Runtime Environment. Onder Windows XP is dat JRE6. PhpLdapAdmin draait onder apache. Beide clients hebben wat configuratie nodig; Bij ADS gaat alles stapsgewijs in de GUI. Voor PLA moet /etc/phpldapadmin/config.php aangepast worden.

StartTLS

Aanbevolen wordt StartTLS op poort 389 te gebruiken. Alternatief is LDAPS op poort 636 maar is depreciated. Voor beide clients is het belangrijk dat de root certificaten gevonden kunnen worden. Als Apache al een server cert kent zou PLA geen probleem mogen zijn. ADS maakt deel uit van de JRE. JRE moet dus de root certificaten kunnen vinden.

ADS onder Windows

Onder Windows moet met keytool.exe gewerkt worden. De uitleg heb ik van [hier]. Het komt erop neer dat de .pem of .der certificaten van CAcert in de keystore gezet worden. Kopieer deze certificaat bestanden in C:\Program Files\Java\jre6\lib\security (jre6 kan ondertussen jre7 zijn in Vista of W7). Doe dan in een terminal window:

cd C:\Program Files\Java\jre6\lib\security
wget http://www.cacert.org/certs/root.der -O root.der
wget http://www.cacert.org/certs/class3.der -O class3.der
..\..\bin\keytool -import -trustcacerts -keystore cacerts -storepass changeit -noprompt -alias cacertclass1 -file root.der
..\..\bin\keytool -import -trustcacerts -keystore cacerts -storepass changeit -noprompt -alias cacertclass3 -file class3.der

De Windows JRE is ook te managen via het Java applet in het configuratiescherm. Toevoegen van root certificaten lijkt niet mogelijk voor system; wel voor user. Niet verder naar gezocht.

ADS onder Linux

Apache Directory Studio volgt nog.

PLA onder Linux

Voor ldap clients (phpldapadmin) dient de client configuratie goed te zijn. Deze bevindt zich in /etc/ldap.ldap.conf. Het is voldoende als de directory met de root certificaten bekend is. Deze client configuratie is meer php-ldap gebonden dan alleen voor PLA. Ook de Drupal LDAPauth module werkt met ditzelfde beatand. Zie ook de [phpldapadmin wiki].

#
# LDAP Defaults
#

# See ldap.conf(5) for details
# This file should be world readable but not world writable.

#BASE   dc=example,dc=com
#URI    ldap://ldap.example.com ldap://ldap-master.example.com:666

#SIZELIMIT      12
#TIMELIMIT      15
#DEREF          never
TLS_CACERT      /etc/ssl/certs/CAcert_org.pem
TLS_CERT        /etc/ssl/private/hobby.nl.crt
TLS_KEY         /etc/ssl/private/hobby.nl.key
TLS_REQCERT     allow
#TLS_REQCERT never

Denk er wel aan na wijzigingen Apache te herstarten.

Backup

lokaal

Backups kunnen gemaakt worden terwijl slapd draait maar geadviseerd wordt slapd te stoppen. Voor dumpen moet slapcat gebruikt worden. Backups kunnen gemaakt worden per database naar een ldif bestand.

slapcat -l hcc-dump.ldif -b "dc=hcc,dc=nl"

Dit maakt een dump van alles onder dc=hcc,dc=nl naar het bestand hcc-dump.ldif. Ook is het mogelijk het database nummer te gebruiken, config is altijd nummer 0, hdb is gewoonlijk 1:

slapcat -l config-dump.ldif -n 1

Terug inlezen kan alleen in een lege directory, dus direct nadat alle cn=config wijzigingen zijn gedaan. Gebruik hiervoor slapadd. Aan te bevelen is -c mee te geven want de eerste twee DN's zijn al aanwezig. In geval van een gerepliceerde db is het van belang het SID mee te geven en -w om de hoogste entryCSN weg te schrijven.

slapadd -l hcc-dump.ldif -w -c >errors.txt

Ook voor slapadd moet slapd gestopt zijn.

remote

Er wordt een encrypted remote backup gemaakt naar backup2bit. zie voor meer info Encrypted_backup

crontab

# script dat updates ophaalt (maar niet installeert), zodat nagios ze ook detecteert
0 9 * * * /usr/local/hobbynet/bin/upd_srv >/dev/null
0 18 * * * /usr/local/hobbynet/bin/upd_srv >/dev/null

PHP scripting

Initieel worden alle leden op basis van hun hcc lidnummer ingelezen. Zodra de profielwizard doorlopen is, zal het lidnummer vervangen moeten worden door de gebruikersnaam.

Onderstaande PHP code kan als basis dienen om deze rename-aktie uit te voeren.

<?php
//Rename "uid=0003092,  ou=leden,dc=hcc,dc=nl" to 
//       "uid=h.verbeek,ou=leden,dc=hcc,dc=nl"

$ldaphost = "192.168.11.109";
$ldapport = 389;

$ldap_username = "cn=hans,ou=beheer,dc=hcc,dc=nl";
$ldap_password = "password";

$name_old = "0003092";
$name_new = "h.verbeek";

//Connect to LDAP server.
$ds=ldap_connect( $ldaphost, $ldapport )
          or die("Could not connect to {$ldaphost}");

// $ds is a valid link identifier for a directory server
if (ldap_set_option($ds, LDAP_OPT_PROTOCOL_VERSION, 3)) {
    echo "Using LDAPv3\n";
} else {
    echo "Failed to set protocol version to 3\n";
    exit;
}

if ($ds) {
 if(ldap_start_tls($ds))
 {
  $r = ldap_bind($ds, $ldap_username, $ldap_password)
          or die("Could not bind to {$ldaphost}\n");

  $dn = "uid=$name_old,ou=leden,dc=hcc,dc=nl";
  $name = "$name_new";
  $newRdn = "uid=" . $name;
  if (ldap_rename($ds, $dn, $newRdn, NULL, true)) {
   echo "Success: rename $name_old ==> $name_new\n";
   }
   else
   {
    echo "Fail: could not rename $name_old ==> $name_new \n";
   }
 }
 ldap_unbind($ds);
}
?>

TODO lijst

Dit is een lijst in wording, graag aanvullen

• gebruikersrechten verfijnen
  (gebruiker mag zijn eigen naam niet aanpassen, maar de Drupal scripting mag dit wel)
• gebruikersnaam moet uniek zijn (implementeer de 'unique' policy)
• logging verminderen
• script maken om dagelijkse mutaties te verwerken
• script maken om eenmalig de complete LIDGG in te lezen
  (dit wordt vervolgens aangevuld met de conversie die vanuit de 'oude' hcc.nl omgeving wordt uitgevoerd)
• 'dun' loadbalancer script maken om te controleren dat LDAP echt luistert