Spring Security LDAP用户名预处理：实现多格式登录需求

当然可以！完全不用放弃ldapAuthentication()的配置，通过预处理用户输入的用户名就能轻松实现这四种格式的登录支持。我给你拆解下具体的实现思路和代码示例：

核心思路 #

不管用户输入的是xxID/ID/xxID@organization.com/ID@organization.com中的哪一种，我们都先把它转换成LDAP中存储的真实uid（也就是xxID），再交给原有LDAP认证逻辑处理。这样既保留了你原有的ldapAuthentication()配置，又满足了多格式登录的需求。

步骤1：编写用户名转换逻辑 #

先写一个工具方法，把各种输入格式转换成标准的xxID：

private String processUsername(String rawUsername) {
    // 1. 移除域名后缀（忽略大小写匹配）
    String strippedUsername = rawUsername.replaceAll("@organization\\.com$", "").toLowerCase();
    
    // 2. 如果没有xx前缀，自动补上
    if (!strippedUsername.startsWith("xx")) {
        strippedUsername = "xx" + strippedUsername;
    }
    
    return strippedUsername;
}

注意：如果你的LDAPuid是大小写敏感的，记得去掉toLowerCase()，保持和LDAP存储一致的格式。

步骤2：自定义AuthenticationProvider包装LDAP认证 #

我们创建一个自定义的AuthenticationProvider，先处理用户名，再调用原有的LDAP认证逻辑：

@Component
public class PreprocessingLdapAuthProvider implements AuthenticationProvider {

    private final AuthenticationProvider delegateLdapProvider;

    // 注入原始的LDAP认证Provider
    public PreprocessingLdapAuthProvider(AuthenticationProvider delegateLdapProvider) {
        this.delegateLdapProvider = delegateLdapProvider;
    }

    @Override
    public Authentication authenticate(Authentication auth) throws AuthenticationException {
        // 获取用户输入的原始用户名
        String rawUsername = auth.getName();
        // 转换成标准uid格式
        String processedUsername = processUsername(rawUsername);
        
        // 用处理后的用户名创建新的认证Token
        UsernamePasswordAuthenticationToken processedAuthToken =
                new UsernamePasswordAuthenticationToken(processedUsername, auth.getCredentials());
        
        // 交给原始LDAP认证逻辑处理
        return delegateLdapProvider.authenticate(processedAuthToken);
    }

    @Override
    public boolean supports(Class<?> authType) {
        // 只处理用户名密码类型的认证
        return UsernamePasswordAuthenticationToken.class.isAssignableFrom(authType);
    }

    // 上面的用户名转换方法
    private String processUsername(String rawUsername) {
        String strippedUsername = rawUsername.replaceAll("@organization\\.com$", "").toLowerCase();
        if (!strippedUsername.startsWith("xx")) {
            strippedUsername = "xx" + strippedUsername;
        }
        return strippedUsername;
    }
}

步骤3：配置Spring Security #

在你的Security配置类中，注册原始的LDAP认证Provider，再把自定义的Provider加入认证链：

@Configuration
@EnableWebSecurity
public class SecurityConfig {

    @Autowired
    private PreprocessingLdapAuthProvider preprocessingLdapAuthProvider;

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(auth -> auth.anyRequest().authenticated())
            .formLogin(form -> form.permitAll()); // 根据你的登录页面配置调整
        return http.build();
    }

    // 配置原始的LDAP认证Provider
    @Bean
    public AuthenticationProvider ldapAuthenticationProvider(ContextSource contextSource) {
        return new LdapAuthenticationProviderConfigurer<AuthenticationManagerBuilder>()
                .userSearchFilter("(&(objectClass=person)(uid={0}))") // 你的原有搜索过滤器
                .contextSource(contextSource)
                .build();
    }

    // 配置LDAP上下文源（你的原有配置）
    @Bean
    public ContextSource contextSource() {
        DefaultSpringSecurityContextSource contextSource =
                new DefaultSpringSecurityContextSource("ldap://your-ldap-server:389/dc=organization,dc=com");
        contextSource.setUserDn("cn=admin,dc=organization,dc=com"); // LDAP管理员账号
        contextSource.setPassword("your-admin-password"); // 管理员密码
        return contextSource;
    }

    // 把自定义Provider加入认证管理器
    @Autowired
    public void configureAuthManager(AuthenticationManagerBuilder auth) throws Exception {
        auth.authenticationProvider(preprocessingLdapAuthProvider);
    }
}

测试验证 #

现在四种登录格式都能正常认证了：

• 输入xxID → 直接匹配LDAP的uid=xxID
• 输入ID → 转换为xxID后匹配
• 输入xxID@organization.com → 移除域名后匹配xxID
• 输入ID@organization.com → 移除域名+补前缀后匹配xxID

内容的提问来源于stack exchange，提问作者Anders