이 글에서 소개한 도구
글을 읽으면서 브라우저에서 바로 도구를 열어 작업 흐름을 직접 확인해 보세요.

JWT 보안에 세심한 주의가 필요한 이유
JWT는 웹 개발에서 가장 많이 잘못 구현되는 보안 메커니즘 중 하나입니다. 라이브러리 덕분에 무언가를 동작시키기는 쉽습니다. 토큰이 발급되고 검증되며 모든 것이 괜찮아 보입니다. 문제는 나중에 나타납니다. 보안 감사에서, 사고가 났을 때, 또는 공격자가 미묘한 설정 오류를 악용할 때입니다.
이 가이드는 알려진 공격 벡터, JWKS를 통한 키 배포 방식, 운영 배포를 위한 실용적인 체크리스트를 다룹니다.
간단 복습: JWT란
JWT(JSON Web Token)는 점으로 구분된 Base64Url 인코딩 부분 세 개로 이루어집니다.
header.payload.signature
- 헤더: 알고리즘(
alg)과 토큰 종류를 지정합니다. - 페이로드: 클레임, 즉 주체에 대한 데이터와 메타데이터를 담습니다.
- 서명: 헤더와 페이로드가 변조되지 않았음을 보여 주는 암호학적 증거입니다.
페이로드는 인코딩되어 있을 뿐 암호화되어 있지 않습니다. JWT를 가로챈 사람은 누구나 페이로드를 읽을 수 있습니다. 서명은 무결성만 증명하며 기밀성은 제공하지 않습니다.
공격 벡터 1: alg: none 공격
JWT 사양은 원래 알고리즘 값으로 "none"을 허용했으며, 이는 토큰에 서명이 없다는 뜻입니다. 초기 구현 중 일부는 키가 있는지 확인하지 않고 이를 받아들였고, 공격자가 임의의 페이로드로 토큰을 위조할 수 있었습니다.
공격 시나리오:
- 공격자가 정상적인 JWT를 가로챕니다.
- 공격자가 헤더와 페이로드를 디코딩합니다(Base64Url 디코딩이며 키가 필요 없습니다).
- 공격자가 페이로드를 수정합니다:
"role": "admin". - 공격자가
"alg": "none"으로 다시 인코딩하고 빈 서명 세그먼트를 보냅니다. - 취약한 서버가 토큰을 받아들입니다.
방어:
// jose 라이브러리: 명시적인 알고리즘 허용 목록
import * as jose from 'jose';
const { payload } = await jose.jwtVerify(token, secret, {
algorithms: ['HS256'], // 'none'은 절대 포함하지 마세요
});
검증에 어떤 알고리즘을 쓸지 토큰 자체에 지정된 알고리즘에 의존해서는 안 됩니다. 알고리즘은 서버 측에서 강제해야 합니다.
공격 벡터 2: 알고리즘 혼동(RS256 → HS256)
비대칭 JWT는 서명에 개인 키를, 검증에 공개 키를 사용합니다. 일부 취약한 구현은 JWT 헤더의 alg 필드, 즉 공격자가 통제하는 필드를 읽어 검증 알고리즘을 결정합니다.
공격 시나리오(공개 키 서버):
- 서버는 보통 RS256을 사용합니다. 개인 키로 서명하고 클라이언트는 공개 키로 검증합니다.
- 공격자는 서버의 공개 키를 알고 있습니다(어쨌든 공개된 것입니다).
- 공격자가
"alg": "HS256"인 JWT를 만듭니다. - 공격자가 공개 키를 비밀로 삼아 HMAC-SHA256으로 JWT에 서명합니다.
- 취약한 서버가 헤더에서
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) 는 비대칭 암호로 이 문제를 해결합니다.
- 인가 서버가 키 쌍(개인 키와 공개 키)을 생성합니다.
- 개인 키는 인가 서버에 남아 JWT에 서명하는 데 쓰입니다.
- 공개 키는 잘 알려진 URL, 즉 JWKS 엔드포인트에 표준화된 JSON 형식으로 공개됩니다.
- 어떤 서비스든 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 같은 사용자 정의 클레임이 할 수 있는 일을 제어합니다(인가). 토큰 크기에 유의하고, 자주 바뀌는 인가 데이터를 많이 넣지 않도록 하세요.
