User manual

Advanced Topics
Configuring LDAP
To configure Koha to use LDAP, we edit the
/et c /koha -dev /etc /koha -conf .xml
file and add an LDAP block similar to this:
<useldapserver >l< /useldapserver > <! -- see C4::Auth_with_ldap for extra
configs you must add if you want to turn this on - ->
<idapserver id= "ldapserver"
listenref = "ldapserver ">
<hostname >your hosts ip address or name < /hostname>
<base >base dn< /base>
<user >LDAP user's dn< /user>
<pass >LDAP user's password < /pass>
<replicate >1 < /replicate>
<! -- add new users from LDAP to
Koha database -->
<update >1 < /update>
<! -- update existing users in Koha
database - ->
<auth by_bind >l< /auth_by_bind>
<mapping>
<! -- match koha SQL field names to your
LDAP record field names -->
<firstname
is= "givenName"
>< /firstname>
<surname
is = "sn"
>< /surname>
<userid is= "uid " >< /userid>
<password is= "userPassword"
>< /password>
<email
is= "mail " > < / email>
<address is= "address " >Default Address < / address>
<city is= "city" >Default City < /city>
<branchcode is= "branch" >Default Branch Code < / branchcode>
<categorycode is= "category" >Default Catefory Code < /
categorycode>
</mapping>
</ldapserver>
Here is how we configure the LDAP block:
1.
Add the LDAP server block before these tags: <
/config > < /yazgfs>
in
the
koha- conf .xml file.
2.
Set the
<useldapserver>
tag to 1 to turn LDAP authentication on, set it
to 0 to turn it off.
3.
Enter the LDAP server's host name or IP address in the tag
<hostname >.
4.
Enter the LDAP server's base DN in the tag
<base >.
5. In the tag
<user>
enter the DN of an LDAP user with browse privileges
to the base DN.
6.
Enter the LDAP user's password in the tag
<pass >.
7.
Set
<replicate>
tag to
1
if you want to create new users in Koha from
the LDAP server. If this is set to o, the user record must exist in Koha.
[ 250 ]