配置目录

对于您配置的每个企业域，指定身份验证提供程序查询的目录以获取用户信息。 可以为域配置多个目录。

添加目录或自定义SPI

对于您配置的每个企业域，指定身份验证提供程序查询的目录以获取用户信息。 您可以向现有企业域或要添加的新企业域添加目录。 可以为域配置多个目录。 还可以配置域以使用自定义服务提供商接口(SPI)进行同步。

添加目录

1. 在管理控制台中，单击设置>用户管理>域管理。

2. 单击“新建企业域”或选择现有企业域。

3. 单击“添加目录”。

4. 在“用户档案名称”框中，键入名称以区分此目录，然后单击“下一步”。

5. 配置目录服务器设置。 （请参阅目录设置。）

6. 要验证是否可以连接到LDAP服务器，请单击“测试”。 如果测试失败，请查看应用程序服务器日志文件中的异常以确定失败的根本原因。 单击“关闭”，然后单击“下一步”。

7. 选择“用户设置”并根据需要配置设置。 （请参阅目录设置。）

8. 要验证基本DN和其他已配置属性是否收集了正确的用户批，请单击“测试”。 LDAP尝试使用提供的设置（如基本DN、搜索筛选器和所有属性）检索前200条记录。

   如果返回用户，结果将显示根据属性集分配给每个字段的值。 如果由于服务器名称不存在、授权信息不正确或属性不正确而测试失败，将显示以下错误消息："指定的搜索条件未返回任何结果"。 要确定故障的根本原因，请查看应用程序服务器日志文件中的异常。 单击“关闭”，然后单击“下一步”。

9. 选择“组设置”并根据需要配置设置。 （请参阅目录设置。）

10. 要验证基本DN和其他已配置属性是否收集了正确的组批，请单击“测试”。 如果返回组，结果将显示根据属性集分配给每个字段的值。 单击关闭。

添加自定义SPI

有关创建自定义SPI的信息，请参见《使用AEM表单进行编程》的中的“为AEM表单开发SPI”。 要使新部署的自定义SPI可与域关联，请重新启动服务器。

1. 在管理控制台中，单击设置>用户管理>域管理。
2. 单击“新建企业域”或选择现有企业域。
3. 单击“添加目录”。
4. 在“用户档案名称”框中键入名称，选择“自定义SPI提供程序”，然后单击“下一步”。
5. 从列表中选择自定义用户提供者，然后单击“下一步”。
6. 从列表中选择自定义组提供程序，然后单击“完成”。

编辑目录

您可以编辑之前配置的目录的详细信息。

1. 在管理控制台中，单击设置>用户管理>域管理。
2. 在列表中单击相应的域，然后在显示的页面上，从列表中选择相应的目录。
3. 根据需要配置目录、用户和组设置。 （请参阅目录设置。）
4. 单击确定。

删除目录

在删除目录后同步域时，该目录中的所有用户和组在数据库中被标记为过时。 不会在从管理控制台进行的任何搜索中返回它们。

1. 在管理控制台中，单击设置>用户管理>域管理。
2. 在列表中单击相应的域。
3. 选中相应目录的复选框，然后单击“删除”。
4. 在显示的确认页面上单击“确定”，然后再次单击“确定”。

目录设置

向域添加目录时，请指定以下目录设置。

服务器 :（必填）目录服务器的完全限定域名(FQDN)。例如，对于corp.adobe.com网络上名为x的计算机，FQDN为x.corp.adobe.com。 可以使用IP地址代替FQDN服务器名称。

端口： （必需）目录服务器使用的端口。如果使用安全套接字层(SSL)协议通过网络发送身份验证信息，则通常为389或636。

SSL: （必需）指定在通过网络发送数据时目录服务器是否使用SSL。默认值为“否”。 如果设置为“是”，则相应的LDAP服务器证书必须由应用程序服务器的Java™运行时环境(JRE)信任。

绑定 （强制）指定如何访问目录。

匿名： 无需用户名或密码。匿名用户只能获取有限数量的数据。 此选项可能对初始测试有用。

用户：需 要身份验证。在“名称”框中，指定可访问目录的用户记录的名称。 最好输入用户帐户的完整辨别名(DN)，如cn=Jane Doe、ou=user、dc=can、dc=com。 在“口令”框中，指定关联的口令。 当您选择“用户”作为“绑定”选项时，需要这些设置。

名称： 未启用匿名访问时可用于连接到LDAP数据库的名称。对于Active Directory 2003，请指定[domain name]\[userid]。 对于Sun™ One、eDirectory或IBM Tivoli Directory Server，请指定用户的完全限定名称，如uid=lcuser、ou=it、o=公司.com。

口令： 与您在未启用匿名访问时连接到LDAP数据库的指定名称对应的口令。

填充页面：选 择该选项后，使用相应的默认LDAP值填充“用户”和“用户组”设置页面的属性。

检索基本DN: 检索基本DN并在下拉列表中显示它们。当您有多个基本DN并且需要选择值时，此设置很有用。

启用引用： 当您的组织使用以分层结构组织的多个Active Directory域并且您仅为父域指定了目录设置时，此设置适用。在这种情况下，当您选择此选项时，用户管理可以从子域访问用户和组详细信息。

用户设置

唯一标识符 :（必需）用于标识用户的唯一常量属性。使用非DN属性作为唯一标识符，因为如果用户的DN移动到组织的其他部分，则其DN可能会更改。 此设置取决于目录服务器。 该值为Active Directory 2003的objectGUID、Sun™ One的nsuniqueID和eDirectory的guid。

基本DN: 设置为从LDAP层次结构同步用户和用户组的起点。最好在层次结构的最低级别指定基本DN，该DN包含需要同步服务的所有用户和组。

如果在“目录”设置中选择了“启用”引用选项，则将“基本DN”选项设置为DN的​dc​部分。 要使引用正常工作，搜索范围必须同时包括父域和子域。

尽管基本DN是管理控制台中的必需设置，但某些目录服务器（如IBM Domino Enterprise Server）可能需要空的BaseDN。 要指定空的基本DN，请导出config.xml文件，在config.xml文件中编辑设置，然后重新导入它。 （请参阅导入和导出配置文件。）

搜索筛选 器：（必填）用于查找与用户关联的记录的搜索筛选器。您可以执行一级搜索或子级搜索。 （请参阅搜索筛选器语法或RFC 2254。） 有关Microsoft AD模式的其他信息，请参阅Active Directory模式。

描述： 用户描述的模式属性

全名： （必填）用户全名的模式属性

登录ID ：用户登录ID的模式属性（必填）

姓氏： （必填）用户姓氏的模式属性

给定名称 :（必填）用户名的模式属性

姓名首 字母：用户姓名首字母的模式属性

业务日历： 允许您根据此设置（业务日历密钥）的值，将业务日历映射到用户。业务日历定义业务日和非业务日。 AEM表单在计算提醒、截止日期和升级等事件的未来日期和时间时可以使用业务日历。 您为用户分配业务日历密钥的方式取决于您使用的是企业域、本地域还是混合域。 （请参阅配置业务日历。）

如果您使用的是企业域，则可以将“业务日历”设置映射到LDAP目录中的字段。 例如，如果目录中的每个用户记录都包含​国家／地区​字段，并且要根据用户所在的国家／地区分配业务日历，请指定​国家／地区​字段名称作为“业务日历”设置的值。 然后，您可以将业务日历键（为LDAP目录中的​国家／地区​字段定义的值）映射到表单工作流中的业务日历。

用于在表单工作流页面中显示业务日历键名称的空间量受到限制。 将业务日历键的名称限制为不超过53个字符，以避免在这些页面上截断该键。

修改时间戳： 要启用增量目录同步，请将此值设置为修改TimeStamp。（请参阅启用增量目录同步。）

组织： 用户所属组织名称的模式属性。

主电子邮件： 用户主电子邮件地址的模式属性。

辅助电子邮件： 用户辅助电子邮件地址的模式属性。

电话： 用户电话号码的模式属性。

邮政地址： 用户邮寄地址的模式属性。

区域设置： 包含ISO区域设置信息的模式属性。该值是双字母语言代码或语言和国家／地区代码。

时区： 模式属性，包含用户所在的时区。该值是一个字符串，如“城市／国家”。

启用虚拟列表视图(VLV)控件：一 个LDAP控件，它使AEM表单能够从目录服务器批量检索数据。如果您使用Sun One作为LDAP目录，并且该目录包含许多用户，则启用VLV将创建用户管理在搜索用户时可以使用的索引。 当使用只能同步有限数量数据的普通用户帐户时，此功能很有用。 您还可以为组启用VLV。 如果选择“启用虚拟列表视图(VLV)控件”，请在“排序字段”框中指定名称。

排序字段： 如果选择了“启用虚拟列表视图(VLV)控件”，请指定用于对索引排序的属性名称。此属性名称（如uid）是您在目录服务器上为VLV创建索引时指定的名称。

组设置

唯一标识符 :（必需）用于标识组的唯一和常量属性。使用非DN属性作为唯一标识符。 此设置取决于目录服务器。 该值为Active Directory 2003的objectGUID、Sun One的nsuniqueID和eDirectory的guid。

基本DN: （必需）目录的基本可分辨名称。

尽管基本DN是管理控制台中的必需设置，但某些目录服务器（如IBM Domino Enterprise Server）需要空的BaseDN。 要指定空的基本DN，请导出config.xml文件，在config.xml文件中编辑设置，然后重新导入它。 （请参阅导入和导出配置文件。）

搜索筛选 器：（必填）用于查找与组关联的记录的搜索筛选器。您可以执行一级搜索或子级搜索。

说明： 组说明的模式属性

全名： （必填）组全名的模式属性

成员DN: （必选）模式属性，用于组内成员的可分辨名称

成员唯一标 识符：作为所选组成员的用户或组的唯一标识符。此值取决于目录服务器。 该值为AD2003的objectSID、Sun One的nsuniqueID和eDirectory的guid。

如果使用非DN属性指定成员DN，则用户管理会使用成员唯一标识符来查询LDAP以收集用户的DN，因为它对应于唯一标识符值。

如果将DN指定为唯一标识符，则无需配置成员唯一标识符。

组织： 组所属组织名称的模式属性

主电子邮件： 组主电子邮件地址的模式属性

辅助电子邮件： 组的辅助电子邮件地址的模式属性

修改时间戳： 要启用增量目录同步，请将此值设置为修改TimeStamp。（请参阅启用增量目录同步。）

启用虚拟列表视图(VLV)控件：一 个LDAP控件，它使AEM表单能够从目录服务器批量检索数据。如果您使用Sun One作为LDAP目录，并且该目录包含许多组，则启用VLV将创建一个用户管理在搜索组时可以使用的索引。 当使用只能同步有限数量数据的普通用户帐户时，此功能很有用。 您还可以为用户启用VLV。 如果选择“启用虚拟列表视图(VLV)控件”，请指定“排序字段名称”。

排序字段名 称：如果选择了“启用虚拟列表视图(VLV)控件”，请指定用于对索引排序的属性名称。此属性名称是您在目录服务器上为VLV创建索引时指定的名称。

将用户管理配置为使用虚拟列表视图(VLV)

目录同步是用户管理的重要要求。 用户和用户组从企业目录同步到AEM表单数据库以分配角色和权限。 用户数量根据要求在100到100000个之间不同，因此，如何有效地同步数据将成为一项工程难题。

LDAP协议提供了一种机制，可通过使用请求控件以分页方式查询大数据集。 使用Microsoft Active Directory时，LDAP到AEM表单数据库同步使用PagedResultsControl以批量检索特定大小的数据。 Sun ONE目录服务器不支持此控件。 要针对Sun ONE目录服务器完成分页查询，请使用虚拟列表视图(VLV)控件。 此控件涉及目录服务器端配置和客户端实现。

1. 配置目录时，在“用户设置”页和“组设置”页上选择“启用虚拟列表视图(VLV)控制”。 选中该复选框时，还必须在“排序字段”框中指定一个排序名称。 默认值为uid。 （请参阅添加目录或自定义SPI或编辑目录。）
2. 使用Sun ONE管理控制台或命令行脚本为用户和用户组创建LDAP VLV条目。 如果使用命令行脚本，则可以使用示例用户和组LDIF文件。 （请参阅为VLV配置Sun ONE目录服务器。）
3. 停止服务器并创建所需的索引。 （请参阅为VLV创建目录服务器索引。）

为VLV配置Sun ONE目录服务器

创建VLV需要包含vlvSearch和vlvIndex对象类的一对条目。 vlvSearch条目包括一个搜索基础和vlvFilter属性，它指定包含要排序的属性的对象类。 vlvIndex对象类包括vlvSort属性，该属性指定一个或多个要排序的属性以及排序顺序。 (减号(-)表示反向字母顺序)。 将VLV与AEM表单结合使用需要为用户和用户组单独输入条目。

以下是用户VLV条目的示例脚本LDIF:

 dn: cn=lcuser,cn=userRoot,cn=ldbm database,cn=plugins,cn=config 
 objectclass: top 
 objectclass: vlvSearch 
 cn: lcuser 
 vlvBase: dc=corp,dc=adobe,dc=com 
 vlvScope: 2 
 vlvFilter: (&(objectclass=inetOrgPerson)) 
 aci: (target="ldap:///cn=lcuser,cn=userRoot,cn=ldbm database,cn=plugins,cn=config")(targetattr="*")(version 3.0; acl "Config" 
 ;allow(read,search,compare) userdn="ldap:///all"; ) 
 dn: cn=lcuser,cn=lcuser,cn=userRoot,cn=ldbm database,cn=plugins,cn=config 
 cn: lcuser 
 vlvSort: cn 
 objectclass: top 
 objectclass: vlvIndex

使用脚本创建对象条目

1. 示例脚本有一个名为lcuser的LDAP条目。 此条目用于AEM表单中与VLV相关的用户同步配置。 相应地修改以下属性：

   条目名称： 此示例中的条目名称为 lcuser。如果lcuser发生更改，则必须在示例脚本的所有区域中更改它。

   vlvBase：在 “用户设置”页上指定的基本DN。

   vlvFilter：在“ 用户设置”页面上指定的搜索筛选器。

   vlvSort：在 “用户设置”页的“VLV设置”部分中指定的“排序”字段。VLV控件要求您指定排序控件。 此字段用作创建的vlv索引的排序参数。

   aci: 示例脚本中指定的访问控制授予任何已验证的用户访问VLV索引以执行读取、搜索和比较操作的权利。管理员可以限制对绑定用户的访问，该用户在用户管理用户界面中指定的“目录服务器设置”页中进行了配置。 如果未授予权限，则用户搜索无法使用VLV,LDAP服务器将引发权限异常。

   注意

   作为惯例，vlvIndex条目名称也设置为lcuser，但您可以为它指定其他名称。 在vlvindex工具中使用相同的名称。 （请参阅为VLV ​创建目录服务器索引。）

2. 使用随Sun ONE Server提供的ldapmodify工具，分别使用组的基本DN、搜索筛选器和排序字段为组创建类似条目：

   server directory\shared\bin>ldapmodify -v -a -h host -p port -D "admin user" -w "password" -f "LDIF file location"

   例如，键入以下文本：

   D:\tools\ldap\sun\shared\bin> -v -a -h localhost -p 55850 -D "uid=admin,ou=administrators,ou=topologymanagement,o=netscaperoot" -w "admin" -f "D:\tools\ldap\data\vlv feature\users.ldif"

为VLV创建目录服务器索引

配置目录设置并为用户和用户组创建LDAP VLV条目后，请停止服务器并创建所需的索引。

1. 创建对象条目后，停止Sun ONE Server。

2. 使用vlvindex工具，通过键入以下文本生成索引：

   目录服务器实例 \vlvindex.bat -n userRoot -T lcuser

   将生成以下输出：

    D:\tools\ldap\sun\shared\bin>..\..\slapd-chetanmeh-xp3\vlvindex.bat -n userRoot -T livecycle 
    [21/Nov/2007:16:47:26 +051800] - userRoot: Indexing VLV: livecycle 
    [21/Nov/2007:16:47:27 +051800] - userRoot: Indexed 1000 entries (5%). 
    [21/Nov/2007:16:47:27 +051800] - userRoot: Indexed 2000 entries (9%). 
    ... 
    [21/Nov/2007:16:47:29 +051800] - userRoot: Indexed 20000 entries (94%). 
    [21/Nov/2007:16:47:29 +051800] - userRoot: Indexed 21000 entries (99%). 
    [21/Nov/2007:16:47:29 +051800] - userRoot: Finished indexing.
   

   vlvindex工具位于目录服务器实例目录中。 如果Sun ONE Server有两个运行server1和server2的实例，则vlvindex工具位于​Sun ONE服务器目录\server1目录中。 参数-T的值是先前在示例LDIF中创建的vlvindex项的cn属性的值。 在这种情况下，它为lcuser。

3. 如果还为组启用了VLV，则为组创建相应的索引。 通过运行以下命令验证是否创建了索引：

   sun one server directoryhostname \shared\bin>ldapsearch -h** -p端口号no -s base -b "" objectclass=*

   将生成以下示例数据等输出：

    D:\tools\ldap\sun\shared\bin>ldapsearch.exe -h localhost -p 55850 -s base -b "" objectclass=* 
    ldapsearch.exe: started Tue Nov 27 16:34:20 2007 
    version: 1 
    dn: 
    objectClass: top 
    namingContexts: dc=corp,dc=adobe,dc=com 
    supportedExtension: 2.16.840.1.113730.3.5.7 
    ... 
    vlvsearch: cn=MCC ou=testdata dc=corp dc=adobe dc=com, cn=userRoot,cn=ldbm dat 
        abase,cn=plugins,cn=config 
    vlvsearch: cn=lcuser,cn=userRoot,cn=ldbm database,cn=plugins,cn=config 
    vlvsearch: cn=Browsing ou=testdata,cn=userRoot,cn=ldbm database,cn=plugins,cn= 
        config 
    1 matches