[Spring Security] 3. 로그인 성공·실패 핸들러

1. 핸들러가 왜 필요한가?

Spring Security의 기본 로그인 동작:

• 성공 → 특정 URL로 리다이렉트
• 실패 → 로그인 페이지로 리다이렉트

하지만 REST API에서는 리다이렉트가 아니라 JSON 응답을 내려줘야 합니다. 핸들러를 직접 구현하면 로그인 결과에 따라 원하는 응답을 자유롭게 만들 수 있습니다.

2. 성공 핸들러 (AuthenticationSuccessHandler)

로그인이 성공했을 때 실행됩니다.

@Component
public class LoginSuccessHandler implements AuthenticationSuccessHandler {

    @Override
    public void onAuthenticationSuccess(
            HttpServletRequest request,
            HttpServletResponse response,
            Authentication authentication) throws IOException, ServletException {

        // authentication: 인증된 사용자 정보
        String username = authentication.getName();

        response.setStatus(HttpStatus.OK.value());
        response.setContentType("application/json");
        response.setCharacterEncoding("UTF-8");
        response.getWriter().write("{\"username\":\"" + username + "\"}");
    }
}

• Authentication authentication : 인증 성공한 사용자 정보가 담겨 있습니다
• authentication.getName() : username 반환
• authentication.getAuthorities() : 권한 목록 반환
• 응답은 response 객체에 직접 씁니다

3. 실패 핸들러 (AuthenticationFailureHandler)

로그인이 실패했을 때 실행됩니다. 비밀번호 틀림, 존재하지 않는 계정 등이 해당됩니다.

@Component
public class LoginFailureHandler implements AuthenticationFailureHandler {

    @Override
    public void onAuthenticationFailure(
            HttpServletRequest request,
            HttpServletResponse response,
            AuthenticationException exception) throws IOException, ServletException {

        response.setStatus(HttpStatus.UNAUTHORIZED.value());
        response.setContentType("application/json");
        response.setCharacterEncoding("UTF-8");
        response.getWriter().write("{\"message\":\"" + exception.getMessage() + "\"}");
    }
}

• AuthenticationException exception : 실패 원인이 담긴 예외 객체
• exception.getMessage() : 실패 사유 문자열 반환
• 보통 401 Unauthorized를 응답 코드로 사용합니다

4. 성공·실패 핸들러 비교

5. SecurityConfig에 등록

http
    .formLogin(form -> form
        .successHandler(loginSuccessHandler)
        .failureHandler(loginFailureHandler)
    );

• 두 핸들러 모두 @Component로 등록 후 주입받아 사용합니다

6. 전체 흐름