Spring Security 기반 인증/인가, JWT 발급/검증, 로그인 감사(audit), 계정 잠금, 비밀번호 재설정 토큰을 제공하는 모듈이다. JPA/JDBC 영속성 구현과 REST 컨트롤러를 포함하며, 스타터에서 자동 구성된다.

3.1 시작하기

3.1.1 의존성 추가

studio-platform-starter-security 를 의존성에 추가하면 쉽게 사용할 수 있다. JPA 을 사용하는 경우 의존성을 spring-boot-starter-data-jpa 로 변경한다. studio-platform-security 는 기본적으로 studio-platform-user 구현을 사용하여 spring-boot-starter-security 를 커스터마이징 하고 있다.

dependencies {
    implementation("studio.one.starter:studio-platform-starter")
    implementation("studio.one.starter:studio-platform-starter-user")
    **implementation("studio.one.starter:studio-platform-starter-security")**
    implementation("org.springframework.boot:spring-boot-starter-validation") 
    implementation("org.springframework.boot:spring-boot-starter-aop")
    implementation("org.springframework.boot:spring-boot-starter-web")  
    implementation("org.springframework.boot:spring-boot-starter-data-jdbc")  
    implementation("org.springframework.boot:spring-boot-starter-security")
}

3.1.2 활성화 하기

  studio:
	  security:
	    enabled: true

다음 모듈들이 자동 활성화 된다. (스프링 시큐리티 표준에 구현)

• PasswordEncoder : 비밀번호 저장/검증에 사용되며, 기본은 DelegatingPasswordEncoder(기본 bcrypt)를 사용한다. 필요 시 PBKDF2/scrypt/Argon2 등으로 변경 가능.
• CorsConfiguration :설정값에 따라 CorsConfigurationSource 빈을 자동 등록하고, SecurityFilterChain에서 CORS를 활성화하여 동일한 정책으로 처리.(SecurityFilterChain 는 구현이 필요)
• AuthenticationErrorHandler : 인증/인가 오류를 표준 JSON(Problem Details, RFC7807) 형태로 변환해 응답한다. (401은 AuthenticationEntryPoint, 403은 AccessDeniedHandler를 통해 처리)
• ApplicationUserDetailsService : User 도메인 모듈을 기반으로 UserDetailsService를 구현하여 사용자/권한 정보를 조회하고, 계정 상태 및 권한을 UserDetails로 제공.
• AuthenticationManager: AuthenticationManager는 등록된 AuthenticationProvider들을 통해 인증을 수행한다. 기본 Provider(DaoAuthenticationProvider)는 UserDetailsService와 PasswordEncoder를 사용해 사용자 조회 및 비밀번호 검증을 수행.
• SecurityExceptionHandler: 보안 관련 오류를 처리하는 공통 핸들러. studio-platform의 GlobalExceptionHandler 가 처리하지 못하는 보안 관련 오류를 처리한다.

3.2 Security 설정 가이드

Security 설정은 인증/인가 및 보안 정책(JWT, Form Login, Logout, CORS, PasswordEncoder, Permit)을 설정 기반으로 제어할 수 있게 한다. 환경(DEV/STG/PROD) 또는 고객사별로 인증 방식과 정책을 바꿔야 할 때코드 변경을 최소화하는 것이 목적이다. application.yml 에 저장된studio.security.* 설정은 SecurityProperties 로 바인딩된다.

3.2.1 PasswordEncoder 설정(password-encoder.*)

비밀번호 알고리즘 선택 및 알고리즘 별 파라미터를 제공한다. 기본 알고리즘은 BCRYPT이다. 이 설정을 통하여 사용자 도메인의 ApplicationUserService 는 비밀번호를 처리를 설정에 따라 자동 생성된 PasswrodEncoder 을 사용하여 처리하게 된다.

studio:
	security:
	  enabled: true 
		password-encoder:
			algorithm: BCRYPT
			bcrypt-strength: 10