JWT와 보안 토큰 가이드 이미지

JWT 보안에 세심한 주의가 필요한 이유

JWT는 웹 개발에서 가장 많이 잘못 구현되는 보안 메커니즘 중 하나입니다. 라이브러리 덕분에 무언가를 동작시키기는 쉽습니다. 토큰이 발급되고 검증되며 모든 것이 괜찮아 보입니다. 문제는 나중에 나타납니다. 보안 감사에서, 사고가 났을 때, 또는 공격자가 미묘한 설정 오류를 악용할 때입니다.

이 가이드는 알려진 공격 벡터, JWKS를 통한 키 배포 방식, 운영 배포를 위한 실용적인 체크리스트를 다룹니다.


간단 복습: JWT란

JWT(JSON Web Token)는 점으로 구분된 Base64Url 인코딩 부분 세 개로 이루어집니다.

header.payload.signature
  • 헤더: 알고리즘(alg)과 토큰 종류를 지정합니다.
  • 페이로드: 클레임, 즉 주체에 대한 데이터와 메타데이터를 담습니다.
  • 서명: 헤더와 페이로드가 변조되지 않았음을 보여 주는 암호학적 증거입니다.

페이로드는 인코딩되어 있을 뿐 암호화되어 있지 않습니다. JWT를 가로챈 사람은 누구나 페이로드를 읽을 수 있습니다. 서명은 무결성만 증명하며 기밀성은 제공하지 않습니다.


공격 벡터 1: alg: none 공격

JWT 사양은 원래 알고리즘 값으로 "none"을 허용했으며, 이는 토큰에 서명이 없다는 뜻입니다. 초기 구현 중 일부는 키가 있는지 확인하지 않고 이를 받아들였고, 공격자가 임의의 페이로드로 토큰을 위조할 수 있었습니다.

공격 시나리오:

  1. 공격자가 정상적인 JWT를 가로챕니다.
  2. 공격자가 헤더와 페이로드를 디코딩합니다(Base64Url 디코딩이며 키가 필요 없습니다).
  3. 공격자가 페이로드를 수정합니다: "role": "admin".
  4. 공격자가 "alg": "none"으로 다시 인코딩하고 빈 서명 세그먼트를 보냅니다.
  5. 취약한 서버가 토큰을 받아들입니다.

방어:

// jose 라이브러리: 명시적인 알고리즘 허용 목록
import * as jose from 'jose';

const { payload } = await jose.jwtVerify(token, secret, {
  algorithms: ['HS256'],  // 'none'은 절대 포함하지 마세요
});

검증에 어떤 알고리즘을 쓸지 토큰 자체에 지정된 알고리즘에 의존해서는 안 됩니다. 알고리즘은 서버 측에서 강제해야 합니다.


공격 벡터 2: 알고리즘 혼동(RS256 → HS256)

비대칭 JWT는 서명에 개인 키를, 검증에 공개 키를 사용합니다. 일부 취약한 구현은 JWT 헤더의 alg 필드, 즉 공격자가 통제하는 필드를 읽어 검증 알고리즘을 결정합니다.

공격 시나리오(공개 키 서버):

  1. 서버는 보통 RS256을 사용합니다. 개인 키로 서명하고 클라이언트는 공개 키로 검증합니다.
  2. 공격자는 서버의 공개 키를 알고 있습니다(어쨌든 공개된 것입니다).
  3. 공격자가 "alg": "HS256"인 JWT를 만듭니다.
  4. 공격자가 공개 키를 비밀로 삼아 HMAC-SHA256으로 JWT에 서명합니다.
  5. 취약한 서버가 헤더에서 alg: HS256을 읽고 HMAC 검증으로 전환하여 공개 키를 HMAC 비밀로 사용합니다. 그 결과 공격자가 위조한 토큰을 의도치 않게 검증해 줍니다.

방어: 서버에서 기대하는 알고리즘을 코드에 고정하세요. 검증 방식을 고르는 데 alg 클레임을 절대 신뢰하지 마세요.

// RS256을 명시적으로 요구: 토큰의 alg 클레임은 무시합니다
import * as jose from 'jose';
const publicKey = await jose.importSPKI(publicKeyPem, 'RS256');
const { payload } = await jose.jwtVerify(token, publicKey, {
  algorithms: ['RS256'],
});

공격 벡터 3: 약하거나 노출된 비밀

HS256(대칭 HMAC)에서는 서명과 검증에 같은 비밀을 씁니다. 이 비밀이 다음과 같다면:

  • 짧다(32바이트 미만)
  • 예측 가능하다(예: “secret”이라는 단어)
  • 공개적으로 볼 수 있는 소스 코드에 하드코딩되어 있다

…공격자가 무차별 대입이나 추측으로 알아낼 수 있습니다. 비밀을 손에 넣으면 원하는 JWT를 마음대로 위조할 수 있습니다.

방어:

  • 암호학적으로 안전한 무작위 비밀을 최소 256비트(32바이트) 이상으로 사용하세요.
  • 비밀은 환경 변수나 시크릿 매니저(AWS Secrets Manager, HashiCorp Vault)에 보관하세요.
  • 비밀을 버전 관리에 절대 커밋하지 마세요.
# 강력한 비밀 생성(Linux/Mac)
openssl rand -base64 32
# → "K8aJz3mP9xQrTvN2wY5oHiE7uLbCdF1s"

공격 벡터 4: 클레임 검증 누락

서명을 발급하고 검증하는 것만으로는 충분하지 않습니다. 유효한 서명이 이 요청에 토큰을 받아들여야 한다는 뜻은 아닙니다.

클레임 검증하지 않을 때의 공격
exp 만료된 토큰이 무기한 받아들여짐
nbf 활성화 예정 시각 전에 토큰이 받아들여짐
iss 다른 서비스가 발급한 토큰이 받아들여짐
aud 서비스 A용 토큰을 서비스 B가 받아들임

방어: 관련된 모든 클레임을 검증하세요.

const { payload } = await jose.jwtVerify(token, secret, {
  issuer: 'https://auth.example.com',
  audience: 'https://api.example.com',
  // exp와 nbf는 jose가 자동으로 검증합니다
});

JWKS를 이용한 키 관리

운영 시스템, 특히 서비스가 여러 개이거나 외부 연동이 있는 경우에는 대칭 공유 비밀을 관리하기가 어려워집니다. 토큰을 검증해야 하는 모든 서비스가 비밀을 알아야 해서 공격 표면이 커집니다.

JWKS(JSON Web Key Set) 는 비대칭 암호로 이 문제를 해결합니다.

  1. 인가 서버가 키 쌍(개인 키와 공개 키)을 생성합니다.
  2. 개인 키는 인가 서버에 남아 JWT에 서명하는 데 쓰입니다.
  3. 공개 키는 잘 알려진 URL, 즉 JWKS 엔드포인트에 표준화된 JSON 형식으로 공개됩니다.
  4. 어떤 서비스든 JWKS 엔드포인트에서 공개 키를 가져와 JWT를 검증할 수 있습니다.

JWT 헤더에는 kid(Key ID) 클레임이 들어 있어, 검증하는 쪽에 JWKS의 어느 키를 쓸지 알려 줍니다.

{
  "alg": "RS256",
  "typ": "JWT",
  "kid": "2026-01-key"
}

JWKS 문서는 이렇게 생겼습니다.

{
  "keys": [
    {
      "kty": "RSA",
      "use": "sig",
      "alg": "RS256",
      "kid": "2026-01-key",
      "n": "0vx7agoebGcQSuuPiLJXZptN...",
      "e": "AQAB"
    }
  ]
}

JWKS의 장점:

  • 키 교체: 새 키를 추가하고 이전 토큰이 만료되기를 기다린 뒤 이전 키를 제거합니다. 서비스 재시작이나 비밀 배포가 필요 없습니다.
  • 비밀 공유 없음: 서비스는 공개 키만 있으면 됩니다. 검증 서비스가 침해되어도 서명 능력은 침해되지 않습니다.
  • 다중 발급자 지원: 여러 JWKS 엔드포인트를 확인해 여러 제공자(예: Auth0, Okta, 자체 서비스)의 토큰을 검증할 수 있습니다.

JWKS 가져오기와 캐싱:

import * as jose from 'jose';

// jose의 JWKS 클라이언트는 키를 캐시하고 알 수 없는 kid를 만나면 새로 고칩니다
const JWKS = jose.createRemoteJWKSet(
  new URL('https://auth.example.com/.well-known/jwks.json')
);

const { payload } = await jose.jwtVerify(token, JWKS, {
  issuer: 'https://auth.example.com',
  audience: 'https://api.example.com',
});

토큰 폐기 전략

JWT는 상태가 없습니다. 한 번 발급되면 만료될 때까지 유효합니다. 그래서 과제가 생깁니다. 로그아웃, 비밀번호 변경, 계정 탈취 등으로 토큰을 즉시 무효화해야 한다면 어떻게 할까요?

전략 1: 짧은 만료 + 리프레시 토큰

  • 액세스 토큰은 15~60분 뒤 만료됩니다.
  • 리프레시 토큰(HttpOnly 쿠키로 보관)은 7~30일 유지됩니다.
  • 폐기는 리프레시 토큰 수준에서만 하면 됩니다.

전략 2: 토큰 차단 목록

폐기된 jti(JWT ID) 클레임을 토큰 만료 시간과 같은 TTL로 빠른 저장소(Redis)에 보관합니다.

// 로그아웃 시
await redis.set(`blocklist:${payload.jti}`, '1', { EX: remainingSeconds });

// 매 요청마다 토큰을 신뢰하기 전에 확인
const isRevoked = await redis.exists(`blocklist:${payload.jti}`);
if (isRevoked) throw new Error('Token has been revoked');

전략 3: 수명이 짧은 서명 키

한 시간마다 새 서명 키를 생성합니다. JWKS 엔드포인트에는 최근 N개의 키만 남깁니다. 만료된 키로 서명된 이전 토큰은 자동으로 거부됩니다. 차단 목록은 필요 없지만 키 교체 인프라가 필요합니다.


클라이언트에서의 안전한 보관

클라이언트가 JWT를 어디에 보관하느냐가 취약점의 범위를 결정합니다.

저장소 XSS 위험 CSRF 위험 권장
localStorage 높음 없음 토큰에는 피하세요
sessionStorage 높음 없음 토큰에는 피하세요
JavaScript 변수 중간 없음 단기 메모리 보관용으로 괜찮음
HttpOnly 쿠키 없음 있음(SameSite로 완화) 권장

웹 애플리케이션에서 가장 안전한 방법: 액세스 토큰은 메모리(JavaScript 변수)에, 리프레시 토큰은 HttpOnly, Secure, SameSite=Strict 쿠키에 보관합니다.


운영 보안 체크리스트

  • 서명 비밀이 256비트 이상이며 무작위로 생성되었다
  • 비밀이 코드가 아니라 환경 변수나 시크릿 매니저에 보관된다
  • alg를 토큰 헤더에서 읽지 않고 서버에서 명시적으로 지정한다
  • alg: none을 절대 받아들이지 않는다
  • exp 클레임을 설정한다(액세스 토큰은 15~60분 권장)
  • iss와 aud 클레임을 매 요청마다 검증한다
  • 폐기가 필요할 수 있는 토큰에 jti 클레임을 포함한다
  • 토큰을 발급하거나 검증하는 모든 엔드포인트에서 HTTPS를 강제한다
  • 리프레시 토큰을 localStorage가 아니라 HttpOnly 쿠키에 보관한다
  • 비대칭 키 배포에 JWKS 엔드포인트를 사용한다(여러 서비스로 이루어진 시스템)
  • 키 교체 절차가 문서화되고 테스트되었다

자주 묻는 질문

HS256과 RS256 중 무엇을 써야 하나요?

HS256(대칭): 구현이 간단하며 하나의 서비스가 토큰을 발급하고 검증하는 단일 서비스 시스템에 알맞습니다. 키는 사용되는 모든 곳에서 비밀로 유지해야 합니다.

RS256(비대칭): 여러 서비스로 이루어진 아키텍처에 권장됩니다. 개인 키는 인가 서버만 가지고, 나머지 서비스는 (JWKS를 통해) 공개 키로 검증합니다. 설정은 더 복잡하지만 보안 수준이 크게 좋아집니다.

다운타임 없이 키를 교체하려면 어떻게 하나요?

새 공개 키와 이전 공개 키를 JWKS 엔드포인트에 동시에 공개합니다. 새 토큰은 새 키(새 kid)로 서명합니다. 이전 키로 서명된 이전 토큰은 JWKS의 이전 공개 키로 계속 검증됩니다. 이전 토큰이 모두 만료되면 JWKS에서 이전 키를 제거합니다.

JWT 암호화도 있나요?

있습니다. JWE(JSON Web Encryption) 는 페이로드를 암호화해 복호화 키 없이는 내용을 읽을 수 없게 합니다. 표준 JWT(JWS)는 서명만 하고 암호화하지 않으므로 페이로드는 누구나 읽을 수 있습니다. JWE는 페이로드 자체가 전송 중에 기밀로 유지되어야 할 때만 쓰세요.

같은 JWT를 인증과 인가에 모두 써도 되나요?

페이로드에 둘 다 넣는 것이 흔합니다. sub 클레임이 사용자를 식별하고(인증), role이나 scope 같은 사용자 정의 클레임이 할 수 있는 일을 제어합니다(인가). 토큰 크기에 유의하고, 자주 바뀌는 인가 데이터를 많이 넣지 않도록 하세요.