[Java] 自动获取 LDAP 基准 DN 列表

作者 huhamhire,暂无评论,2014年4月27日 12:18 程序实践

问题描述

在使用 LDAP 协议从 Active Directory 等目录管理服务获取组织结构数据时,一般总是需要对目录的检索路径进行配置。但是由于实际使用中的目录组织结构通常会比较复杂,往往会出现有多个树(或者 AD 中的网域)的情况。如果配置人员对所需访问路径不熟悉,或者目录组织结构特别庞大的情况下,直接人工设置容易出现配置错误或是检索效率低下的问题。所以在设计相关的配置功能时,如果能够自动获取各目录树的根路径列表,可为配置 LDAP 连接带来较大的便利。

现有案例

在此方面,常见的 LDAP 管理工具 LDAP Administrator 就提供了一个很好的方案。在设置服务器信息时,提供了一个 Fetch Base DNs 的按钮(参见下图),以帮助用户从服务器获取基准 DN 信息,作为设置检索 RootDSE,也就是目录信息树的根。

Base-DN

实现原理

要获取目录树的基准 DN 其实并不复杂,首先注意到 RFC 2252 文档第 13 页中针对 LDAP 的 namingContexts 属性给出了如下说明:

5.2.1. namingContexts

The values of this attribute correspond to naming contexts which this server masters or shadows. If the server does not master any information (e.g. it is an LDAP gateway to a public X.500 directory) this attribute will be absent. If the server believes it contains the entire directory, the attribute will have a single value, and that value will be the empty string (indicating the null DN of the root). This attribute will allow a client to choose suitable base objects for searching when it has contacted a server.

RFC 2252, LDAPv3: Attribute Syntax Definitions, Page 13

这段内容的最后一句就直接指出,该属性能够允许客户端在与服务器联系时选择用于检索信息的基准对象。基于文档中的表述,实际操作中,仅需要从服务器上通过查询对象的方式获得 namingContexts 属性值,即可整理出基准 DN 列表。

除此以外,通常在获取服务器 Base DN 的过程中,并不需要用户提供连接服务器的用户登录信息,一般都可以直接获取。在 LDAP Administrator 中也仅需提供服务器的访问地址、端口以及加密选项,便可直接抓取。

代码实现

获取 LDAP 基准 DN 列表的具体实现可参考下面的 Java 代码:


 1     Hashtable<String,String> env = new Hashtable<String,String>();
 2     env.put(Context.INITIAL_CONTEXT_FACTORY, "com.sun.jndi.ldap.LdapCtxFactory");
 3     env.put(Context.PROVIDER_URL, "ldap://" + ldapServer + ":" + ldapPort);
 4     env.put(Context.REFERRAL, "follow");
 5 
 6     // 初始化 LDAP 上下文
 7     LdapContext context = new InitialLdapContext(env, null);
 8     String base = "";
 9     String filter = "(objectclass=*)";
10     SearchControls controls = new SearchControls();
11     controls.setSearchScope(SearchControls.OBJECT_SCOPE);
12 
13     // 通过获取 namingContexts 属性值得到基准 DN
14     NamingEnumeration<SearchResult> results = context.search(base, filter, controls);
15     List<String> namingContextsList = new ArrayList<String>();
16 
17     // 处理结果
18     if(results.hasMore()) {
19         Attributes attrs = results.next().getAttributes();
20         if (attrs != null) {
21             Attribute namingContexts = attrs.get("namingContexts");
22             NamingEnumeration enumeration = namingContexts.getAll();
23             while(enumeration.hasMore()) {
24                 namingContextsList.add((String) enumeration.next());
25             }
26         }
27     }
28     context.close();
29     System.out.println(namingContextsList);
关键词:Java , LDAP
登录后进行评论