가이드

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

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

등록 클레임: RFC 7519가 정한 표준(iss·sub·aud·exp·nbf·iat·jti). 의미가 고정돼 상호운용됩니다.
공개 클레임: IANA에 등록하거나 충돌 없는 이름으로 공개적으로 쓰는 클레임입니다.
비공개 클레임: 특정 당사자끼리 합의해 쓰는 사설 클레임(role·plan 등) — 충돌 위험이 있으니 짧고 흔한 이름은 피하세요.
팁: 커스텀 클레임에도 민감정보를 넣지 말고, 충돌을 피하려 URI 네임스페이스(예: https://myapp.com/roles)를 쓰기도 합니다.

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

디코더 열기

관련 항목

JWT란 무엇인가

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

JWT의 3부 구조

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

JWT 보안 체크리스트

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

JWT vs 세션 인증

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

자주 나는 JWT 오류와 해결

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

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

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

JWS vs JWE (서명 vs 암호화)

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

JWT 저장 위치: localStorage vs 쿠키

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

OAuth 2.0 · OpenID Connect에서의 JWT

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