[java] Tomcat의 CORS 필터 설정과 동일 출처 정책 관리

28 Nov 2023

java

크로스 오리진 자원 공유(Cross-Origin Resource Sharing, CORS)는 웹 애플리케이션이 동일한 출처가 아닌 도메인 간에 리소스를 공유할 수 있게 해주는 보안 메커니즘입니다. 자바 웹 애플리케이션에서 CORS를 관리하기 위해 Tomcat의 CORS 필터 설정을 사용할 수 있습니다.

CORS 필터 설정하기

Tomcat에서 CORS 필터를 사용하기 위해 다음 단계를 따르세요.

web.xml 파일에 아래와 같은 필터를 추가합니다.

<filter>
    <filter-name>CorsFilter</filter-name>
    <filter-class>org.apache.catalina.filters.CorsFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>CorsFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

필터를 원하는 URL 패턴에 적용하고 싶다면, <url-pattern> 엘리먼트 내부에 패턴을 지정합니다. 위의 예시에서는 모든 URL에 필터를 적용하는 것을 의미합니다.
필터의 동작을 구성하기 위해 CorsFilter에 대한 추가적인 설정을 제공할 수 있습니다. 필터 클래스에 대한 상세한 설명과 설정 옵션은 Tomcat 문서를 참조하세요¹.
웹 애플리케이션을 다시 빌드하고 배포한 후, Tomcat을 다시 시작합니다.

동일 출처 정책 관리하기

CORS 필터를 통해 Tomcat에서 동일 출처 정책을 관리할 수 있습니다. 동일 출처 정책은 웹 브라우저에서 실행되는 애플리케이션 간에 상호 작용을 통제하는 보안 메커니즘입니다.

아래는 CORS 필터를 사용하여 동일 출처 정책을 관리하는 예시입니다.

필터 설정에서 addAllowedOrigin 메서드를 사용하여 허용할 도메인을 지정합니다.

CorsFilter corsFilter = new CorsFilter();
corsFilter.getAllowedOrigins().add("http://example.com");

허용할 도메인이 여러 개일 경우, addAllowedOrigin 메서드를 여러 번 호출하여 추가할 수 있습니다.

corsFilter.getAllowedOrigins().add("http://example.com");
corsFilter.getAllowedOrigins().add("http://example2.com");

필터 설정에 따라 HTTP 요청이 허용되거나 거부됩니다.

결론

Tomcat의 CORS 필터를 사용하여 동일 출처 정책을 관리할 수 있습니다. 필터 설정을 통해 웹 애플리케이션에서 안전하게 크로스 오리진 자원 공유를 구현할 수 있습니다.

Tomcat Documentation - Configuring Filters ↩