IT › 보안 › 암호 · 인증 › 인증 · 인가 프로토콜

JWTJSON 웹 토큰 · JSON Web Token

두 당사자 사이에 넘길 클레임(주장)을 JSON 객체로 적고 Base64url 로 압축해, JWS 서명 · MAC 이나 JWE 암호화로 보호하는 URL 안전 토큰 형식이다(RFC 7519).

1요약

  1. JWT 는 IETF JOSE 문서 묶음(2015-05)의 RFC 7519 가 정한 토큰 형식으로, 점 두 개로 나뉜 헤더 · 페이로드 · 서명 세 부분이 HTTP Authorization: Bearer 헤더에 실려 OAuth 2.0 접근 토큰 · OpenID Connect ID 토큰으로 쓰인다.
  2. 검증 측이 토큰 헤더의 alg 를 그대로 믿으면 none 이나 HS256 바꿔치기로 서명 검사가 통째로 빠지며(RFC 8725 2.1절), Node.js jsonwebtoken 4.2.2 이전 판의 CVE-2015-9235 가 그 사례다.
  3. 「토큰이 거부된다」는 어느 검사에서 멈췄는가로 가른다 — 서명 단계면 키 · 알고리즘 문제, 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쉽게 이해하기 — 도장 찍힌 투명 출입증

행사장 안내 데스크가 방문객 이름 · 들어갈 구역 · 끝나는 시각을 투명 출입증에 적고, 데스크만 가진 도장을 찍어 준다. 방문객이 출입문에 출입증을 내밀면 직원은 데스크에 전화하지 않고 도장과 시각만 보고 들여보낸다. 옆 사람도 출입증 글씨는 다 읽을 수 있고, 누가 글씨를 고치면 도장 무늬가 맞지 않아 걸린다. 다만 잃어버린 출입증은 적힌 시각이 지날 때까지 남이 써도 막기 어렵다.

안내 데스크 인증 서버 데스크만 가진 도장 서명 키 32바이트 방문객 클라이언트 투명 출입증 JWT 출입문 API 서버 끝 시각 확인 exp 1 2 3 데스크에 묻지 않고 확인 도장 무늬 · 시각만 본다 4 옆 사람도 글씨를 읽음 Base64url ≠ 암호화 비밀번호 · 개인 정보는 적지 않음 5 글씨를 고친 출입증 서명 불일치 · 거부 도장은 데스크만 다시 찍는다 6 잃어버린 출입증 exp 까지 유효 · 폐기 어려움 그래서 끝 시각을 짧게 적는다

그림 1 · 데스크가 도장 찍어 준 출입증은 출입문이 데스크에 묻지 않고 확인하며, 글씨는 누구나 읽고 고친 글씨는 도장에 걸리지만 잃어버린 출입증은 시각이 끝날 때까지 쓰인다.

도장 찍기데스크가 이름 · 구역 · 끝 시각을 적고 도장
출입증 받기방문객이 투명 출입증을 들고 감
출입문 확인직원이 도장 무늬 · 시각만 봄
누구나 읽기글씨는 감추지 않음
고친 증 거부도장 무늬가 맞지 않음
시각 만료끝 시각이 지나면 쓸 수 없음
비유 — 투명 출입증 세 칸 실제 — JWT 세 부분 종류 칸 어떤 도장을 찍었는지 내용 칸 이름 · 구역 · 끝 시각 도장 칸 위 두 칸 글씨에 맞춘 무늬 헤더 alg HS256 · typ JWT → 누구나 읽음 페이로드 sub · aud · exp 클레임 → 고치면 서명이 깨짐 서명 HMAC-SHA256(키, 헤더.페이로드) → 키를 가진 쪽만 만듦 키 = 데스크만 가진 도장

그림 2 · 출입증의 종류 · 내용 · 도장 세 칸이 JWT 의 헤더 · 페이로드 · 서명이고, 읽기는 누구나 하지만 도장은 키를 가진 쪽만 만든다.

비유 속 역할실제 이름실제로 하는 일
안내 데스크발급자(인증 서버 · iss)사용자를 확인하고 클레임을 적어 서명한다
데스크만 가진 도장서명 키 · algHS256 이면 공유 비밀 키, RS256 · ES256 이면 개인키로 서명한다
투명 출입증JWT(JWS 압축 직렬화)헤더 · 페이로드 · 서명을 점으로 이은 문자열 하나
이름 · 구역sub · aud 클레임누구의 토큰인지 · 어느 서비스가 받을 토큰인지
끝 시각exp · nbf · iatNumericDate(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절).

JWT 243자 = 헤더 . 페이로드 . 서명 헤더 36자 . 페이로드(클레임 집합) 162자 . 서명 43자 JOSE 헤더(27바이트) alg: HS256 · typ: JWT 클레임 집합(121바이트) iss: https://auth.example.com sub: u-1042 aud: attendance-api iat: 1793750400 exp: 1793751300 (iat + 900) jti: 7f3a9c MAC 값 32바이트 = 256비트 출력 서명 입력 = ASCII(BASE64URL(헤더) . BASE64URL(페이로드)) HMAC-SHA256 공유 키 32바이트 규칙(알고리즘) 클레임 무결성 값 키 상자 너비 = Base64url 글자 수 비례 · 키 · 클레임 값 = 동작 절 사례 값

그림 3 · 서명 입력은 «헤더.페이로드» 문자열 그 자체이고, 여기에 키 32바이트로 HMAC-SHA256 을 돌린 32바이트가 셋째 부분이 된다.

요소크기 · 값역할근거
algHS256(필수 구현) · RS256 · ES256 · none서명 · MAC 알고리즘 지정RFC 7518 3.1절
typJWT 권장 · 선택다른 JOSE 객체와 구분RFC 7519 5.1절
iss · sub문자열 · URI발급자 · 주체(사용자)4.1.1 · 4.1.2절
aud문자열 또는 배열받을 서비스 — 자기 값이 없으면 거부4.1.3절
exp · nbf · iatNumericDate(초)유효 구간 · 발급 시각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)이다.

  1. 인증 서버가 클레임 6개를 121바이트 JSON 으로 적는다 — iat 1793750400 · exp 1793751300(900초 뒤) · aud attendance-api(RFC 7519 4.1절).
  2. 헤더 27바이트 · 클레임 121바이트를 Base64url 로 바꿔 36자 · 162자를 얻고, 그 둘을 점으로 이은 서명 입력에 HMAC-SHA256 을 돌려 32바이트 → 43자 서명을 붙여 243자 토큰을 앱에 준다(RFC 7515 5.1절).
  3. 300초 뒤 앱이 GET /v1/attendance 에 Authorization: Bearer eyJhbGciOiJIUzI1NiIs… 로 토큰을 싣는다(RFC 6750 2.1절).
  4. 근태 API 는 인증 서버에 묻지 않고 alg 가 허용 목록 {HS256} 안인지 → hmac.compare_digest 로 서명 → iss · aud → exp 를 차례로 확인해 수락한다.
  5. 공격자가 페이로드의 sub 를 u-0001 로 바꾸고 원래 서명을 붙여 보내면, 다시 계산한 MAC 이 달라 서명 단계에서 거부된다.
  6. 헤더를 {"alg":"none","typ":"JWT"}(eyJhbGciOiJub25lIiwidHlwIjoiSldUIn0)로 바꾸고 서명을 비우면, alg 가 허용 목록 밖이라 서명 계산 전에 거부된다(RFC 7518 3.6절 · RFC 8725 2.1절).
  7. 같은 토큰을 aud 가 payroll-api 인 급여 API 에 내면 aud 단계에서, exp 보다 61초 늦게 내면 허용 오차 60초를 넘어 exp 단계에서 거부된다(RFC 7519 4.1.4절 · RFC 8725 3.9절).
근태 앱 인증 서버 근태 API 로그인 성공 1 클레임 6개 · exp = iat + 900 2 JWT 243자(HS256) 3 +300초 · GET · Bearer 토큰 4 alg · 서명 · iss · aud · exp 인증 서버에 묻지 않음 200 OK · 근태 기록 5 sub → u-0001 · 옛 서명 401 — 서명 불일치 6 alg none · 서명 빈칸 401 — 허용 목록 밖 7 급여 API(aud payroll-api) → 401 exp + 61초 → 401

그림 4 · 근태 API 는 인증 서버에 묻지 않고 혼자 검증하며, 변조 · alg none · 다른 aud · 만료 토큰은 서로 다른 단계에서 401 로 끝난다.

검증 관문 — 앞 관문을 통과해야 다음을 본다 형식 점 2 · 세 부분 alg 허용 목록 설정 = {HS256} 서명 재계산 · 비교 iss · aud 발급자 · 대상 exp · nbf 오차 60초 수락 6 alg none 서명 계산 전 5 sub 변조 MAC 불일치 7 급여 API aud 불일치 7 +61초 만료 헤더의 alg 는 «주장»일 뿐 — 검증 측은 자기 설정 목록으로 고르고, 키 하나에 알고리즘 하나만 묶는다 근거 = RFC 8725 3.1절 · 같은 관문이 없으면 RS256 공개키를 HMAC 키로 쓰는 바꿔치기가 통한다(2.1절)

그림 5 · 검증은 정해진 순서의 관문이고, 사례의 네 가지 거부는 서로 다른 관문에서 멈춘다 — 알고리즘은 토큰이 아니라 서버 설정이 정한다.

🔑 서명이 맞아도 «이 서비스용 토큰»은 아니다 — 서명은 발급자를, aud 는 받을 서비스를 증명하므로 둘 다 통과해야 수락한다(RFC 8725 3.9절).

6비교 — 서버 세션 쿠키 · 불투명 토큰 조회

기준서버 세션 쿠키JWT(자체 포함 토큰)불투명 토큰 + 조회
상태를 든 곳서버 세션 저장소토큰 안 클레임인가 서버 저장소
요청마다 저장소 조회1회(세션 표)0회 — 키만 있으면 됨1회(RFC 7662 조회)
즉시 폐기세션 삭제로 다음 요청부터exp 까지 유효 · 거부 목록이 있어야 함조회 응답 active: false 로 즉시
크기세션 ID 수십 바이트사례 243자 · 클레임 늘면 커짐수십 바이트
도메인 · 회사 넘기같은 사이트 쿠키(RFC 6265)aud 만 맞으면 어디서나조회 권한이 있는 서버만
탈취 대비HttpOnly · Secure 속성짧은 exp · 저장 위치 · 송신자 제한짧은 수명 · 조회에서 끊기
09:05 로그아웃 뒤 같은 자격 증명이 통과하는 시간 한국 시각 · 사례 iat 09:00 · exp 09:15 09:00 09:05 09:15 = exp 로그아웃 서버 세션 쿠키 세션 삭제 → 거부 JWT(거부 목록 없음) 10분 더 수락(600초) JWT + jti 거부 목록 jti 7f3a9c 거부 · 09:15 에 목록에서 지움 수락 거부 굵은 테두리 = 로그아웃 뒤에도 남는 노출 구간

그림 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절)
4alg 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 이 맡고, 서명 수학은 전자서명에서 다룬다.

답안 목차
  1. 개요 — 정의(RFC 7519 · 2015) · JOSE 다섯 문서(JWS · JWE · JWK · JWA · JWT) · 자체 포함 토큰
  2. 구조 — 그림 3(헤더 · 페이로드 · 서명 · Base64url · 서명 입력) + 등록 클레임 7개 표
  3. 서명 알고리즘 — HS256(공유 키 256비트 이상) · RS256 · ES256 · none 의 구현 요구 수준 표(RFC 7518 3.1절)
  4. 검증 절차 — 그림 5 관문(형식 → alg 허용 목록 → 서명 → iss · aud → exp · nbf 오차)
  5. 위협과 대책 — alg none · RS256 → HS256 바꿔치기(CVE-2015-9235) · 약한 HMAC 키 · aud 누락 · RFC 8725 수칙
  6. 세션 비교 · 한계 — 비교표 + 그림 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절
Base64urlURL 안전 인코딩- · _ · 채움 없음디코딩엄격하지 않은 해석RFC 4648 5절

11참고 문헌

  1. 먼저 볼 문헌
  2. ★ RFC 7519 JSON Web Token (JWT) — 등록 클레임 일곱 개의 뜻과 JWT 검증 10단계를 원문으로 볼 때
    IETF · 2015-05 · www.rfc-editor.org/rfc/rfc7519 · 확인 2026-11-04
  3. ★ RFC 8725 JSON Web Token Best Current Practices (BCP 225) — alg none · 알고리즘 바꿔치기 · 약한 HMAC 키 · aud 검사 같은 안전 수칙을 볼 때
    IETF · 2020-02 · www.rfc-editor.org/rfc/rfc8725 · 확인 2026-11-04
  4. ★ RFC 7515 JSON Web Signature (JWS) — 압축 직렬화 세 부분과 서명 입력을 만드는 규칙을 볼 때
    IETF · 2015-05 · www.rfc-editor.org/rfc/rfc7515 · 확인 2026-11-04
  5. ★ RFC 7518 JSON Web Algorithms (JWA) — alg 값별 구현 요구 수준과 HMAC 키 길이 규정을 볼 때
    IETF · 2015-05 · www.rfc-editor.org/rfc/rfc7518 · 확인 2026-11-04
  6. 본문 근거
  7. RFC 7516 JSON Web Encryption (JWE) — IETF · 2015-05 · www.rfc-editor.org/rfc/rfc7516 · 확인 2026-11-04
  8. RFC 7517 JSON Web Key (JWK) — IETF · 2015-05 · www.rfc-editor.org/rfc/rfc7517 · 확인 2026-11-04
  9. RFC 4648 The Base16, Base32, and Base64 Data Encodings — IETF · 2006-10 · www.rfc-editor.org/rfc/rfc4648 · 확인 2026-11-04
  10. RFC 6750 The OAuth 2.0 Authorization Framework: Bearer Token Usage — IETF · 2012-10 · www.rfc-editor.org/rfc/rfc6750 · 확인 2026-11-04
  11. RFC 7662 OAuth 2.0 Token Introspection — IETF · 2015-10 · www.rfc-editor.org/rfc/rfc7662 · 확인 2026-11-04
  12. RFC 6265 HTTP State Management Mechanism — IETF · 2011-04 · www.rfc-editor.org/rfc/rfc6265 · 확인 2026-11-04
  13. 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
  14. CVE-2015-9235 jsonwebtoken verification bypass — MITRE · 2018-05 · www.cve.org/CVERecord?id=CVE-2015-9235 · 확인 2026-11-04
  15. 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
  16. RFC 2606 Reserved Top Level DNS Names — IETF · 1999-06 · www.rfc-editor.org/rfc/rfc2606 · 확인 2026-11-04