OpenLDAP,Windows,MySQL之初搭建

安装OpenLDAP for Windows，mysql，

另附无博文链接http://huangdekai1.blog.163.com/blog/static/3057141620126134262357/

注意：ODBC数据源与操作系统有很大的关系，ODBC必须装32位的，否则OpenLDAP启动会报错，Native ERROR。

在64位Windows系统中，默认“数据源(ODBC)”是64位的，包括“控制面板-》管理工具-》数据源 ”或在“运行”中直接运行“ODBCAD32”程序。如果客户端是32位应用程序，仍然需要配置32位ODBC数据源，这时需要运行“C:\Windows\SysWOW64\odbcad32.exe”来启动“ODBC数据源管理器”，添加32位的ODBC数据源。

slapd.exe -d 1 -f ./slapd.conf

LDAPBROWSER

为工作原因，需要在windows操作系统下，搭建openldap+mysql工具平台。曾经尝试在网上搜索相关的文章，但是openldap与DBMS连接的内容非常少，在windows操作系统下配置和使用的资料更是少之又少。所以只好查阅了许多零碎的参考资料，摸索了几天，终于折腾成功。在这里把详细的过程记录下来，希望能帮助有需要的朋友。

一、准备工作：

1、 安装好OpenLDAP：

        我使用的是openldap-2.2.29-db-4.3.29-openssl-0.9.8a-win32_Setup.exe，网上很多地方提供下载，在windows下如何安装的文章也很多。

        先安装配置好LDAP，确认能够正常使用。

2、 安装好MySQL：

        我使用的是5.1.35版本。应该5.0版本以上都没问题。

3、 从openldap官网下载源码包，里面有需要用到的测试数据和配置样例。最好是与安装你安装的OpenLDAP版本一致。本文下载的是openldap-2.2.29.tgz。解压缩至本地目录。

二、部署：

现在开始正式部署。

1、 安装MYSQL的ODBC驱动：下载驱动程序，安装即可（本文使用的是MyODBC-3.51.11-2-win.exe）。

2、 创建数据库：

1） 创建一个空数据库；

2） 在下载的源码包中找到servers/slapd/back-sql/rdbms_depend/mysql目录，在MYSQL客户端依次运行该目录下的个SQL脚本文件：

testdb_create.sql

testdb_data.sql

backsql_create.sql  //只有这个脚本里的内容是必须的，其他脚本里的都是测试数据。第一次配置时还是全部执行。

testdb_metadata.sql

3、 创建一个可操作以上数据库的账户，并设置密码。

4、 创建ODBC数据源，连接到以上数据库。(开始菜单-->设置-->控制面板-->管理工具-->数据源（ODBC），详细的就不介绍了）。

5、 修改ldap安装目录下的slapd.conf文件，将配置文件中BDB配置相关的代码全部删除掉（就是从“database bdb”语句到最后的内容），添加以下代码：

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

# sql database definitions

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

database sql

suffix "dc=example,dc=com"

rootdn "cn=root,dc=example,dc=com"

rootpw pwd

dbname ldap //数据源名称，不是数据库名称。

dbuser user  //数据库用户帐号

dbpasswd userpwd //数据库用户密码

subtree_cond "ldap_entries.dn LIKE CONCAT(''%'',?)"

insentry_query "INSERT INTO ldap_entries (dn,oc_map_id,parent,keyval) VALUES (?,?,?,?)"

lastmod off

has_ldapinfo_dn_ru no

upper_func "upper"

strcast_func "CONCAT"

concat_pattern "?||?"

6、 我这样配置之后，无法启动windows下的openldap服务，但是能通过在命令行窗口输入命令："slapd –d 1"来启动服务。问题出在哪里还没搞清楚，暂时先通过命令行来启动服务吧。

7、 启动服务后，在命令行窗口输入以下命令，如果能看到测试数据的内容，则表示配置成功：

ldapsearch -LLL -s sub -b "dc=example,dc=com" "(objectClass=*)"

大功告成，说明OpenLDAP已经能够读取数据库里的测试数据。

理解一下数据库端的原理。

先将数据库中的测试数据清除掉：

1、删除原数据库中所有表格；

2、在下载的源码包中找到servers/slapd/back-sql/rdbms_depend/mysql目录，执行脚本backsql_create.sql 。

本文将通过一个例子讲解数据库结构。假设我们的LDAP服务端目录结构如下：

图一

首先给大家看一下，相应数据库结构：

图二

由图二看出，数据库中包括系统表格和自定义表格。系统表格是必须建立的表格，即backsql_create.sql脚本里的内容；自定义表格是根据实际的LDAP entry目录结构建立的相应的对象（Object)表，表格字段对应该对象的属性(Attribute)。

下面开始讲解怎样初始化数据库数据，使其能存储图一中的目录结构。

注：如果更改了系统表格中的数据，需要重启ldap服务才能生效。

1. 新增自定义表格：

自定义表格主要目的是为了存储同一类别的对象(object)数据，表格各个字段定义了对象类(objectClass)的属性。objectClass、object、attribute的概念都来自LDAP，下面都直接用英文表示，大家会比较清晰一些。

本例中，有如下objectClass：

DN

objectClass

dc=wfi,dc=wfiqa,dc=com

organization(组织)

ou=users

organizationalUnit(组织内单元，本例中只有users这一个单元)

uid=admin

uid=user1

inetOrgPerson(组织用户)

一般情况下，每一个objectClass，我们为其创建一个自定义表格，每个字段对应该对象类的一个属性。根据上表，我们新建了organization,org_unit,users三个表，具体表结构参见图一。

2 在系统表ldap_oc_mappings中加入objectClass信息：

此表格中主要存储objectClass和对应的自定义表格的对应关系。

以下是表格各字段的详细介绍：

Column

Desc.

id

objectClass的唯一标识

name

objectClass的名称

keytbl

对应的自定义表格名称

keycol

对应的自定义表格中关键字字段名称

create_proc

新增一个object时使用的SQL语句

delete_proc

删除一个object时使用的SQL语句

expect_return

执行新增或删除object的SQL语句，代表操作成果的SQL CODE值，通常是0。

下面是本例中，往本表添加的数据：

Column

Row1

Row2

Row3

id

1

2

3

Name

organization

organizationalUnit

inetOrgPerson

Keytbl

organization

org_unit

users

Keycol

id

id

id

create_proc

(稍后再讲)

  

delete_proc

(稍后再讲)

  

expect_return

3 在系统表ldap_attr_mappings中加入attribute信息：

此表格实际上就是建立LDAP中各attribute和数据库中objectClass的各个属性的关系。

此表格中sel_expr，from_tbls，join_where三个字段主要存储attribute如何通过SQL语句获取。

例如：获得某个attribute的SQL语句为：

SELECT CONCAT(a.column2,b.column2)

FROM a,b

WHERE a.column3=b.column1)

分别将SELECT,FROM,WHERE后面的语句存储到这三个字段里。

另外，param_order字段的含义目前还没搞清楚，官网给出的例子里，这个字段的值都是3，所以这里也都填3.

以下是表格各个字段的详细介绍：

Column

Desc.

id

attribute唯一标识

oc_map_id

所属objectClass的唯一标识

name

Attribute名称

sel_expr

SELECT后面的SQL语句

sel_expr_u

不清楚用途，本例中没有使用

from_tbls

FROM后面的SQL语句

join_where

WHERE后面的SQL语句

add_proc

修改一个attribute值时使用的SQL语句

delete_proc

删除一个attribute值时使用的SQL语句

param_order

不清楚含义，但官网给出的例子中，这个字段的值全是3，所以本例中也将值设为3。

expect_return

执行修改或删除attribute值的SQL语句，代表操作成果的SQL CODE值，通常是0。

以下是本例中，往本表添加的数据：

Column

Row1

Row2

Row3

Row4

Row5

Row6

Row7

id

1

2

3

4

5

6

7

oc_map_id

1

2

3

3

3

3

3

name

dc

ou

uid

sn

cn

userPassword

mail

sel_expr

name

name

code

name_en

name_cn

password

email

sel_expr_u

       

from_tbls

organization

org_unit

users

users

users

users

users

join_where

       

add_proc

(稍后再讲)

      

delete_proc

(稍后再讲)

      

param_order

3

3

3

3

3

3

3

expect_return

完成上面的操作后，目录结构的初始化工作完成。

目录结构为例：

图一

 

一、新加一个entry的处理

新加一个entry有两种处理方式，一种是直接操作数据库，一种是通过LDAP客户端是实现。

１.直接操作数据库的方法：

每新增一个entry，都应该在两个表格中添加数据：

1) 在相应自定义表格中增加一行，记录对象的各属性值。

2) 在ldap_entries中增加一行，记录entry的相关属性。

以图一所示的结构为例，增加以下entry:

1) dc=wfi,dc=wfiqa,dc=com

2) ou=users,dc=wfi,dc=wfiqa,dc=com

3) uid=admin,ou=users,dc=wfi,dc=wfiqa,dc=com

4) uid=user1,ou=users,dc=wfi,dc=wfiqa,dc=com

下面详细讲解如何进行操作：

1) entry“dc=wfi,dc=wfiqa,dc=com”是Organization类的对象，因此在organization表格中添加以下内容：

Column

Row1

id

1

name

wfi

2) entry“ou=users,dc=wfi,dc=wfiqa,dc=com”是Organization Unit类的对象，因此在org_unit表格中添加以下内容：

Column

Row1

id

1

name

users

3) entry“uid=admin,ou=users,dc=wfi,dc=wfiqa,dc=com”和“uid=user1,ou=users,dc=wfi,dc=wfiqa,dc=com”是User类的对象，因此在users表格中添加以下内容：

Column

Row1

Row2

id

1

2

name_en

admin

user1

name_cn

管理员

用户1

password

adminpwd

Pwd1

email

[e-mail]

[e-mail]

code

admincode

Code1

4) 在ldap_entries中加入entry信息：

本表是核心表格，存储所有entry的信息。每个entry都是一个对象。

以下是表格各个字段的详细介绍：

Column

Desc.

id

entry唯一标识

dn

entry的dn

oc_map_id

所属objectClass的唯一标识

parent

父节点entry的唯一标识

keyval

对应的自定义表格中，该对象的唯一标识。

把所有entry信息添加到表格中：

Column

id

dn

oc_map_id

parent

keyval

Row1

1

dc=wfi,dc=wfiqa,dc=com

3

1

Row2

2

ou=users,dc=wfi,dc=wfiqa,dc=com

1

1

1

Row3

3

uid=admin, ou=users, dc=wfi, dc=wfiqa

2

2

1

Row4

4

uid=user1, ou=users, dc=wfi, dc=wfiqa

2

2

2

２. 通过LDAP客户端实现增加entry：

使用LDAP客户端实现增加entry的原理是：

在数据库中存储在自定义表格中增加一个Object以及修改一个Attribute的SQL语句，当通过客户端增加entry时，LDAP会进行以下操作：

1） 根据该entry的objectClass属性确定其对象类；

2） 找到相应的新增Object的SQL语句来执行，在自定义表格中新增一行记录，并得到新增Object的ID；

3） 根据客户端输入的entry信息以及上个步骤得到的ID，在ldap_entries表中插入一行记录；

4） 执行修改Attribute的SQL语句，更新自定义表格中该Object的各个attribute。

２.１ 增加Object的SQL语句：

增加Object的SQL语句存储在ldap_oc_mappings表的add_proc字段中，该SQL语句应能够在对应的自定义表格中新增一行记录，并且返回新增记录的唯一标识（ID）。

可以先编写一个存储过程/函数，满足上述功能。然后通过SQL语句调用存储过程/函数。

本例中编写了一个新增用户的函数，内容如下：

DELIMITER $$

DROP FUNCTION IF EXISTS `ldap `.`create_user` $$

CREATE DEFINER=`root`@`%` FUNCTION `create_user`() RETURNS int(11)

BEGIN

//从用户表中获取当前ID值，+1作为新对象的ID值

SELECT MAX(id)+1 INTO @newId

FROM users;

//新增用户记录

INSERT INTO users

VALUES(@newId,null,null,null,null,null);

//返回用户ID

return @newId;

END $$

DELIMITER ;

在ldap_oc_mappings表中“inetOrgPerson”类的add_proc字段中，SQL语句内容如下：

SELECT create_user()

２.２. 修改attribute的SQL语句：

增加attribute的SQL语句存储在ldap_attr_mappings表的add_proc字段中，该SQL语句应能够在对应的自定义表格修改相应属性值。

可以先编写一个存储过程/函数，满足上述功能。然后通过SQL语句调用存储过程/函数。

例如，更新一个用户的英文名称，在ldap_attr_mappings表中sn属性的add_proc中存储以下SQL语句：

update users set name_cn=? where id=?

 

二、删除一个entry的处理

删除一个entry也有两种处理方式，一种是直接操作数据库，一种是通过LDAP客户端是实现。

１. 通过数据库删除entry：

先删除对应自定义表格中的对象记录，然后删除ldap_entries表中相应的entry记录。3.1已经详细描述了表结构，此处不再赘述。

注：如果要删除的entry下面还有子entry，注意要先删除下面的子entry。

２. 通过LDAP客户端删除entry：

使用LDAP客户端实现删除entry的原理是：

在数据库中存储在自定义表格中删除一个Object的SQL语句，当通过客户端删除entry时，LDAP会进行以下操作：

1） 根据该entry的dn，在ldap_entries表中找到其对象类(oc_map_id)，以及该对象的ID(keyval)；

2） 找到相应的删除Object的SQL语句来执行，在自定义表格中删除相应的对象记录；

3） 从ldap_entries表中删除相应的entry记录。

删除一个Object的SQL语句存储在ldap_oc_mappings表的delete_proc字段中。详细的内容可参考“2.通过LDAP客户端实现增加entry”。

 

三、修改或删除一个attribute的处理

其实删除attribute的操作只不过是将attribute的值清空（修改为空字符串），所以等同于修改attribute值。

1. 通过数据库操作来修改attribute:

直接在对应的自定义表格中修改字段值即可。

2. 通过LDAP客户端来修改：

原理不再赘述。

将修改属性值的SQL语句存储到ldap_attr_mappings表的add_proc字段中，将修改属性值为空字符串的SQL语句存储到ldap_attr_mappings表的delete_proc字段中。

可参考“2.2. 修改attribute的SQL语句”.。

四、本例中没有提到的几个系统表格：

在本次示例中，有几个系统表格没有使用到。

ldap_entry_objectclass

当一个entry对应多个object时，此表用来记录对应关系。曾看到一个资料说，如果此表内容为空，某处的操作会出错（具体是什么操作给忘记了），所以建议往这张表里插入至少一条记录，无论正确与否。

Column

Desc.

entry_id

ldap_entries表中对应entry的ID

oc_name

objectclass name

2 ldap_referrals

... something to do with referrals?