Spring Security와 LDAP를 통한 엔터프라이즈 인증 구현 가이드

경량 디렉토리 접근 프로토콜(Lightweight Directory Access Protocol, LDAP)은 디렉토리 서비스 정보와 같은 네트워크 상의 리소스에 대한 접근을 관리하는 애플리케이션 프로토콜입니다. 기업 환경에서는 주로 사용자 인증 및 권한 부여 정보를 저장하는 데 LDAP 서버를 사용합니다. Spring Security는 LDAP와의 통합을 위한 포괄적인 지원을 제공하며, 이를 통해 Spring 기반 애플리케이션에서 손쉽게 LDAP 인증을 구현할 수 있습니다. 본 가이드에서는 Spring Security와 LDAP 서버의 연동 방법을 소개합니다.

LDAP 서버 설정

LDAP 서버 설정은 연동을 위한 기반이며, Active Directory나 OpenLDAP과 같은 LDAP 서버를 사용할 수 있습니다. 테스트 목적으로는 Apache Directory Studio를 사용하여 로컬 LDAP 서버를 구축하고 구성하는 것이 좋습니다.

의존성 추가

Spring Boot 프로젝트에 LDAP 인증을 구현하기 위해, spring-boot-starter-data-ldap과 spring-boot-starter-security 의존성을 pom.xml 또는 build.gradle에 추가합니다.

Maven pom.xml:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-ldap</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-security</artifactId>
    </dependency>
</dependencies>

 

Gradle build.gradle:

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-data-ldap'
    implementation 'org.springframework.boot:spring-boot-starter-security'
}

 

반응형

 

Spring Security LDAP 인증 구성

WebSecurityConfigurerAdapter를 상속받는 클래스를 사용하여 Spring Security의 LDAP 인증을 구성합니다. 아래의 예제는 기본적인 LDAP 인증을 구성하는 방법을 보여줍니다.
 

@EnableWebSecurity
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth
            .ldapAuthentication()
            .userDnPatterns("uid={0},ou=people") // 사용자 DN 패턴
            .groupSearchBase("ou=groups") // 그룹 검색 베이스
            .contextSource()
                .url("ldap://localhost:8389/dc=springframework,dc=org") // LDAP 서버 URL 및 베이스 DN
                .and()
            .passwordCompare()
                .passwordEncoder(new BCryptPasswordEncoder()) // 비밀번호 인코더
                .passwordAttribute("userPassword"); // 비밀번호 속성
    }

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .anyRequest().authenticated()
                .and()
            .formLogin();
    }
}

 
이 설정에서 userDnPatterns는 사용자를 찾기 위한 패턴을 지정하고, groupSearchBase는 권한 부여를 위한 그룹 검색의 기준점을 설정합니다. contextSource() 메서드는 LDAP 서버의 위치와 베이스 DN을 구성합니다.

LDAP 인증 테스트

LDAP 서버와의 연동 및 인증 구성이 완료되면, 애플리케이션을 실행하여 설정을 테스트할 수 있습니다. 로그인 폼을 통해 LDAP 서버에 등록된 사용자로 로그인을 시도하고, 성공적으로 인증이 이루어지는지 확인합니다.

결론

Spring Security와 LDAP을 연동함으로써, 기업 환경에서 널리 사용되는 디렉토리 서비스를 이용한 인증 및 권한 부여 메커니즘을 손쉽게 구현할 수 있습니다. 이를 통해 개발자는 보안성 높은 애플리케이션을 효율적으로 개발할 수 있으며, 기업은 기존의 인프라를 최대한 활용할 수 있습니다. Spring Security의 유연성과 LDAP의 강력한 디렉토리 관리 기능을 결합하여, 안전하고 관리가 용이한 애플리케이션 인증 시스템을 구축할 수 있습니다.