스프링 MVC 인터셉터를 통한 인증되지 않은 요청 차단 전략

인터셉터 기반 필터링 메커니즘

스프링 프레임워크에서 HandlerInterceptor 는 웹 애플리케이션의 요청 흐름을 가로채어 특정 로직을 삽입할 수 있도록 설계되었습니다. 이 객체는 컨트롤러 메서드가 진입하기 전과 후, 그리고 전체 처리가 완료되는 시점에서 다양한 역할을 수행합니다.

핵심 콜백 메서드详解

1. preHandle()
이 메서드는 실제 비즈니스 로직이 실행되기 전에 호출됩니다. 여러 개의 인터셉터가 연쇄적으로 등록되어 있는 경우, 선언된 순서대로 하나씩 실행됩니다. 중요한 점은 여기에서 false를 리턴하면 그 이후의 모든 인터셉터와 컨트롤러 메서드가 호출되지 않으며, afterCompletion 메서드 또한 실행되지 않는다는 사실입니다.

2. postHandle()
컨트롤러가 요청을 처리하고 뷰를 렌더링하기 직전에 실행됩니다. 주로 ModelAndView 객체를 조작하여 공통 데이터를 추가하거나 수정할 때 활용하며, 컨트롤러 호출이 성공했을 때만 수행됩니다. 실행 순서는 등록된 순서의 역순으로 진행됩니다. HTTP 메서드 (GET, POST 등) 에 관계없이 작동하므로 URL 경로의 구분보다는 경로 패턴에 의존하여 설정하는 것이 유리합니다.

3. afterCompletion()
뷰 렌더링이 끝난 직후 호출됩니다. 주로 트랜잭션 커밋이나 스레드 로컬 메모리 정리 등 자원을 회수해야 할 경우에 사용되며, 예외 발생 여부와 상관없이 항상 호출되는 것이 원칙입니다.

인증 토큰을 활용한 인터셉터 구현

사용자의 접근 권한을 검증하기 위해서는 인증 정보를 요청 헤더나 파라미터에서 추출한 뒤, 로컬 변수에 임시 저장하는 방식이 효율적입니다. 아래 코드는 표준 스프링 인터페이스를 확장하여 보안을 강화한 예시입니다.

import org.springframework.web.servlet.HandlerInterceptor;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.util.Map;
import java.util.HashMap;

public class SecureAccessInterceptor implements HandlerInterceptor {

    private static final ThreadLocal> activeSession = new ThreadLocal<>();

    /**
     * 요청 진입 전 인증 체크 수행
     */
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        // Authorization 헤더로부터 Bearer 토큰 추출
        String accessToken = request.getHeader("Authorization");
        
        if (isValidToken(accessToken)) {
            // 유효한 경우 현재 사용자 정보를 스레드 로컬에 세팅
            Map<String, Object> userMap = new HashMap<>();
            userMap.put("username", extractUserFromToken(accessToken));
            userMap.put("roles", getUserRoles(userMap.get("username")));
            activeSession.set(userMap);
            return true;
        }

        // 검증 실패 시 응답 코드 설정 및 흐름 중단
        response.sendError(HttpServletResponse.SC_FORBIDDEN, "인증된 정보 없음");
        return false;
    }

    /**
     * 컨트롤러 실행 후,视图渲染 전 처리
     * 필요에 따라 모델 데이터 수정 가능
     */
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, 
                           Object handler, org.springframework.ui.ModelAndView modelAndView) throws Exception {
        // 공동 기능 또는 로깅 로직 추가 가능
    }

    /**
     * 전체 요청 처리가 완료된 후 리소스 정리
     */
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, 
                                Object handler, Exception ex) throws Exception {
        // 메모리 누수 방지를 위해 스레드 로컬 데이터 제거 필수
        activeSession.remove();
    }
    
    // 토큰 검증 관련 보조 메서드 (예시)
    private boolean isValidToken(String token) {
        return token != null && !token.isEmpty();
    }

    private String extractUserFromToken(String token) {
        // JWT Decoding or other logic
        return "user";
    }

    private String getUserRoles(String username) {
        return "ROLE_USER";
    }
}

웹 컨피그레이션 적용

구현된 인터셉터를 스프링 컨테이너에 등록하려면 WebMvcConfigurer 인터페이스를 구현한 설정 클래스를 생성해야 합니다. 이 과정에서 특정 엔드포인트는 인증 프로세스에서 제외시키는 것이 개발 편의성을 높이는 일반적인 패턴입니다.

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class AppConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new SecureAccessInterceptor())
                .addPathPatterns("/api/**")      // 대상 경로 범위
                .excludePathPatterns("/api/public/**") // 예외 경로 (로그인, 회원가입 등)
                .excludePathPatterns("/swagger-ui/**", "/doc-api.html");
    }
}

태그: spring-mvc handler-interceptor JWT-Authentication thread-local web-security

10월 24일 11:15에 게시됨