JWT 해독기

JWT의 해부학

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
.
eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkFsaWNlIiwiaWF0IjoxNjAwMDAwMDAwfQ
.
SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

각 세그먼트는 표준 Base64가 아닌 Base64URL 형식으로 인코딩되어 있습니다. 헤더는 {"alg":"HS256","typ":"JWT"}와 같은 JSON 형식이며, 페이로드는 {"sub":"1234567890","name":"Alice","iat":1600000000}와 같은 JSON 형식이고, 서명은 header.payload에 대한 HMAC 또는 RSA 서명입니다.

표준 클레임(RFC 7519)

지원되는 알고리즘

alg: none의 함정

초기 JWT 라이브러리는 "alg": "none" 토큰을 허용하고 이를 순진하게 유효한 것으로 받아들였습니다. 항상 다음을 지키세요.

• 애플리케이션이 허용하는 알고리즘을 화이트리스트로 관리하세요.
• alg: none을 무조건 거부하세요.
• 검증 코드가 RS256을 기대할 때 alg: HS256을 거부하세요(“알고리즘 혼동” 공격).

JWT가 아닌 것

• 암호화되어 있지 않습니다. 헤더와 페이로드는 base64로 인코딩되어 있을 뿐이어서 손쉽게 디코딩됩니다. JWE로 감싸지 않은 채 JWT에 비밀 정보를 넣지 마세요.
• 기본적으로 폐기할 수 없습니다. 한 번 발급된 JWT는 exp까지 유효합니다. 폐기하려면 블랙리스트, 또는 짧은 만료 시간과 리프레시 토큰을 함께 사용해야 합니다.
• 모든 용도에서 세션 쿠키를 대체하지는 못합니다. 서버 측에 저장하는 불투명 토큰이 더 간단하고 안전한 경우가 많습니다.

흔한 실수

• 헤더를 신뢰하기. kid와 alg는 토큰 자체에서 옵니다. 침해된 서버는 이를 임의로 설정할 수 있으므로 항상 고정된 목록과 대조해 검증하세요.
• nbf와 iat의 오차 무시하기. 시계 오차로 인해 iat > now가 발생할 수 있으므로 약간의 여유(30~60초)를 두세요.
• 전체 JWT 로깅하기. 페이로드에는 사용자 ID, 이메일, 권한 등 stdout에 남아서는 안 되는 PII가 들어 있는 경우가 많습니다.
• 약한 비밀로 HS256 사용하기. 16자 비밀은 몇 분 만에 무차별 대입으로 뚫립니다. 최소 256비트의 무작위 엔트로피를 사용하세요.