标签：openldap ldap jira phpldapadmin lam
OpenLDAP是轻型目录访问协议（Lightweight Directory Access Protocol, LDAP）的自由和开源实现，在其OpenLDAP许可证下发行，并已经被包含在众多流行的Linux发行版中。
使用轻量级目录访问协议（LDAP）构建集中的身份验证系统可以减少管理成本，增强安全性，避免数据复制的问题，并提高数据的一致性。
通常，在实际工作环境中，都会通过LDAP来构建一个统一的账号管理、身份验证平台，实现SSO单点登录机制。
LDAP这个东西，是公司准备实现统一用户身份认证所了解到的，之前完全没有概念， 网上搜索了一些基础，理论知识，简直蒙圈了，实在是太抽象了。后来一想， 理论的知识先大概有个了解， 先动手让ldap跑起来再说其他， 在动手做的时候，如果遇到问题在回头过去查阅资料，说不定慢慢就会理解了。
第一次搭建OpenLDAP的时候，查阅了很多论坛、博客的帖子，发现好多都是讲的不够完善，或者是点到即止，在安装和配置遇到问题的时候，总要浪费很大一部分时间来游走于各大搜索引擎去寻根问药，相当痛苦，下面就是结合网友以及自己尝试摸索的过程，总结成文，希望能够帮助到有需要的朋友。
配置环境：
服务器操作系统： CentOS 6.5 x86_64 , RHEL/Suse 应该都类似
OpenLDAP版本：OpenLDAP 2.4
其实如果不是对LDAP各种参数要求都十分严格的情况下，比较建议采用 yum 的方式安装。因为相关依赖环境，功能都十分全面，对于初学者，强烈建议第一次使用yum来安装。
准备环境：
确保SELinux关闭：
# getenforce 1、临时关闭 # setenforce 0 2、永久关闭 # vi /etc/selinux/config 将SELINUX=enforcing 改为 SELINUX=disabled 重启机器即可
设定iptables防火墙规则：
# vim /etc/sysconfig/iptables *filter :INPUT ACCEPT [0:0] :FORWARD ACCEPT [0:0] :OUTPUT ACCEPT [0:0] -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT -A INPUT -p icmp -j ACCEPT -A INPUT -i lo -j ACCEPT -A INPUT -m state --state NEW -m tcp -p tcp --dport 22 -j ACCEPT -A INPUT -m state --state NEW -m tcp -p tcp --dport 80 -j ACCEPT -A INPUT -m state --state NEW -m tcp -p tcp --dport 389 -j ACCEPT -s 192.168.1.0/16 -A INPUT -m state --state NEW -m tcp -p tcp --dport 636 -j ACCEPT -s 192.168.1.0/16 -A INPUT -j REJECT --reject-with icmp-host-prohibited -A FORWARD -j REJECT --reject-with icmp-host-prohibited COMMIT 重新加载后如下： # iptables -L ACCEPT tcp -- anywhere anywhere state NEW tcp dpt:ssh ACCEPT tcp -- anywhere anywhere state NEW tcp dpt:http ACCEPT tcp -- 192.168.1.0/16 anywhere state NEW tcp dpt:ldap ACCEPT tcp -- 192.168.1.0/16 anywhere state NEW tcp dpt:ldaps
同步系统时间：
# ntpdate time.nist.gov
1、yum 安装所需软件
# yum install -y openldap-* # yum install -y compat-openldap # 这个包和主从配置有很大关系
2、安装完成后，准备配置文件
# cp /usr/share/openldap-servers/slapd.conf.obsolete /etc/openldap/slapd.conf
OpenLDAP相关配置文件：
/etc/openldap/slapd.conf 主配置文件，管理员dn，密码，日志配置，权限等设置
3、创建LDAP管理员密码
LDAP可以支持明文密码，但是我们强烈建议使用加密密码。 通过 slappasswd 命令创建加密密码，返回一串密文，先复制保存一下，下一步需要在LDAP配置文件中使用。
ps. 这里我输入的密码是： ldap
# slappasswd
New password:
Re-enter new password:
{SSHA}5EkFHScR0hN0r3oRhd0aP4tyJ0ByopCd4、进入 /etc/openldap 目录下，编辑 slapd.conf 配置文件。
主要修改的地儿，suffix, rootdn, rootpw， rootdn 其实就是openldap的管理员。
# cp /etc/openldap/slapd.conf /etc/openldap/slapd.conf.ori
# vi /etc/openldap/slapd.conf
....
# enable server status monitoring (cn=monitor)
database monitor
access to *
by dn.exact="gidNumber=0+uidNumber=0,cn=peercred,cn=external,cn=auth" read
by dn.exact="cn=Manager,dc=test,dc=com" read
by * none
#######################################################################
# database definitions
#######################################################################
database bdb
suffix "dc=test,dc=com"
checkpoint 1024 15
rootdn "cn=Manager,dc=test,dc=com"
# Cleartext passwords, especially for the rootdn, should
# be avoided. See slappasswd(8) and slapd.conf(5) for details.
# Use of strong authentication encouraged.
# rootpw secret
# rootpw {crypt}ijFYNcSNctBYg
rootpw {SSHA}5EkFHScR0hN0r3oRhd0aP4tyJ0ByopCd
.......
保存退出。当然，也可以如下设置明文密码：
5、BerkeleyDB配置。 拷贝 DB_CONFIG 文件到指定目录， 否则后续会报错： warning - no DB_CONFIG file found in directory /var/lib/ldap
PS: OpenLDAP默认使用的是伯克利数据库作为后台数据存储介质，在OpenLDAP-Servers包中已经包含了，直接把配置文件复制到相关目录即可。
# cp /usr/share/openldap-servers/DB_CONFIG.example /var/lib/ldap/DB_CONFIG
6、删除 /etc/openldap/slapd.d 目录下所有的文件，否则后续在使用 ldapadd 命令的时候会报错
PS: 默认情况下，/etc/openldap/slapd.d目录下有一些默认的配置文件，必须删除，然后重新建议，这一步很重要
这是因为 2.4 和 2.3 配置文件兼容性问题导致， 参考： http://www.openldap.org/doc/admin24/appendix-common-errors.html
# rm -rf /etc/openldap/slapd.d/*
7、配置相应目录权限
# chown -R ldap:ldap /var/lib/ldap/ # chown -R ldap:ldap /etc/openldap/
8、启动 LDAP 的 slapd 服务， 并设置开机启动
# chkconfig slapd on # service slapd start
9、重新生成 slapd.d 下的配置文件
# slaptest -f /etc/openldap/slapd.conf -F /etc/openldap/slapd.d config file testing succeeded 然后重新赋予配置文件的权限： # chown -R ldap:ldap /etc/openldap/slapd.d
10、重新启动 LDAP 的 slapd 服务
# service slapd restart
使用 netstat -tulpn 查看服务是否正常启动
11、开启 SSL
# vim /etc/sysconfig/ldap SLAPD_LDAPS=yes
我们可以看到， OpenLDAP监听端口：
默认监听端口： 389 （明文数据传输）
加密监听端口： 636 （加密数据传输）
1、编辑 /etc/openldap/slapd.conf
# vim /etc/openldap/slapd.conf loglevel 296
2、编辑 /etc/rsyslog.conf
# vim /etc/rsyslog.conf local4.* /var/log/ldap.log
3、重启服务
# service rsyslog restart # service slapd restart
系统用户通常保存在 /etc/passwd, /etc/shadow文件内，所以我们需要迁移用户数据到openldap数据库。但是LDAP只能识别特定格式的文件，即后缀为 ldif 的文件（也是文本文件），所以不能直接使用 /etc/passwd, /etc/shadow直接导入。 最简单的方法是使用padl提供的迁移工具包，是一系列perl编写的脚本， migrationtools 工具，之前的openldap包中已经包含了这些脚本，但是在redhat6.5中已经没有了，要单独下载。
1、安装配置 migrationtools
# yum install -y migrationtools
2、切换到 migrationtool 目录下，进行基本配置
# cd /usr/share/migrationtools/ 编辑migrate_common.ph # vi migrate_common.ph ... # Default DNS domain $DEFAULT_MAIL_DOMAIN = "test.com"; # Default base $DEFAULT_BASE = "dc=test,dc=com"; ....... 保存退出。：-）
3、生成 ldif 文件
a、在目录MigrationTools里面使用migrate_base.pl脚本生成基本的数据结构
# ./migrate_base.pl > /tmp/base.ldif 导入数据： ##﹚ 指定你在slapd.conf中设置的管理员密码，也可以使用￤，交互式输入密码 ##ゝ 指定数据文件的路径 # ldapadd -x -D "cn=Manager,dc=test,dc=com" -w ldap -f /tmp/base.ldif 查询已经导入数据库的数据： # ldapsearch -h -H ldap://192.168.1.35 -b "dc=test,dc=com"
b、在目录MigrationTools里面使用migrate_passwd.pl 和 migrate_group.pl 脚本将 /etc/passwd, /etc/group文件中的用户转化为 ldap 可以识别的数据结构 ldif 格式的文件
# ./migrate_passwd.pl /etc/passwd /tmp/passwd.ldif # ./migrate_group.pl /etc/group /tmp/group.ldif 导入数据： # ldapadd -x -D "cn=Manager,dc=test,dc=com" -w ldap -f /tmp/passwd.ldif # ldapadd -x -D "cn
安装EPEL仓库
# rpm -ivh http://mirrors.ukfast.co.uk/sites/dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rp
安装phpLDAPadmin
# yum install -y phpldapadmin
修改 phpldapadmin配置文件（该文件会自动创建），添加访问权限
# vim /etc/httpd/conf.d/phpldapadmin.conf 在这行后面添加 Allow from ::1 Allow from 192.168.1 //这里修改为你自己的ip段
修改php配置文件， 禁止自动登录和php登录配置
# vim /etc/phpldapadmin/config.php #(line 398) //$servers->setValue(‘login‘,‘attr‘,‘uid‘); #(line 530) $servers->newServer(‘ldap_pla‘); $servers->setValue(‘server‘,‘name‘,‘LDAP Server‘); $servers->setValue(‘server‘,‘host‘,‘127.0.0.1‘); $servers->setValue(‘server‘,‘port‘,389); $servers->setValue(‘server‘,‘base‘,array(‘dc=test,dc=com‘)); $servers->setValue(‘login‘,‘auth_type‘,‘session‘); $servers->setValue(‘login‘,‘bind_id‘,‘dc=test,dc=com‘); $servers->setValue(‘login‘,‘bind_pass‘,‘ldap‘); $servers->setValue(‘server‘,‘tls‘,false);
配置完成后，启动apache
# chkconfig httpd on # service httpd start
然后通过浏览器进行访问： http://192.168.1.35/ldapadmin/ （这个ip 换成你自己的实际ip）
这里需要注意的是： Login DN: 一定要是完整的 DN， 而不是 RDN。
密码就是我们前面 slappasswd 命令设置的密码， 也就是ldap管理员 rootdn（Manager）的密码，然后就登录成功了。
下载ldap-account-manager包，我这里下载的是较老的版本4.6 ，（最新版应该 6.0了)。
如果没有lamp环境 # yum install -y httpd php php-ldap php-gd # unzip ldap-account-manager-4.6.RC1.zip # mv ldap-account-manager-4.6.RC1 /var/www/html/lam # chown -R apache:apache /var/www/html/lam 顺便编辑之前的 /etc/phpldapadmin/conf.php 中增加一行 # vim /etc/httpd/conf.d/phpldapadmin.conf Alias /lam /var/www/html/lam
配置
# cd /var/www/html/lam/config # cp config.cfg_sample config.cfg # cp lam.conf_sample lam.conf # vim lam.conf serverURL: ldap://192.168.1.35:389 admins: cn=Manager,dc=test,dc=com treesuffix: dc=test,dc=org 其他 dc=my-domain 全部更换为： dc=yourdomain
重启 httpd 服务
# service httpd restart
然后通过浏览器访问即可， http://192.168.1.35/lam ，更改为你自己的 ip
然后通过 Manager 账号以及密码就可以登录成功了。
至此， 可能我们基本可以把 slapd 跑起来了， 但是OpenLDAP做起来感觉还是比较麻烦，也是自己结合网上的资料、教程，实际测试成功后，整理了这篇文章，希望能够帮助到有需要的朋友。
后续还有ldap的具体应用， 比如 wifi， jira, VPN, jenkins 等应用案例。
本文出自 “Share your knowledge” 博客，请务必保留此出处http://skypegnu1.blog.51cto.com/8991766/1939302
标签：openldap ldap jira phpldapadmin lam
原文地址：http://skypegnu1.blog.51cto.com/8991766/1939302
