最近，由于公司需求，需要搭建openldap來(lái)統一用戶(hù)名和密碼，目前市面上幾乎所有的工具都支持ldap協(xié)議，具體ldap的介紹這里就不詳細說(shuō)明了，這里主要記錄一下如果部署openldap來(lái)實(shí)現Ldap服務(wù)，并使用phpldapadmin作為web管理工具進(jìn)行界面維護。

    剛開(kāi)始的時(shí)候，我百度了一下openldap的搭建，發(fā)現教程都比較亂，也沒(méi)人說(shuō)清楚個(gè)具體的所以然，還有一個(gè)說(shuō)網(wǎng)上的90%都是錯的，而其本身的教程又不是很詳細，對于新手沒(méi)那么好懂，這里我就記錄一下完整的詳細的openldap搭建過(guò)程，并盡可能詳細的說(shuō)明其中每一步的作用，好了，廢話(huà)不多說(shuō)，下面開(kāi)始。

版本說(shuō)明： 直接yum安裝，版本如下，官網(wǎng)最新的是2.4.47，版本并不老所以就直接用yum倉庫默認自帶的。

centos7.5 （這里只要是centos7 都ok）

openldap 2.4.44

phpldapadmin 1.2.3

正文

1. 安裝openldap

# yum 安裝相關(guān)包
yum install -y openldap openldap-clients openldap-servers
# 復制一個(gè)默認配置到指定目錄下,并授權，這一步一定要做，然后再啟動(dòng)服務(wù)，不然生產(chǎn)密碼時(shí)會(huì )報錯
cp /usr/share/openldap-servers/DB_CONFIG.example /var/lib/ldap/DB_CONFIG
# 授權給ldap用戶(hù),此用戶(hù)yum安裝時(shí)便會(huì )自動(dòng)創(chuàng  )建
chown -R ldap. /var/lib/ldap/DB_CONFIG
# 啟動(dòng)服務(wù)，先啟動(dòng)服務(wù)，配置后面再進(jìn)行修改
systemctl start slapd
systemctl enable slapd
# 查看狀態(tài)，正常啟動(dòng)則ok
systemctl status slapd

2. 修改openldap配置

    這里就是重點(diǎn)中的重點(diǎn)了，從openldap2.4.23版本開(kāi)始，所有配置都保存在/etc/openldap/slapd.d目錄下的cn=config文件夾內，不再使用slapd.conf作為配置文件。配置文件的后綴為 ldif，且每個(gè)配置文件都是通過(guò)命令自動(dòng)生成的，任意打開(kāi)一個(gè)配置文件，在開(kāi)頭都會(huì )有一行注釋?zhuān)f(shuō)明此為自動(dòng)生成的文件，請勿編輯，使用ldapmodify命令進(jìn)行修改

# AUTO-GENERATED FILE - DO NOT EDIT!! Use ldapmodify.

   安裝openldap后，會(huì )有三個(gè)命令用于修改配置文件，分別為ldapadd, ldapmodify, ldapdelete，顧名思義就是添加，修改和刪除。而需要修改或增加配置時(shí)，則需要先寫(xiě)一個(gè)ldif后綴的配置文件，然后通過(guò)命令將寫(xiě)的配置更新到slapd.d目錄下的配置文件中去，完整的配置過(guò)程如下，跟著(zhù)我做就可以了：

# 生成管理員密碼,記錄下這個(gè)密碼，后面需要用到
slappasswd -s 123456
{SSHA}LSgYPTUW4zjGtIVtuZ8cRUqqFRv1tWpE
# 新增修改密碼文件,ldif為后綴，文件名隨意，不要在/etc/openldap/slapd.d/目錄下創(chuàng  )建類(lèi)似文件
# 生成的文件為需要通過(guò)命令去動(dòng)態(tài)修改ldap現有配置，如下，我在家目錄下，創(chuàng  )建文件
cd ~
vim changepwd.ldif
----------------------------------------------------------------------
dn: olcDatabase={0}config,cn=config
changetype: modify
add: olcRootPW
olcRootPW: {SSHA}LSgYPTUW4zjGtIVtuZ8cRUqqFRv1tWpE
----------------------------------------------------------------------
# 這里解釋一下這個(gè)文件的內容：
# 第一行執行配置文件，這里就表示指定為 cn=config/olcDatabase={0}config 文件。你到/etc/openldap/slapd.d/目錄下就能找到此文件
# 第二行 changetype 指定類(lèi)型為修改
# 第三行 add 表示添加 olcRootPW 配置項
# 第四行指定 olcRootPW 配置項的值
# 在執行下面的命令前，你可以先查看原本的olcDatabase={0}config文件，里面是沒(méi)有olcRootPW這個(gè)項的，執行命令后，你再看就會(huì )新增了olcRootPW項，而且內容是我們文件中指定的值加密后的字符串
# 執行命令，修改ldap配置，通過(guò)-f執行文件
ldapadd -Y EXTERNAL -H ldapi:/// -f changepwd.ldif

執行修改命令后，有如下輸出則為正常：

查看olcDatabase={0}config內容,新增了一個(gè)olcRootPW項。

上面就是一個(gè)完整的修改配置的過(guò)程，切記不能直接修改/etc/openldap/slapd.d/目錄下的配置。

好了，下面繼續進(jìn)行配置

# 我們需要向 LDAP 中導入一些基本的 Schema。這些 Schema 文件位于 /etc/openldap/schema/ 目錄中，schema控制著(zhù)條目擁有哪些對象類(lèi)和屬性，可以自行選擇需要的進(jìn)行導入，
# 依次執行下面的命令，導入基礎的一些配置,我這里將所有的都導入一下，其中core.ldif是默認已經(jīng)加載了的，不用導入
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/cosine.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/nis.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/inetorgperson.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/collective.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/corba.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/duaconf.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/dyngroup.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/java.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/misc.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/openldap.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/pmi.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/openldap/schema/ppolicy.ldif
# 修改域名，新增changedomain.ldif, 這里我自定義的域名為 yaobili.com，管理員用戶(hù)賬號為admin。
# 如果要修改，則修改文件中相應的dc=yaobili,dc=com為自己的域名
vim changedomain.ldif
-------------------------------------------------------------------------
dn: olcDatabase={1}monitor,cn=config
changetype: modify
replace: olcAccess
olcAccess: {0}to * by dn.base="gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth" read by dn.base="cn=admin,dc=yaobili,dc=com" read by * none
dn: olcDatabase={2}hdb,cn=config
changetype: modify
replace: olcSuffix
olcSuffix: dc=yaobili,dc=com
dn: olcDatabase={2}hdb,cn=config
changetype: modify
replace: olcRootDN
olcRootDN: cn=admin,dc=yaobili,dc=com
dn: olcDatabase={2}hdb,cn=config
changetype: modify
replace: olcRootPW
olcRootPW: {SSHA}LSgYPTUW4zjGtIVtuZ8cRUqqFRv1tWpE
dn: olcDatabase={2}hdb,cn=config
changetype: modify
add: olcAccess
olcAccess: {0}to attrs=userPassword,shadowLastChange by dn="cn=admin,dc=yaobili,dc=com" write by anonymous auth by self write by * none
olcAccess: {1}to dn.base="" by * read
olcAccess: {2}to * by dn="cn=admin,dc=yaobili,dc=com" write by * read
-------------------------------------------------------------------------
# 執行命令，修改配置
ldapmodify -Y EXTERNAL -H ldapi:/// -f changedomain.ldif

最后這里有5個(gè)修改，所以執行會(huì )輸出5行表示成功。

然后，啟用memberof功能

# 新增add-memberof.ldif, #開(kāi)啟memberof支持并新增用戶(hù)支持memberof配置
vim add-memberof.ldif
-------------------------------------------------------------
dn: cn=module{0},cn=config
cn: modulle{0}
objectClass: olcModuleList
objectclass: top
olcModuleload: memberof.la
olcModulePath: /usr/lib64/openldap
dn: olcOverlay={0}memberof,olcDatabase={2}hdb,cn=config
objectClass: olcConfig
objectClass: olcMemberOf
objectClass: olcOverlayConfig
objectClass: top
olcOverlay: memberof
olcMemberOfDangling: ignore
olcMemberOfRefInt: TRUE
olcMemberOfGroupOC: groupOfUniqueNames
olcMemberOfMemberAD: uniqueMember
olcMemberOfMemberOfAD: memberOf
-------------------------------------------------------------
# 新增refint1.ldif文件
vim refint1.ldif
-------------------------------------------------------------
dn: cn=module{0},cn=config
add: olcmoduleload
olcmoduleload: refint
-------------------------------------------------------------
# 新增refint2.ldif文件
vim refint2.ldif
-------------------------------------------------------------
dn: olcOverlay=refint,olcDatabase={2}hdb,cn=config
objectClass: olcConfig
objectClass: olcOverlayConfig
objectClass: olcRefintConfig
objectClass: top
olcOverlay: refint
olcRefintAttribute: memberof uniqueMember  manager owner
-------------------------------------------------------------
# 依次執行下面命令，加載配置，順序不能錯
ldapadd -Q -Y EXTERNAL -H ldapi:/// -f add-memberof.ldif
ldapmodify -Q -Y EXTERNAL -H ldapi:/// -f refint1.ldif
ldapadd -Q -Y EXTERNAL -H ldapi:/// -f refint2.ldif

到此，配置修改完了，在上述基礎上，我們來(lái)創(chuàng )建一個(gè)叫做 yaobili company 的組織，并在其下創(chuàng )建一個(gè) admin 的組織角色（該組織角色內的用戶(hù)具有管理整個(gè) LDAP 的權限）和 People 和 Group 兩個(gè)組織單元：

# 新增配置文件
vim base.ldif
----------------------------------------------------------
dn: dc=yaobili,dc=com
objectClass: top
objectClass: dcObject
objectClass: organization
o: Yaobili Company
dc: yaobili
dn: cn=admin,dc=yaobili,dc=com
objectClass: organizationalRole
cn: admin
dn: ou=People,dc=yaobili,dc=com
objectClass: organizationalUnit
ou: People
dn: ou=Group,dc=yaobili,dc=com
objectClass: organizationalRole
cn: Group
----------------------------------------------------------
# 執行命令，添加配置, 這里要注意修改域名為自己配置的域名，然后需要輸入上面我們生成的密碼
ldapadd -x -D cn=admin,dc=yaobili,dc=com -W -f base.ldif

通過(guò)以上的所有步驟，我們就設置好了一個(gè) LDAP 目錄樹(shù)：其中基準 dc=yaobili,dc=com 是該樹(shù)的根節點(diǎn)，其下有一個(gè)管理域 cn=admin,dc=yaobili,dc=com 和兩個(gè)組織單元 ou=People,dc=yaobili,dc=com 及 ou=Group,dc=yaobili,dc=com。

3. 安裝phpldapadmin

    ldap裝好后，下面安裝web界面phpldapadmin。

# yum安裝時(shí)，會(huì )自動(dòng)安裝apache和php的依賴(lài)。
# 注意： phpldapadmin很多沒(méi)更新了，只支持php5，如果你服務(wù)器的環(huán)境是php7，則會(huì )有問(wèn)題，頁(yè)面會(huì )有各種報錯
yum install -y phpldapadmin
# 修改apache的phpldapadmin配置文件
# 修改如下內容，放開(kāi)外網(wǎng)訪(fǎng)問(wèn)，這里只改了2.4版本的配置，因為centos7 默認安裝的apache為2.4版本。所以只需要改2.4版本的配置就可以了
# 如果不知道自己apache版本，執行 rpm -qa|grep httpd 查看apache版本
vim /etc/httpd/conf.d/phpldapadmin.conf
-----------------------------------------------------------------
  <IfModule mod_authz_core.c>
    # Apache 2.4
    Require all granted
  </IfModule>
-----------------------------------------------------------------
# 修改配置用DN登錄ldap
vim /etc/phpldapadmin/config.php
-----------------------------------------------------------------
# 398行，默認是使用uid進(jìn)行登錄，我這里改為cn，也就是用戶(hù)名
$servers->setValue('login','attr','cn');
# 460行，關(guān)閉匿名登錄，否則任何人都可以直接匿名登錄查看所有人的信息
$servers->setValue('login','anon_bind',false);
# 519行，設置用戶(hù)屬性的唯一性，這里我將cn,sn加上了，以確保用戶(hù)名的唯一性
$servers->setValue('unique','attrs',array('mail','uid','uidNumber','cn','sn'));
-----------------------------------------------------------------
# 啟動(dòng)apache
systemctl start httpd
systemctl enable httpd

4. 登錄phpldapadmin界面

上一步，啟動(dòng)了apache服務(wù)后，在瀏覽器上訪(fǎng)問(wèn): http://ip/ldapadmin ，然后使用上面定義的用戶(hù)，進(jìn)行登錄，如下：

OK，到此openldap和phpldapadmin 就安裝完成了。至于如果使用，并將ldap集成到我們常用的工具，如jumpserver，jenkins等等。這些有機會(huì )的話(huà)，后面再新增一篇進(jìn)行記錄