LDAP安装配置(原创)

LDAP（轻量级目录访问服务），通过配置这个服务，我们也可以在linux下面使用目录的形式管理用户，就像windows下面的AD一样，方便我们管理。下面我们就一起来配置openldap服务。本文运行环境：CentOS 5。

软件需求：

db-4.7.25.tar.gz （http://www.oracle.com/technology/global/cn/software/products/berkeley-db/index.html）

openldap-stable-20090411.tgz （http://www.openldap.org/software/download/）

安装openldap

1、安装BerkeleyDB

# tar  zxvf  db-4.7.25.tar.gz

# cd  db-4.7.25/build_unix

# ../dist/configure

# make

# make  install

# vi  /etc/ld.so.conf

加入一下语句：

/usr/local/BerkeleyDB.4.7/lib

# /sbin/ldconfig

2、安装openldap

# tar  zxvf  openldap-stable-20090411.tgz

# cd  openldap-2.4.16

# ./configure  --prefix=/usr/local/openldap

# make depend

# make

# make install

3、检查安装结果

安装好后，系统会自动生成一些.schema文件，我们可以使用命令：

# ll  /usr/local/etc/openldap/schema/*.schema

-r--r--r-- 1 root root  6190 Jun 13 15:58 /usr/local/etc/openldap/schema/collective.schema

-r--r--r-- 1 root root  8063 Jun 13 15:58 /usr/local/etc/openldap/schema/corba.schema

-r--r--r-- 1 root root 20499 Jun 13 15:58 /usr/local/etc/openldap/schema/core.schema

-r--r--r-- 1 root root 73994 Jun 13 15:58 /usr/local/etc/openldap/schema/cosine.schema

-r--r--r-- 1 root root 10388 Jun 13 15:58 /usr/local/etc/openldap/schema/duaconf.schema

-r--r--r-- 1 root root  3289 Jun 13 15:58 /usr/local/etc/openldap/schema/dyngroup.schema

-r--r--r-- 1 root root  6267 Jun 13 15:58 /usr/local/etc/openldap/schema/inetorgperson.schema

-r--r--r-- 1 root root 13901 Jun 13 15:58 /usr/local/etc/openldap/schema/java.schema

-r--r--r-- 1 root root  2387 Jun 13 15:58 /usr/local/etc/openldap/schema/misc.schema

-r--r--r-- 1 root root  7640 Jun 13 15:58 /usr/local/etc/openldap/schema/nis.schema

-r--r--r-- 1 root root  1514 Jun 13 15:58 /usr/local/etc/openldap/schema/openldap.schema

-r--r--r-- 1 root root 20467 Jun 13 15:58 /usr/local/etc/openldap/schema/pmi.schema

-r--r--r-- 1 root root 19603 Jun 13 15:58 /usr/local/etc/openldap/schema/ppolicy.schema

配置openldap

openldap的配置文件主要为/usr/local/openldap/etc/openldap/slapd.conf
#此句是用来将目录所用到的schema文件包含进来；openldap一般默认带有几个schema，在我们的配置文件安装目录下的schema目录中存 放。本句中的core.schema是LDAP V3中必须的，它给出了LDAP V3中最基本的attribute和objects的定义。其它的还有：corba.schema、dyngroup.schema、 java.schema  nis.schema、openldap.schema、cosine.schema、 inetorgperson.schema、misc.schema、ppolicy.schema

include /usr/local/etc/openldap/schema/collective.schema

include /usr/local/etc/openldap/schema/cosine.schema

include /usr/local/etc/openldap/schema/duaconf.schema

include /usr/local/etc/openldap/schema/dyngroup.schema

include /usr/local/etc/openldap/schema/inetorgperson.schema

include /usr/local/etc/openldap/schema/java.schema

include /usr/local/etc/openldap/schema/misc.schema

include /usr/local/etc/openldap/schema/nis.schema

include /usr/local/etc/openldap/schema/openldap.schema

include /usr/local/etc/openldap/schema/pmi.schema

include /usr/local/etc/openldap/schema/ppolicy.schema

#此句用来定义slapd进程运行时的pid文件，需要使用绝对路径。

pidfile         /usr/local/openldap/var/run/slapd.pid

#此句用来定义包含当前正在运行的slapd进程所用到的命令行参数的文件，需要使用绝对路径。

argsfile        /usr/local/openldap/var/run/slapd.args

#以下用来指定动态加载的后端模块。

# Load dynamic backend modules:

# modulepath    /usr/local/openldap/libexec/openldap

# moduleload    back_bdb.la

# moduleload    back_ldap.la

# moduleload    back_ldbm.la

# moduleload    back_passwd.la

# moduleload    back_shell.la

#以下是安全相关的声明语句。常用到的参数有五类，除了Require和security外还有Allow、Disallow和password-hash等。

Require参数用来使管理员指定访问目录时必须遵循的规则和条件；这种指定可以是全局的，也可以仅用来限制对某个后端数据库的访问限制。

security参数用来让管理员指定加强安全性的一般规则。

# Sample security restrictions

#       Require integrity protection (prevent hijacking)

#       Require 112-bit (3DES or better) encryption for updates

#       Require 63-bit encryption for simple bind

# security ssf=1 update_ssf=112 simple_bind=64

以下主要是用来定义访问控制列表。

# Sample access control policy:

#       Root DSE: allow anyone to read it

#       Subschema (sub)entry DSE: allow anyone to read it

#       Other DSEs:

#               Allow self write access

#               Allow authenticated users read access

#               Allow anonymous users to authenticate

#       Directives needed to implement policy:

# access to dn.base="" by * read

# access to dn.base="cn=Subschema" by * read

# access to *

#       by self write

#       by users read

#       by anonymous auth

#

# if no access controls are present, the default policy

# allows anyone and everyone to read anything but restricts

# updates to rootdn.  (e.g., "access to * by * read")

#

# rootdn can always read and write EVERYTHING!

#######################################################################

# BDB database definitions

#######################################################################

#定义使用的后端数据存储方式。其后可以跟的值有bdb、ldbm、passwd和shell。bdb指使用Berkley DB 4数据库。

database        bdb

#定义suffix,以下部分可以改作你的域名中相关的部分，如"dc=example,dc=com"。

suffix          "dc=my-domain,dc=org"

#定义此目录的超级管理员帐号，类同于系统中的root。由于访问控制对此用户是不生效的，因此存在很大的安全隐患。建议安装配置及调试完成以后移除此帐号。

rootdn          "cn=Manager,dc=mydomain,dc=org"

定义超级管理员帐号的密码，这里使用的是明文存储（secret即是其密码）的方式。

rootpw          secret

这是极不安全的，建议使用加密方式存储，可以使用的加密方式有： CRYPT、MD5、SMD5、SHA和SSHA。产生加密密码散列的方法是使用slappasswd命令，用-h选项指明加密时使用的方式。示例如下：

# /usr/local/openldap/sbin/slappasswd -h {SSHA}

New password:

Re-enter new password:

{SSHA}k2H1GPM/95VfgsKg2jZv9hV+2GCH04hC

#这一句用来指定目录相关数据的存放位置。此目录最好只能由运行slapd进程的用户所有，推荐权限为700

directory       /usr/local/openldap/var/openldap-data

#此句用来指定slapd索引时用到的attribute，eq指索引时的匹配规则。主要是用来优化查询的。常用到的匹配规则有：approx（模糊匹配, approximate）、eq（精确匹配，equality）、pres（现值匹配，若某记录的此attribute没有值则不进行匹配， presence）和sub （子串匹配，substring）。

index   objectClass     eq

导入数据

先建立一个创建起始结点所用的ldif文件

#vi init.ldif

输入以下内容（可以根据自己的需要修改）

dn: dc=mydomain,dc=org   #定义根结点

dc: mydomain

objectClass: top

objectClass: domain

dn: ou=people,dc=mydomain,dc=org   #定义一个OU

ou: people

objectClass: organizationalUnit

注意：ldif文件中，每一行中冒号后有一个空格，行尾一定不能有空格。不同记录一定要有空行，且不能包含空格。切记!

导入数据时，可以离线也可以在线操作，这边先示范如何使用离线import命令导入到目录中（要先关闭slapd进程）

#kill -INT `cat /usr/local/openldap/var/run/slapd.pid`

# /usr/local/openldap/sbin/slapadd -v -l ./init.ldif

bdb_db_open: Warning - No DB_CONFIG file found in directory /var/openldap/data-3: (2)

Expect poor performance for suffix dc=mydomain,dc=org.

added: "dc=mydomain,dc=org" (00000001)

added: "ou=people,dc=mydomain,dc=org" (00000002)

命令中：

-v选项表示启用verbose模式，即输出执行中的具体信息；

-l表示后面附加ldif文件。

其它常用的选项还有:

-d  指定debug向日志文件输出信息，后面跟日志级别

-f  指定要读取的配置文件

启动服务进程

#/usr/local/openldap/libexec/slapd

在线导入具体的记录信息ldif文件

#vi users.ldif

dn: cn=Tom Black,ou=people,dc=mydomain,dc=org   #定义人员1

cn: Tom Black

sn: Black

mail: [e-mail]

telephoneNumber: 371-6338-3522

objectClass: inetOrgPerson

dn: cn=Jerry Smith,ou=people,dc=mydomain,dc=org   #定义人员2

cn: Jerry Smith

sn: Smith

mail: [e-mail]

telephoneNumber: 371-6338-3521

objectClass: inetOrgPerson

导入ldif文件

# /usr/local/openldap/bin/ldapmodify -D "cn=Manager,dc=mydomain,dc=org" -W -x -a -f users.ldif

Enter LDAP Password:

adding new entry "cn=Tom Black,ou=people,dc=mydomain,dc=org"

adding new entry "cn=Jerry Smith,ou=people,dc=mydomain,dc=org"

命令中:

-D选项表示指定绑定到LDAP的DN；

-W表示提示用户输入密码；

-x表示使用简单身份验正方式，默认的是使用sasl进行验正；

-a表示将文件中的条目添加至目录中，默认情况下，ldapmodify只修改现有记录；

-f用来指定ldif文件;

配置文件中的高级功能使用方法

开启日志功能

要启用日志功能，需要在编译时指定--enable-debug 选项，默认是允许的。要打开slapd的日志功能，需要在slapd.conf中的全局配置段添加loglevel指令，并后跟一个十进制数字表示的日志级别，如下所示：

# Added logging parameters

loglevel     256

其日志级别如下所示：

-1 记录所有的信息

0 不记录debug

1 跟踪功能调用的信息

2 包处理的debug信息

4 丰富的debug信息

8 连接管理信息

16 包的收发信息

32 搜索过滤的处理过程

64 配置文件的处理过程

128 访问控制列表处理过程

256 连接、操作及其结果的统计数据

512 向客户端返回的结果的统计信息

1024 与shell后端的通信信息

2048 显示记录条目的分析信息

4096 数据库缓存处理信息

8192 数据库索引

16384 从服务器数据同步资源消耗处理信息

若要记录所有的debug日志，可以使用LOG_LEVEL4 syslogd系统日志来记录，这需要在slapd.conf中添加如下语句实现：

local4.debug /var/log/slapd.log

为BDB后端数据库实例指定在内存中的缓存空间大小

在如下句子后

DBDirectory: /usr/local/openldap/var/openldap-data

后添加：

DBCachesize: 2000

常见报错

1、ldapadd: no DN specified

ldif文件格式不正确，可能还有其他原因。之前就可以，为了解决中文的问题，转换了下格式结果出现这个问题，修改回来后解决。

2、ldap_add: Already exists (68)

这个问题容易明白，在一个dn下存在一个与新加entry相同cn或ou的其他entry

3、ldap_add: Invalid syntax (21)

我这里是其中包含中文编码的问题

4、ldap_add: No such object (32)

如：adding new entry "ou=jisuanjikexue,o=cqupt,dc=com"

表示父节点没有创建，需要先添加dn: ou＝cqupt,dc=com

5、ldap_bind: Invalid credentials (49)

ldapadd -x -D "cn=Manager,o=cqupt,dc=com" -W -f webex.ldif 我的正确命令应该是这个。如果错写成   ldapadd -x -D "cn=Manager,o=cqupt,dc=com" -W -f webex.ldif 则会报上面的错误。 另外一个情况是ldif文件中的内容有错误。

6、configure: error: BDB/HDB: BerkeleyDB version incompatible 

#export CPPFLAGS="-I/usr/local/BerkeleyDB.4.8/include" 

#export LDFLAGS="-L/usr/local/lib -L/usr/local/BerkeleyDB.4.8/lib -R/usr/local/BerkeleyDB.4.8/lib"  

#export LD_LIBRARY_PATH="/usr/local/BerkeleyDB.4.8/lib" 

环境变量问题：  

env CPPFLAGS="-I /usr/local/BerkeleyDB.4.8/include" LDFLAGS="-L /usr/local/BerkeleyDB.4.8/lib"  ./configure --prefix=/openldap_with_crypt  --enable-modules   --enable-ldbm   --enable-crypt --enable-spasswd --enable-accesslog  --enable-spasswd

参考至: http://doc.linuxpk.com/28400.html

          http://mengsir.blog.51cto.com/2992083/760890

          http://mengsir.blog.51cto.com/2992083/760890

          http://www.ibm.com/developerworks/cn/linux/l-openldap/

          http://www.process.com/techsupport/installing_configuring_openldap.pdf

          http://hi.baidu.com/cqmking/blog/item/2e3e93081376bb3be9248808.html
          http://www.zytrax.com/books/ldap/ch5/
          http://www.openldap.org/doc/admin24/appendix-common-errors.html

          http://www.ithov.com/linux/100709_4.shtml

          http://www.openldap.org/doc/admin24/

本文原创，转载请注明出处、作者

如有错误欢迎指正

邮箱:[e-mail]