Java 连接AD域

Active Directory（AD）是由微软开发的一种目录服务，用于管理网络中的用户、计算机和其他网络资源。在 Java 开发中，我们经常需要连接和操作 AD 域来实现用户认证、权限控制等功能。本文将介绍如何使用 Java 连接 AD 域，并提供相关代码示例。

连接 AD 域

要连接 AD 域，我们需要使用 Java 提供的 LDAP（Lightweight Directory Access Protocol）协议。LDAP 是一种用于访问和维护分布式目录信息服务的协议，而 AD 域正是基于 LDAP。

首先，我们需要添加相关的依赖。在 Maven 项目中，可以在 pom.xml 文件中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>com.unboundid</groupId>
        <artifactId>unboundid-ldapsdk</artifactId>
        <version>4.0.13</version>
    </dependency>
</dependencies>

接下来，我们可以编写代码来连接 AD 域。以下是一个简单的示例：

import com.unboundid.ldap.sdk.*;

public class ADConnectionExample {

    private static final String LDAP_URL = "ldap://ad.example.com:389";
    private static final String BIND_DN = "cn=admin,dc=example,dc=com";
    private static final String BIND_PASSWORD = "password";

    public static void main(String[] args) throws LDAPException {
        LDAPConnection connection = new LDAPConnection(LDAP_URL);
        connection.bind(BIND_DN, BIND_PASSWORD);

        // 连接成功，执行相应操作
        // ...

        connection.close();
    }
}

上述代码中，我们通过 LDAPConnection 类来进行连接，并通过 bind 方法传入管理员的用户名和密码进行认证。

执行操作

连接成功后，我们可以执行各种操作，如搜索用户、创建用户、修改用户属性等。以下是一个搜索用户的示例：

import com.unboundid.ldap.sdk.*;

public class ADSearchExample {

    private static final String LDAP_URL = "ldap://ad.example.com:389";
    private static final String BIND_DN = "cn=admin,dc=example,dc=com";
    private static final String BIND_PASSWORD = "password";

    public static void main(String[] args) throws LDAPException {
        LDAPConnection connection = new LDAPConnection(LDAP_URL);
        connection.bind(BIND_DN, BIND_PASSWORD);

        SearchRequest searchRequest = new SearchRequest(
            "dc=example,dc=com",
            SearchScope.SUB,
            Filter.createEqualityFilter("cn", "John Doe")
        );

        SearchResult searchResult = connection.search(searchRequest);
        SearchResultEntry entry = searchResult.getSearchEntries().get(0);

        // 获取用户属性
        String username = entry.getAttributeValue("sAMAccountName");
        String email = entry.getAttributeValue("mail");

        System.out.println("Username: " + username);
        System.out.println("Email: " + email);

        connection.close();
    }
}

上述代码中，我们使用 SearchRequest 类来构建一个搜索请求，并指定搜索的范围和过滤条件。然后，通过 connection.search 方法执行搜索，并获取第一个搜索结果的属性。

总结

本文介绍了如何使用 Java 连接 AD 域，并提供了相关的代码示例。通过这些示例，我们可以连接 AD 域、执行各种操作，并获取用户的属性。在实际开发中，可以根据具体需求进行进一步的扩展和优化。

综上所述，通过使用 Java 连接 AD 域，我们可以实现与 AD 域的集成，实现用户认证、权限控制等功能，为企业应用开发提供了更多的可能性。

journey
    title Java 连接 AD 域
    section 连接 AD 域
    Java项目中添加LDAP依赖
    编写代码连接AD域
    进行认证
    section 执行操作
    执行各种操作，如搜索用户、创建用户、修改用户属性等
    获取用户属性
    section 总结
    介绍了如何使用Java连接AD域
    提供相关的代码示例
    Java连接AD域的应用场景