JWTJSON 웹 토큰 · JSON Web Token
두 당사자 사이에 넘길 클레임(주장)을 JSON 객체로 적고 Base64url 로 압축해, JWS 서명 · MAC 이나 JWE 암호화로 보호하는 URL 안전 토큰 형식이다(RFC 7519).
1요약
- JWT 는 IETF JOSE 문서 묶음(2015-05)의 RFC 7519 가 정한 토큰 형식으로, 점 두 개로 나뉜 헤더 · 페이로드 · 서명 세 부분이 HTTP
Authorization: Bearer헤더에 실려 OAuth 2.0 접근 토큰 · OpenID Connect ID 토큰으로 쓰인다. - 검증 측이 토큰 헤더의
alg를 그대로 믿으면none이나 HS256 바꿔치기로 서명 검사가 통째로 빠지며(RFC 8725 2.1절), Node.jsjsonwebtoken4.2.2 이전 판의 CVE-2015-9235 가 그 사례다. - 「토큰이 거부된다」는 어느 검사에서 멈췄는가로 가른다 — 서명 단계면 키 · 알고리즘 문제, iss · aud 단계면 발급 설정 문제, exp 단계면 시계 · 수명 문제다.
2등장 배경
서버 세션 방식에서는 로그인한 사용자마다 서버가 세션 표를 들고, 요청마다 쿠키의 세션 ID 로 그 표를 찾는다. 서비스가 API 서버 여러 대 · 여러 도메인으로 나뉘면 모든 서버가 같은 세션 저장소를 봐야 하고, 다른 회사 서비스에 «이 사용자는 인증되었다»를 넘길 공통 형식도 없었다 — XML 기반 SAML 2.0(2005) 단언은 크고 URL 에 싣기 어려웠다.
Michael B. Jones 등 일곱 명의 개인 초안(draft-jones-json-web-token · 마지막 판 2012-05)이 IETF OAuth 작업반 초안으로 넘어갔고, 2015년 5월 RFC 7515 ~ 7519(JWS · JWE · JWK · JWA · JWT) 다섯 문서가 한꺼번에 나왔다. RFC 7519 는 발음을 영어 「jot」 과 같게 권한다(1절).
라이브러리 결함이 이어지자 2020년 2월 RFC 8725(BCP 225)가 안전 수칙을 정리했다. 2026년 8월 기준 개정 초안 rfc8725bis-10 이 IESG 에 넘어가 있으나 아직 RFC 가 아니어서, 현행 수칙은 RFC 8725 다.
3쉽게 이해하기 — 도장 찍힌 투명 출입증
행사장 안내 데스크가 방문객 이름 · 들어갈 구역 · 끝나는 시각을 투명 출입증에 적고, 데스크만 가진 도장을 찍어 준다. 방문객이 출입문에 출입증을 내밀면 직원은 데스크에 전화하지 않고 도장과 시각만 보고 들여보낸다. 옆 사람도 출입증 글씨는 다 읽을 수 있고, 누가 글씨를 고치면 도장 무늬가 맞지 않아 걸린다. 다만 잃어버린 출입증은 적힌 시각이 지날 때까지 남이 써도 막기 어렵다.
그림 1 · 데스크가 도장 찍어 준 출입증은 출입문이 데스크에 묻지 않고 확인하며, 글씨는 누구나 읽고 고친 글씨는 도장에 걸리지만 잃어버린 출입증은 시각이 끝날 때까지 쓰인다.
그림 2 · 출입증의 종류 · 내용 · 도장 세 칸이 JWT 의 헤더 · 페이로드 · 서명이고, 읽기는 누구나 하지만 도장은 키를 가진 쪽만 만든다.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 안내 데스크 | 발급자(인증 서버 · iss) | 사용자를 확인하고 클레임을 적어 서명한다 |
| 데스크만 가진 도장 | 서명 키 · alg | HS256 이면 공유 비밀 키, RS256 · ES256 이면 개인키로 서명한다 |
| 투명 출입증 | JWT(JWS 압축 직렬화) | 헤더 · 페이로드 · 서명을 점으로 이은 문자열 하나 |
| 이름 · 구역 | sub · aud 클레임 | 누구의 토큰인지 · 어느 서비스가 받을 토큰인지 |
| 끝 시각 | exp · nbf · iat | NumericDate(1970년 기준 초)로 유효 구간을 정한다 |
| 출입문 직원 | 검증 측(자원 서버) | 허용 알고리즘 · 서명 · iss · aud · exp 를 차례로 본다 |
| 글씨를 읽는 옆 사람 | Base64url 디코딩 | 키 없이 누구나 페이로드를 읽는다 — 감추려면 JWE |
| 잃어버린 출입증 | 탈취된 Bearer 토큰 | 서명이 맞으니 exp 까지 통과한다 |
⚠ 비유가 맞지 않는 곳: 실제 출입문은 도장 «모양»을 눈으로 보지 않고 같은 키로 서명을 다시 계산해 바이트 단위로 비교하며, RS256 처럼 공개키 방식이면 검증 측은 도장을 찍을 수 없는 공개키만 가진다. 헤더의 alg 도 위조자가 고쳐 쓸 수 있어, 검증 측은 그 값을 믿지 않고 자기 설정의 허용 목록과 맞춘다(RFC 8725 3.1절).
4구조 — JWS 압축 직렬화의 세 부분
서명된 JWT 는 BASE64URL(헤더) . BASE64URL(페이로드) . BASE64URL(서명) 꼴의 JWS 압축 직렬화다(RFC 7515 7.1절). Base64url 은 + · / 대신 - · _ 를 쓰고 끝의 = 채움을 뺀 인코딩이라(RFC 4648 5절 · RFC 7515 2절) URL · HTTP 헤더에 그대로 실린다. 암호화된 JWT 는 JWE 로, 점 네 개로 나뉜 다섯 부분이다(RFC 7516 7.1 · 9절).
그림 3 · 서명 입력은 «헤더.페이로드» 문자열 그 자체이고, 여기에 키 32바이트로 HMAC-SHA256 을 돌린 32바이트가 셋째 부분이 된다.
| 요소 | 크기 · 값 | 역할 | 근거 |
|---|---|---|---|
| alg | HS256(필수 구현) · RS256 · ES256 · none | 서명 · MAC 알고리즘 지정 | RFC 7518 3.1절 |
| typ | JWT 권장 · 선택 | 다른 JOSE 객체와 구분 | RFC 7519 5.1절 |
| iss · sub | 문자열 · URI | 발급자 · 주체(사용자) | 4.1.1 · 4.1.2절 |
| aud | 문자열 또는 배열 | 받을 서비스 — 자기 값이 없으면 거부 | 4.1.3절 |
| exp · nbf · iat | NumericDate(초) | 유효 구간 · 발급 시각 | 4.1.4 ~ 4.1.6절 |
| jti | 발급자 안에서 고유 | 재사용 탐지 · 거부 목록 키 | 4.1.7절 |
| 서명 | HS256 = 32바이트 · 43자 | 헤더 · 페이로드 무결성 | RFC 7515 5.1절 |
| 키 | HS256 = 256비트 이상 | 서명 생성 · 검증 | RFC 7518 3.2절 |
🔑 JWT 의 서명은 내용을 숨기지 않고 고치지 못하게만 한다 — 페이로드를 감추려면 JWE 로 따로 암호화해야 한다(RFC 7519 12절 · RFC 7516).
5동작 — 근태 API 토큰의 발급 · 검증 · 거부
사내 근태 앱 사용자 u-1042 가 2026-11-04 00:00:00Z(가정 값 · 한국 시각 09:00)에 로그인해 근태 API 를 부르는 사례다. Python 3.14.0 표준 라이브러리(hmac · hashlib · base64 · json)만으로 직접 실행했고, 키는 설명용 고정 32바이트(0x00 ~ 0x1f) · 주소는 문서용 도메인(RFC 2606)이다.
- 인증 서버가 클레임 6개를 121바이트 JSON 으로 적는다 — iat 1793750400 · exp 1793751300(900초 뒤) · aud
attendance-api(RFC 7519 4.1절). - 헤더 27바이트 · 클레임 121바이트를 Base64url 로 바꿔 36자 · 162자를 얻고, 그 둘을 점으로 이은 서명 입력에 HMAC-SHA256 을 돌려 32바이트 → 43자 서명을 붙여 243자 토큰을 앱에 준다(RFC 7515 5.1절).
- 300초 뒤 앱이
GET /v1/attendance에Authorization: Bearer eyJhbGciOiJIUzI1NiIs…로 토큰을 싣는다(RFC 6750 2.1절). - 근태 API 는 인증 서버에 묻지 않고 alg 가 허용 목록 {HS256} 안인지 →
hmac.compare_digest로 서명 → iss · aud → exp 를 차례로 확인해 수락한다. - 공격자가 페이로드의 sub 를 u-0001 로 바꾸고 원래 서명을 붙여 보내면, 다시 계산한 MAC 이 달라 서명 단계에서 거부된다.
- 헤더를
{"alg":(eyJhbGciOiJub25lIiwidHlwIjoiSldUIn0)로 바꾸고 서명을 비우면, alg 가 허용 목록 밖이라 서명 계산 전에 거부된다(RFC 7518 3.6절 · RFC 8725 2.1절)."none", "typ": "JWT"} - 같은 토큰을 aud 가
payroll-api인 급여 API 에 내면 aud 단계에서, exp 보다 61초 늦게 내면 허용 오차 60초를 넘어 exp 단계에서 거부된다(RFC 7519 4.1.4절 · RFC 8725 3.9절).
그림 4 · 근태 API 는 인증 서버에 묻지 않고 혼자 검증하며, 변조 · alg none · 다른 aud · 만료 토큰은 서로 다른 단계에서 401 로 끝난다.
그림 5 · 검증은 정해진 순서의 관문이고, 사례의 네 가지 거부는 서로 다른 관문에서 멈춘다 — 알고리즘은 토큰이 아니라 서버 설정이 정한다.
🔑 서명이 맞아도 «이 서비스용 토큰»은 아니다 — 서명은 발급자를, aud 는 받을 서비스를 증명하므로 둘 다 통과해야 수락한다(RFC 8725 3.9절).
6비교 — 서버 세션 쿠키 · 불투명 토큰 조회
| 기준 | 서버 세션 쿠키 | JWT(자체 포함 토큰) | 불투명 토큰 + 조회 |
|---|---|---|---|
| 상태를 든 곳 | 서버 세션 저장소 | 토큰 안 클레임 | 인가 서버 저장소 |
| 요청마다 저장소 조회 | 1회(세션 표) | 0회 — 키만 있으면 됨 | 1회(RFC 7662 조회) |
| 즉시 폐기 | 세션 삭제로 다음 요청부터 | exp 까지 유효 · 거부 목록이 있어야 함 | 조회 응답 active: false 로 즉시 |
| 크기 | 세션 ID 수십 바이트 | 사례 243자 · 클레임 늘면 커짐 | 수십 바이트 |
| 도메인 · 회사 넘기 | 같은 사이트 쿠키(RFC 6265) | aud 만 맞으면 어디서나 | 조회 권한이 있는 서버만 |
| 탈취 대비 | HttpOnly · Secure 속성 | 짧은 exp · 저장 위치 · 송신자 제한 | 짧은 수명 · 조회에서 끊기 |
그림 6 · 09:05 에 로그아웃해도 거부 목록 없는 JWT 는 exp 인 09:15 까지 10분 더 통과하고, 세션 삭제 · jti 거부 목록은 다음 요청부터 막는다.
분석한 사이트 안의 브라우저 로그인은 서버 세션 쿠키가 폐기 · 크기에서 앞서고, JWT 는 여러 API 서버 · 다른 도메인이 저장소 조회 없이 같은 토큰을 검증해야 할 때 고른다. 근거는 표의 「즉시 폐기」 · 「요청마다 저장소 조회」 행 — JWT 를 고르면 그림 6 의 노출 구간을 exp 길이로 줄이고, 즉시 끊어야 하는 서비스는 jti 거부 목록이나 RFC 7662 조회를 함께 둔다.
7실무 진단 — 토큰 거부 원인 가르기
분석거부된 토큰을 받아 그림 5 의 관문 순서대로 헤더 → 서명 → 클레임 → 시간을 하나씩 확인하면 원인 단계가 하나로 좁혀진다. RFC 7519 7.2절이 형식 · 헤더 검사를 서명 검증보다 앞에 두고, RFC 8725 3.1절이 알고리즘 검사를 서명 계산과 묶기 때문이다.
| # | 증상 | 의심 원인 | 단계 | 확인 명령 · 자료 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 모든 토큰이 401 · 서명 오류 | 발급 · 검증 키 불일치 · 키 교체 뒤 kid 미반영 | 서명 | 헤더 디코딩 cut -d. -f1 | basenc --base64url -d(채움 보정) · 키 목록의 kid 대조 | 헤더 kid 가 검증 키 목록에 없으면 키 문제(RFC 7515 4.1.4절) |
| 2 | 일부 서버에서만 만료 오류 | 서버 시계 차이 · 허용 오차 0 | 시간 | timedatectl 로 동기화 확인 · 클레임 exp · nbf 와 서버 시각 비교 | 허용 오차는 «몇 분 이내»(RFC 7519 4.1.4절) |
| 3 | 다른 서비스 토큰이 통과 | aud 검사 없음 · 같은 키를 여러 서비스가 공유 | 클레임 | 페이로드 디코딩해 aud 와 서비스 식별자 대조 | aud 가 자기 값이 아니면 거부해야 함(RFC 8725 3.9절) |
| 4 | alg none · HS256 토큰이 통과 | 헤더 alg 를 그대로 믿는 검증 코드 | 헤더 | 라이브러리 호출부의 허용 알고리즘 인자 확인 | 허용 목록 밖 alg 거부 · none 기본 거부(RFC 7518 3.6절) |
| 5 | 로그아웃한 사용자가 계속 접근 | 거부 목록 없음 · exp 가 김 | 폐기 | exp − iat 값 · jti 거부 목록 조회 기록 | 노출 시간 = exp − 로그아웃 시각(그림 6) |
헤더부터 보는 까닭은 alg · kid 가 어떤 키 · 알고리즘으로 검증할지를 정하기 때문이고, 서명이 통과한 뒤에야 클레임 값을 믿을 수 있어 aud · exp 는 그다음에 본다. basenc 는 GNU coreutils 8.31 이후 명령이며, 채움이 없는 Base64url 은 길이를 4의 배수로 = 를 붙여야 풀린다.
8시험 대비
시험에서는 세 부분 구조와 등록 클레임을 묻는 정의 · 특징형(서버 세션과의 비교를 곁들임), alg none · 알고리즘 바꿔치기 · 탈취 토큰을 묻는 장애 · 보안 대응형이 나올 수 있다. 정의형은 그림 3 으로 서명 입력과 세 부분을 한 장에 보이고, 보안형은 그림 5 의 관문 순서에 공격마다 막히는 관문을 짝지어 쓴다. 접근 토큰을 발급하는 흐름(인가 코드 등)은 OAuth 2.0 이 맡고, 서명 수학은 전자서명에서 다룬다.
- 개요 — 정의(RFC 7519 · 2015) · JOSE 다섯 문서(JWS · JWE · JWK · JWA · JWT) · 자체 포함 토큰
- 구조 — 그림 3(헤더 · 페이로드 · 서명 · Base64url · 서명 입력) + 등록 클레임 7개 표
- 서명 알고리즘 — HS256(공유 키 256비트 이상) · RS256 · ES256 · none 의 구현 요구 수준 표(RFC 7518 3.1절)
- 검증 절차 — 그림 5 관문(형식 → alg 허용 목록 → 서명 → iss · aud → exp · nbf 오차)
- 위협과 대책 — alg none · RS256 → HS256 바꿔치기(CVE-2015-9235) · 약한 HMAC 키 · aud 누락 · RFC 8725 수칙
- 세션 비교 · 한계 — 비교표 + 그림 6 폐기 노출 구간 · 짧은 exp · jti 거부 목록 · 조회(RFC 7662)
꼭 쓸 키워드
JOSEJWS 압축 직렬화Base64url등록 클레임NumericDateHS256RS256alg none알고리즘 바꿔치기aud 검사jti 거부 목록RFC 8725
다른 답안과 차이를 내는 한 가지는 그림 5 처럼 공격마다 «어느 관문에서 막히는가»를 짝지어, alg 를 서버 설정이 정한다는 RFC 8725 3.1절 원칙을 구조로 보이는 것이다.
9오해와 사실
- 오해JWT 페이로드는 서명되어 있으니 남이 읽을 수 없다.사실서명된 JWT 의 페이로드는 Base64url 인코딩일 뿐이라 키 없이 누구나 풀어 읽으며, 내용을 감추려면 JWE 로 암호화해야 한다(RFC 7519 12절 · RFC 7516).
- 오해HS256 키는 기억하기 쉬운 비밀번호를 써도 된다.사실HS256 에는 해시 출력과 같은 256비트 이상의 키가 필요하고(RFC 7518 3.2절), 사람이 외우는 비밀번호를 HMAC 키로 바로 쓰면 오프라인 대입으로 풀린다(RFC 8725 2.2 · 3.5절).
- 오해로그아웃하면 발급된 JWT 도 함께 무효가 된다.사실검증 측이 저장소를 보지 않는 한 서명과 exp 가 맞는 토큰은 계속 통과하므로, 즉시 끊으려면 jti 거부 목록이나 토큰 조회를 따로 둔다(RFC 7519 4.1.7절 · RFC 7662).
10핵심 정리
| 구성 | 맡는 일 | 값 · 크기 | 검사 시점 | 실패하면 | 근거 |
|---|---|---|---|---|---|
| 헤더 alg | 알고리즘 지정 | HS256 · RS256 · ES256 | 서명 전 · 허용 목록 대조 | none · 바꿔치기 통과 | RFC 8725 3.1절 |
| 서명 | 헤더 · 페이로드 무결성 | HS256 = 32바이트 · 43자 | 클레임보다 먼저 | 변조 토큰 수락 | RFC 7515 5.2절 |
| 키 | 서명 생성 · 검증 | HMAC 256비트 이상 | 키 하나 = 알고리즘 하나 | 대입 공격 · 혼동 | RFC 7518 3.2절 |
| iss · aud | 발급자 · 받을 서비스 | URI · 서비스 식별자 | 서명 뒤 | 다른 서비스 토큰 수락 | RFC 8725 3.8 · 3.9절 |
| exp · nbf | 유효 구간 | NumericDate · 오차 몇 분 이내 | 마지막 | 만료 토큰 수락 | RFC 7519 4.1.4절 |
| jti | 토큰 식별 | 발급자 안 고유 값 | 거부 목록 조회 때 | 폐기 불가 | RFC 7519 4.1.7절 |
| Base64url | URL 안전 인코딩 | - · _ · 채움 없음 | 디코딩 | 엄격하지 않은 해석 | RFC 4648 5절 |
11참고 문헌
- 먼저 볼 문헌
- ★ RFC 7519 JSON Web Token (JWT) — 등록 클레임 일곱 개의 뜻과 JWT 검증 10단계를 원문으로 볼 때
- ★ RFC 8725 JSON Web Token Best Current Practices (BCP 225) — alg none · 알고리즘 바꿔치기 · 약한 HMAC 키 · aud 검사 같은 안전 수칙을 볼 때
- ★ RFC 7515 JSON Web Signature (JWS) — 압축 직렬화 세 부분과 서명 입력을 만드는 규칙을 볼 때
- ★ RFC 7518 JSON Web Algorithms (JWA) — alg 값별 구현 요구 수준과 HMAC 키 길이 규정을 볼 때
- 본문 근거
- RFC 7516 JSON Web Encryption (JWE) — IETF · 2015-05 ·
www.rfc-editor.org/rfc/rfc7516· 확인 2026-11-04 - RFC 7517 JSON Web Key (JWK) — IETF · 2015-05 ·
www.rfc-editor.org/rfc/rfc7517· 확인 2026-11-04 - RFC 4648 The Base16, Base32, and Base64 Data Encodings — IETF · 2006-10 ·
www.rfc-editor.org/rfc/rfc4648· 확인 2026-11-04 - RFC 6750 The OAuth 2.0 Authorization Framework: Bearer Token Usage — IETF · 2012-10 ·
www.rfc-editor.org/rfc/rfc6750· 확인 2026-11-04 - RFC 7662 OAuth 2.0 Token Introspection — IETF · 2015-10 ·
www.rfc-editor.org/rfc/rfc7662· 확인 2026-11-04 - RFC 6265 HTTP State Management Mechanism — IETF · 2011-04 ·
www.rfc-editor.org/rfc/rfc6265· 확인 2026-11-04 - JSON Web Token Best Current Practices (draft-ietf-oauth-rfc8725bis-10) — IETF · 2026-08 ·
datatracker.ietf.org/doc/draft-ietf-oauth-rfc8725bis/· 확인 2026-11-04 - CVE-2015-9235 jsonwebtoken verification bypass — MITRE · 2018-05 ·
www.cve.org/CVERecord?id=CVE-2015-9235· 확인 2026-11-04 - hmac — Keyed-Hashing for Message Authentication (Python 3.14 documentation) — Python Software Foundation · 2026-11 ·
docs.python.org/3/library/hmac.html· 확인 2026-11-04 - RFC 2606 Reserved Top Level DNS Names — IETF · 1999-06 ·
www.rfc-editor.org/rfc/rfc2606· 확인 2026-11-04