统一身份认证系统 OpenLDAP 完整部署

LDAP 介绍

LDAP 是什么？在那些地方用会用到 LDAP？LDAP 英文名称：Lightweight Directory Access Protocol 轻型目录访问协议。常用在单点登录，用户可以通过一个用户和密码登录多个服务，方便管理。目前我们使用的一下工具，Jenkins，GitLab，Jumpserver，Grafana，Confluence，NextCloud 等等，很多开源的软件都集成了 LDAP，方便了用户使用，也方便了运维管理。下面针对 LDAP 在 CentOS7 环境中的安装方法进行一下说明：

LDAP 一般组织架构

软件安装

yum install openldap openldap-clients openldap-servers -y

配置 OpenLDAP Server

vim /etc/openldap/slapd.d/cn=config/olcDatabase={1}monitor.ldif

将 cn=Manager,dc=my-domain,dc=com

改为你自己的，内容可以随便，但是所有地方都要一致cn=admin,dc=wuhanjiayou,dc=cn

vim /etc/openldap/slapd.d/cn=config/olcDatabase={2}hdb.ldif

将 

olcSuffix: dc=my-domain,dc=com 

olcRootDN: cn=Manager,dc=my-domain,dc=com

改为 

olcSuffix: dc=wuhanjiayou,dc=cn 

olcRootDN: cn=admin,dc=wuhanjiayou,dc=cn

然后在末尾添加一行此处设置的是 认证密码

olcRootPW: 123456

3. 拷贝 DB 文件

cp /usr/share/openldap-servers/DB_CONFIG.example /var/lib/ldap/DB_CONFIG

// 修改该文件的权限
chown -R ldap:ldap /var/lib/ldap/

4. 测试配置文件是否正确

slaptest -u

5. 如果修改了 hostname，相应的要修改 hosts，不然执行命令会卡住，很长时间才会执行完成。

hostnamectl set-hostname ldap
echo '127.0.0.1 ldap' >> hosts

6. 启动服务

systemctl start slapd
systemctl enable slapd

7. 添加 scheme 表     [ 重要 ]

否则，后面使用 ldapaddgroup 命令会报错 Error adding group test to LDAP

ldapadd -Y EXTERNAL -H ldapi:/// -D "cn=config" -f /etc/openldap/schema/nis.ldif
ldapadd -Y EXTERNAL -H ldapi:/// -D "cn=config" -f /etc/openldap/schema/cosine.ldif
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

创建 base.ldif 文件

1. 创建如下文件，内容按照自己的配置修改

[root@localhost ~] vim base.ldif
dn: dc=wuhanjiayou,dc=cn
objectClass: dcObject
objectClass: organization
o: wuhanjiayou.cn
dc: wuhanjiayou

dn: ou=users,dc=wuhanjiayou,dc=cn
objectClass: organizationalUnit
objectClass: top
ou: users

dn: ou=groups,dc=wuhanjiayou,dc=cn
objectClass: organizationalUnit
objectClass: top
ou: groups

2. 建立最基础的目录结构

ldapadd -x -W -D "cn=admin,dc=wuhanjiayou,dc=cn" -f base.ldif

3. 验证基础目录是否创建成功

vim /etc/openldap/ldap.conf
添加如下行信息
BASE    dc=wuhanjiayou,dc=cn
URI     ldap://10.0.59.114 ldap://10.0.59.114:666

管理用户与组

1. 安装依赖包 yum install sharutils
yum install sharutils -y

2. Ldapscripts 需要手动下载安装
cd /opt
tar xzvf ldapscripts-2.0.8.tgz
cd ldapscripts-2.0.8 && make install PREFIX=/

3. 配置 ldapscripts
vim /etc/ldapscripts/ldapscripts.conf
3.1 将 SERVER="ldap://localhost" 改成 SERVER="ldap://10.0.59.114"
3.2 将 SUFFIX="dc=example,dc=com" 改成 SUFFIX="dc=wuhanjiayou,dc=cn"
3.3 将 BINDDN="cn=Manager,dc=example,dc=com" 改成 BINDDN="cn=admin,dc=wuhanjiayou,dc=cn"
3.4 去掉 #ICONVCHAR="ISO-8859-15" 的注释


4. 修改 /etc/ldapscripts/ldapscripts.passwd 文件
sh -c "echo -n '123456' > /etc/ldapscripts/ldapscripts.passwd"

管理 Group，User

// 创建 Group
ldapaddgroup it

// 创建 User
ldapadduser wangj it

// 设置用户密码
ldapsetpasswd wangj

基于 PHPLDAPAdmin 访问管理后台

LDAP 装好后，下面安装 Web 界面 PHPLDAPAdmin。

我们可以安装 PHPLDAPAdmin Web 平台来管理我们的 OpenLDAP 服务，这样就可以在 Web 页面进行 OpenLDAP 服务的数据增删改查，方便运维。

安装 Apache 和 PHP

yum install httpd php php-ldap php-gd php-mbstring php-pear php-bcmath php-xml -y

安装 PHPLDAPAdmin

# 需要先安装 epel 源
yum -y install epel-release
yum --enablerepo=epel -y install phpldapadmin

配置 HTTPD

vim /etc/httpd/conf/httpd.conf
AllowOverride All                                         // 第 151 行
DirectoryIndex index.html index.cgi index.php             // 第 164 行

# 末尾添加如下几行
# server's response header
ServerTokens Prod
# keepalive is ON
KeepAlive On

配置 PHPLDAPAdmin，修改登入规则和监听端口

vim /etc/phpldapadmin/config.php

# 397 行取消注释, 398 行添加注释 [设置通过 DN 整个条目来登入 PHPLDAPAdmin 而不是通过用户的 UID 来登入 ]
$servers->setValue('login','attr','dn');
// $servers->setValue('login','attr','uid');

# [ 如果 LDAP 服务安装和 PHPLDAPAdmin 服务安装不在同一个服务器上 ]
# 则修改 298 和 301 行, 修改 PHPLDAPAdmin 监听的 IP 和端口, 并取消注释
# [ 如果 LDAP 服务和 PHPLDAPAdmin 服务在同一台服务器上 ]
# 且 LDAP 的端口为 389, 则可不修改, 直接取消注释即可
/* Examples:
   'ldap.example.com',
   'ldaps://ldap.example.com/',
   'ldapi://%2fusr%local%2fvar%2frun%2fldapi'
           (Unix socket at /usr/local/var/run/ldap) */
$servers->setValue('server','host','127.0.0.1');

配置 PHPLDAPAdmin

修改 PHPLDAPAdmin 的配置文件，访问控制权限 vim /etc/httpd/conf.d/phpldapadmin.conf，允许谁访问添加访问的 IP 段，允许远程客户端访问。

vim /etc/httpd/conf.d/phpldapadmin.conf

#
#  Web-based tool for managing LDAP servers
#

Alias /phpldapadmin /usr/share/phpldapadmin/htdocs
Alias /ldapadmin /usr/share/phpldapadmin/htdocs

<Directory /usr/share/phpldapadmin/htdocs>
  <IfModule mod_authz_core.c>
    # Apache 2.4  # Apache版本是 2.4 的修改这里的配置
    Require local
    Require  ip  10.0.59.0/24  # 修改
  </IfModule>

  <IfModule !mod_authz_core.c>
    # Apache 2.2
    Order Deny,Allow
    Deny from all
    Allow from 127.0.0.1
    Allow from ::1
  </IfModule>
</Directory>

启动 PHPLDAPAdmin

systemctl enable httpd
systemctl start httpd

Web 浏览器访问网址

使用数据库管理账户登入 PHPLDAPAdmin，如果登入成功，则表示配置成功。

http://10.0.59.114/ldapadmin/

用户名：cn=admin,dc=wuhanjiayou,dc=cn 密码：123456

如登录报错：可尝试关闭服务器 SELinux 试试

setenforce 0

大功告成~