가이드

자주 나는 JWT 오류와 해결

JWT를 다룰 때 흔히 만나는 오류와 원인·해결 방법입니다.

invalid signature: 서명이 일치하지 않음 — 키가 틀렸거나 header.payload가 변조됨. 검증 키와 알고리즘을 확인하세요.
token expired: exp 시각이 지남 — 새 토큰을 재발급받거나 리프레시 토큰으로 갱신하세요.
malformed token: 점(.)으로 구분된 3부가 아니거나 base64url이 깨짐 — 앞뒤 공백·따옴표·'Bearer ' 접두사를 제거하세요.
algorithm mismatch: 기대한 alg와 다름(예: none, HS↔RS 혼동) — 허용 알고리즘을 고정하고 none을 거부하세요.

토큰을 직접 디코드해 보세요붙여넣기만 하면 헤더·페이로드·클레임이 바로 풀립니다.

디코더 열기

관련 항목

JWT란 무엇인가

JWT(JSON Web Token)는 당사자 간에 정보를 안전하게 주고받기 위한, 서명된 작은 JSON 토큰 형식입니다.

JWT의 3부 구조

모든 JWT는 header.payload.signature 세 부분으로 이루어지며, 각 부분은 base64url로 인코딩됩니다.

JWT 보안 체크리스트

JWT를 안전하게 쓰기 위한 핵심 원칙을 짧게 정리했습니다.

JWT vs 세션 인증

토큰(JWT) 기반 인증과 서버 세션(쿠키) 기반 인증의 차이와 선택 기준입니다.

액세스 토큰과 리프레시 토큰

짧게 사는 액세스 토큰과, 그것을 재발급하는 리프레시 토큰의 역할입니다.

JWS vs JWE (서명 vs 암호화)

JWT는 대개 서명된 JWS이며, 내용을 감추려면 암호화된 JWE를 씁니다. 둘의 차이입니다.

JWT 저장 위치: localStorage vs 쿠키

브라우저에서 JWT를 어디에 저장하느냐에 따라 XSS·CSRF 위험이 달라집니다.

커스텀 클레임 (공개 vs 비공개)

등록 클레임(iss·exp 등) 외에 직접 정의하는 클레임의 종류와 충돌 방지법입니다.

OAuth 2.0 · OpenID Connect에서의 JWT

JWT가 OAuth 2.0와 OpenID Connect에서 어떤 역할을 하는지 정리합니다.