[스프링] Cookie 와 ResponseCookie 의 차이점이 뭔가요?
들어가며
프로젝트를 진행하며 쿠키를 클라이언트에 전달하는 로직을 구현했다.
하지만 테스트 과정에서 쿠키가 정상적으로 저장되지 않는 문제를 겪게 되었고, 이를 계기로 쿠키 동작 방식에 대해 다시 살펴보게 되었다.
문제의 원인은 단순했다.
Secure 쿠키는 HTTPS 에서만 전송되고, http 와 https 처럼 스킴이 다르면 브라우저가 다른 사이트로 판단하는 보안 정책 때문이었다.
다만 이 과정을 통해 그동안 막연하게 사용해왔던 쿠키에 대해 제대로 이해할 필요성을 느꼈다.
이 글에서는 해당 경험을 바탕으로 Cookie 와 Spring 에서 제공하는 ResponseCookie 에 대해서 정리해보려고 한다.
Cookie 와 ResponseCookie
Cookie 가 뭐예요?
Cookie 는 웹 서버가 웹 클라이언트에게 보내는 데이터 종류 중 하나로, 브라우저는 받은 쿠키를 내부에 저장하고 웹 서버에 요청을 보낼 때마다 쿠키를 요청에 담아서 전달한다.
Cookie(servlet.http.Cookie) 의 역할
- 요청(Request)에 포함된 쿠키를 읽을 때
- 전통적인 방식으로 쿠키를 응답에 추가할 때
Cookie 설정 방법
Setter 방식으로 설정을 할 수 있다.
1
2
3
4
5
6
7
Cookie cookie = new Cookie("refreshToken", refreshToken);
cookie.setHttpOnly(true);
cookie.setSecure(true);
cookie.setPath("/jwt/refresh");
cookie.setMaxAge(7 * 24 * 60 * 60); // 7일
response.addCookie(cookie); // 응답에 쿠키 추가
ResponseCookie 의 역할
- 쿠키를 응답에 추가할 때
- 보안 설정이 중요한 경우
Cookie 의 경우 보안 설정에 한계가 있다. (Servlet 6 / Spring Boot 3 부터는 setAttribute("SameSite", "Lax") 로 설정할 수 있다.) 하지만 ResponseCookie 의 경우 더 풍부한 보안 설정 메서드를 지원하기 때문에 응답으로 사용하기 적합하다.
ResponseCookie 설정 방법
ResponseCookie 의 경우 Builder 패턴으로 설정이 가능하다.
1
2
3
4
5
6
7
8
9
ResponseCookie cookie = ResponseCookie.from("refreshToken", refreshToken)
.path("/")
.sameSite("Lax")
.httpOnly(true)
.secure(true)
.maxAge(7 * 24 * 60 * 60)
.build();
response.addHeader(HttpHeaders.SET_COOKIE, cookie.toString());
Cookie 와 ResponseCookie 차이점
| ResponseCookie | |
|---|---|
| Servlet 표준 | Spring 전용 |
| Setter 패턴 | Builder 패턴 |
| 제한적인 보안 설정 (Servlet 6 이전) | 보안 설정 완전 지원 |
Cookie 와 Response Cookie 는 각각 언제 사용하지?
Cookie 는 요청 쿠키를 조회할 때 필수적으로 사용된다.
ResponseCookie 는 더 많은 보안 옵션 설정을 할 수 있어서 응답에 추가할 때 사용된다.
Cookie 역시 응답이 가능하지만, ResponseCookie 사용이 권장된다.
옵션 정리
- sameSite()
SameSite()는 “이 쿠키를 다른 사이트 요청에도 함께 보낼 것인가?” 를 설정한다.
위에서 언급했지만, 두 방식은 보안 설정 범위의 차이점이 존재한다.
가장 대표적으로 sameSite() 의 유무이다.
sameSite() 에는 몇 가지 옵션이 존재한다.
- Strict (가장 강함)
완전히 동일한 사이트 요청에서만 쿠키 전송 - Lax (기본값)
다른 사이트에서 발생하는 fetch, axios 요청에는 쿠키가 담기지 않음.
CSRF 공격 차단 가능 - None (완전 개방)
이 경우에는 secure 옵션을 무조건 true 로 해야 한다. 하지만 그럼에도 CSRF 공격에 취약하다.
먼저 공격 시나리오에 대해서 생각해보자
- 사용자가 bank.com 에 로그인(쿠키 저장됨)
- 사용자가 악성 사이트 evil.com 에 접속
- evil.com 이 bank.com/transfer 로 요청 전송
- 쿠키가 자동 포함됨 -> CSRF 공격 발생
SameSite 는 3~4번 단계를 차단해준다.
여기서 같은 사이트란 무엇일까?
프론트: https://myVelog.com
백엔드: https://api.myVelog.com
스프링에서는 이런 경우에도 클라이언트 도메인을 cors 정책에서 허용해주어야 한다.
그러면 이 두 도메인은 '다른 사이트' 인가?
정답은 “다른 사이트가 아니다.”
✅ https://myVelog.com 과 https://api.myVelog.com 은 서로 다른 origin 이지만 같은 Site 이다.
- domain()
쿠키가 적용될 도메인 범위를 지정한다.
1
.domain(".example.com")
.example.com 입력 시에는
- example.com
- api.example.com
- www.example.com
모두에서 쿠키 공유
⚠️ 생략 시에는 쿠키를 발급한 도메인에서만 사용 가능하다.
- maxAge()
쿠키의 유효 시간을 설정한다.
1
2
3
.maxAge(Duration.ofDays(7))
// or
.maxAge(7 * 24 * 60 * 60)
초 단위로 설정이 가능하다.
- httpOnly()
JS 의 쿠키 접근을 차단한다.
1
.httpOnly(true)
XSS 공격이 발생해도 쿠키를 탈취당하지 않도록 막을 수 있다.
- secure()
HTTPS 에서만 쿠키를 전송한다.
1
.secure(true)
⚠️ sameSite(“None”) 사용 시 필수이다.
- path()
쿠키 전송 경로를 제한한다.
1
.path("/admin")
이 경우에 /admin 과 그 하위 경로 외에는 쿠키가 전송되지 않는다.
