브라우저 JS에서 인증 토큰 걷어내기: Redis 세션 대신 토큰 쿠키를 고른 이유

브라우저 JS가 로그인 토큰을 직접 읽지 못하도록, 토큰을 브라우저 스토리지에서 BFF가 발급하는 HttpOnly 쿠키 두 개로 옮겼습니다.

배경과 과제

배경

기능을 빠르게 연결하려고, 백엔드가 응답 본문으로 주는 로그인 토큰을 Browser Storage에 원문으로 저장했습니다. access 토큰은 30분, refresh 토큰은 14일짜리 1회용입니다.

백엔드는 서비스 분리를 앞두고 모듈 간 의존을 끊어 둔 모듈러 모놀리스입니다. 그래서 각 API는 자기 모듈 데이터만 줍니다. 장바구니는 옵션 번호만 주고, 상품 정보는 product 모듈에 있습니다. 리뷰는 작성자 번호만 주고, 닉네임은 member 모듈에 있습니다.

백엔드가 이 데이터를 한 응답에 담으려면 모듈끼리 internal 호출을 해야 합니다. 주문 생성처럼 비즈니스 규칙에 필요한 연결은 그렇게 하는 게 맞습니다. 하지만 화면 표시 때문에 서비스 코드에 의존을 만들면, 끊어 둔 의존이 화면 수만큼 다시 생깁니다.

핵심 과제

XSS가 한 번만 뚫려도 refresh 토큰까지 밖으로 새어 최대 14일 동안 쓰일 수 있었습니다.

설계 시 고려한 점

  • 토큰만 문제였다면 백엔드가 HttpOnly 쿠키를 발급하는 방법도 있었습니다. 그러나 화면 데이터를 조합할 계층이 어차피 필요했습니다. 그래서 프론트엔드가 소유하는 BFF(Hono)를 두고 토큰 보관도 BFF에 맡겼습니다. 서버 계층을 직접 설계해 보는 경험도 목표 중 하나였습니다.
  • refresh 토큰이 1회용이라 두 요청이 같은 refresh 토큰으로 재발급하면 한쪽이 로그아웃됩니다.
  • 토큰을 쿠키에 두면 CSRF 대응이 새로 필요합니다.

운영 제약

  • 운영 BFF는 한 대이고, 당분간 늘릴 계획이 없었습니다.
  • 기존 방식은 배포해도 로그인이 유지됐습니다. BFF를 배포할 때마다 전원이 로그아웃되면 기존보다 퇴보합니다.
  • BFF는 백엔드 공개 API(/api/v1)만 부르고, 내부 API는 부르지 않기로 정했습니다.
  • 백엔드에는 login과 reissue API만 있고, logout API는 없습니다.

토큰 쿠키가 오가는 구조

토큰은 쿠키에 두고, 재발급은 BFF가 맡는 구조

브라우저 JS는 토큰을 읽지 못합니다. BFF가 로그인 때 쿠키 두 개를 발급하고 refresh 쿠키는 재발급 경로에만 실립니다.

토큰은 쿠키에 두고, 재발급은 BFF가 맡는 구조브라우저가 HttpOnly 쿠키 두 개를 가진 채 Vercel rewrite와 EC2의 nginx를 거쳐 Hono BFF로 요청하고, BFF가 백엔드 공개 API를 부르는 구조브라우저백엔드 EC2HTTPS · Secure 쿠키평문 구간(HTTPS 작업 진행 중)/bff/ 경로공개 API(/api/v1)만프론트엔드Reactaccess 쿠키Path=/refresh 쿠키Path=/bff/sessionVercelrewritenginxHono BFF쿠키 발급·재발급Spring Boot 백엔드login·reissue API
토큰은 쿠키에 두고, 재발급은 BFF가 맡는 구조브라우저가 HttpOnly 쿠키 두 개를 가진 채 Vercel rewrite와 EC2의 nginx를 거쳐 Hono BFF로 요청하고, BFF가 백엔드 공개 API를 부르는 구조브라우저백엔드 EC2HTTPS · Secure 쿠키평문 구간(HTTPS 작업 진행 중)/bff/ 경로공개 API(/api/v1)만프론트엔드Reactaccess 쿠키Path=/refresh 쿠키Path=/bff/sessionVercelrewritenginxHono BFF쿠키 발급·재발급Spring Boot 백엔드login·reissue API

적용 결과

보안
로그인 토큰이 브라우저 JS에서 사라졌습니다. 쿠키 발급, 재발급, CSRF 처리는 BFF 테스트 27개로 검증했습니다.
운영
세션 저장소를 두지 않아 BFF를 재시작하거나 배포해도 로그인이 유지됩니다.
판단 근거
Redis 세션을 직접 구현해 BFF가 여러 대일 때 동시 재발급 경합이 실제로 생긴다는 것을 실험으로 확인했습니다.

핵심 구현과 판단

1. 토큰을 둘 자리 비교

선택지 네 가지를 비교했습니다. BFF가 이미 있어서 access 토큰까지 쿠키로 옮기는 비용이 작았습니다. 그러면 토큰이 JS에서 완전히 사라집니다. 그래서 토큰 쿠키 두 개를 골랐습니다.

  • 현행 유지(Browser Storage): XSS가 뚫리면 refresh 토큰까지 빠져나가 최대 14일 동안 쓰일 수 있습니다.
  • access 토큰은 JS 메모리, refresh 토큰은 HttpOnly 쿠키: 빼낸 토큰을 밖에서 다시 쓸 수 있는 기간은 access 토큰 만료(30분)까지로 줄어듭니다. 하지만 XSS로 access 토큰을 빼내는 길은 남습니다.
  • BFF 세션(sessionId 쿠키와 Redis): 서버에서 세션을 끊을 수 있고 BFF가 여러 대여도 됩니다. 대신 Redis 운영 부담이 따라옵니다.
  • 토큰 쿠키 두 개(채택): access 토큰과 refresh 토큰을 각각 HttpOnly 쿠키에 담습니다.

2. Redis 세션을 구현했다가 채택하지 않은 이유

처음에는 Redis 세션을 택했습니다. 메모리 세션은 BFF를 재시작할 때마다 전원이 로그아웃됩니다. SQLite는 서버의 로컬 파일이라 인스턴스끼리 공유할 수 없습니다.

Redis에 세션과 재발급 락을 구현해 검증했습니다. 락은 소유자 값과 만료를 두고, 소유자를 확인한 뒤 해제합니다. 같은 Redis를 쓰는 BFF 두 대에 동시 요청 6건을 보냈습니다. 락이 없으면 3건이 401(로그아웃)이 됐습니다. 락을 넣자 6건 모두 성공했고 재발급은 한 번만 일어났습니다.

  • 운영 BFF는 한 대였습니다. ACL 계정, 저장값 암호화 키와 같은 부담만 늘었습니다.
  • 배포 후 로그인 유지는 토큰 쿠키로 충족했습니다. 서버에서 세션을 즉시 폐기하는 기능은 Redis 방식의 장점이지만 이번 범위에서 제외했습니다. 따라서 현재 요구에 비해 운영 비용이 크다고 판단했습니다.
  • 그래서 채택하지 않았습니다. 코드는 지우지 않고 연결만 끊었습니다. BFF가 여러 대가 되거나 서버에서 세션을 끊어야 하면 되살리기 위함입니다.

4. 프론트엔드와 나눈 재발급 흐름

BFF는 /api 요청을 처리하는 중에 재발급하지 않습니다. refresh 쿠키가 /bff/session 경로에만 실리기 때문입니다. 그래서 재발급을 부르는 시점은 프론트엔드가 정하도록 나눴습니다.

  • access 토큰이 만료되면 브라우저가 access 쿠키를 보내지 않아 /api 요청이 401을 받습니다. BFF는 이 401을 그대로 돌려줍니다.
  • 프론트엔드는 POST /bff/session/refresh를 한 번 부르고 같은 요청을 다시 보냅니다.
  • 로그인 상태를 확인하는 GET /bff/session에는 refresh 쿠키가 실립니다. 그래서 access 토큰이 없으면 BFF가 그 자리에서 재발급합니다.
  • 판매자 승인처럼 역할이 바뀐 뒤에는 access 토큰이 남아 있어도 /bff/session/refresh로 새 토큰을 받습니다.
  • 이 흐름은 BFF 테스트로 확인했습니다.

5. 여러 탭의 동시 재발급을 한 번으로 묶기

refresh 토큰이 1회용이라 두 탭이 같은 refresh 토큰으로 재발급하면 한쪽이 로그아웃됩니다. BFF는 같은 refresh 토큰으로 온 재발급을 메모리에서 한 번만 처리합니다. 결과를 10초 동안 기억해 늦게 온 탭에도 새 토큰을 줍니다.

  • BFF가 한 대라 메모리로 충분합니다. BFF가 여러 대가 되면 Redis 락이 다시 필요합니다.

6. CSRF 대응과 BFF 테스트

쿠키를 쓰면서 CSRF 대응이 새로 필요해졌습니다. 쿠키는 SameSite=Lax로 두고, 쿠키를 실은 POST는 Origin이 허용 목록에 없거나 비어 있으면 403으로 막습니다.

경로와 만료를 지키는 가짜 쿠키 저장소를 만들어 BFF를 테스트했습니다. 세션과 CSRF 테스트 19개, 프록시 테스트 8개입니다.

  • 로그인하면 응답 본문에는 회원 정보만 싣고, 토큰은 HttpOnly 쿠키 두 개에만 담는지 확인했습니다.
  • access 토큰이 만료되면 /api가 401을 주고, /bff/session/refresh 뒤 다시 보내면 성공하는지 확인했습니다.
  • 같은 refresh 토큰의 동시 재발급과 10초 안에 늦게 온 재발급이 백엔드 재발급 한 번으로 끝나는지 확인했습니다. 10초가 지나면 401입니다.
  • 재발급 실패를 원인별로 다르게 처리하는지 확인했습니다. 원인별 처리는 아래 예외 처리에 적었습니다.

주요 예외 처리

재발급이 실패한 원인에 따라 쿠키를 지울지 남길지를 나눴습니다. 백엔드의 일시적인 장애로는 사용자를 로그아웃시키지 않는 것이 기준입니다.

재발급 중 백엔드가 5xx를 주거나 429로 막힌 경우

처리
BFF가 쿠키를 지우지 않고 502를 돌려줍니다. 백엔드가 refresh 토큰을 거절한 응답(400·401·403)만 로그아웃으로 봅니다.
결과
백엔드의 일시적인 장애로 사용자가 로그아웃되지 않습니다.

백엔드가 refresh 토큰을 거절한 경우 (만료·재사용·위조)

처리
BFF가 401을 돌려주고 두 쿠키를 지웁니다.
결과
거절된 토큰이 쿠키에 남지 않고 로그아웃 상태가 됩니다.

백엔드가 만료가 아닌 이유로 401을 준 경우 (잘못된 토큰)

처리
상품 목록·상세 같은 공개 화면은 잘못된 토큰이 남아 있어도 비회원으로 계속 보여야 합니다. 백엔드는 잘못된 토큰이 붙은 요청을 공개 API여도 401로 거절합니다. 그래서 BFF가 쿠키를 지우고 토큰 없이 요청을 한 번 더 보냅니다.
결과
공개 화면은 비회원으로 계속 보이고 로그인이 필요한 요청은 401로 끝납니다.
추가 예외 처리 1개

다른 사이트가 로그인 요청을 대신 보내는 경우 (로그인 CSRF)

처리
/bff 요청은 쿠키가 없어도 Origin이 허용 목록에 없으면 403을 돌려줍니다.
결과
다른 사이트가 방문자를 공격자 계정으로 로그인시키지 못합니다.

감수한 것과 다음 과제

로그아웃은 쿠키를 지우는 것뿐입니다. 백엔드에 logout API가 없어서 이미 새어 나간 refresh 토큰은 14일까지 막을 수 없습니다.

XSS가 뚫리면, 페이지가 열려 있는 동안 공격자가 그 안에서 요청을 대신 보낼 수 있습니다. 제가 막은 것은 토큰 유출입니다.

브라우저와 Vercel 사이는 HTTPS라 Secure 쿠키가 동작합니다. 하지만 Vercel에서 EC2로 가는 구간은 HTTPS 작업 전까지 평문입니다. 재발급 요청 때 refresh 토큰이 이 구간을 지납니다.

다음 과제는 화면 조합입니다. 장바구니, 리뷰 작성자, 상품 판매자, 판매자 주문 목록이 모듈 경계에 막혀 있다는 것을 확인했습니다. 실제로 모으려면 다른 모듈을 조회하는 공개 API(예: 옵션 번호로 상품 찾기)가 먼저 필요합니다.

ASK ME기준 ·이 글 · 브라우저 JS에서 인증 토큰 걷어내기: Redis 세션 대신 토큰 쿠키를 고른 이유

프로젝트, 담당 범위, 기술적 판단을 물어보세요.

추천 질문

포트폴리오에 작성된 내용으로만 답합니다