JWT 디코더

JWT(JSON Web Token)를 디코딩해서 내용을 확인합니다.

사용 예시

로그인 토큰에 어떤 정보가 들어있는지 확인하기

서버가 내려준 JWT 액세스 토큰에 어떤 클레임(사용자 ID, 권한 등)이 담겨 있는지 궁금하다면? 토큰을 붙여넣으면 헤더와 페이로드가 읽기 좋은 JSON으로 바로 보입니다.

토큰 만료 시간 확인하기

로그인이 자꾸 풀리는 문제를 디버깅 중이라면? exp 클레임을 사람이 읽을 수 있는 날짜/시간으로 바로 보여주고, 이미 만료됐는지도 배지로 알려줍니다.

서명 알고리즘 확인하기

토큰이 HS256인지 RS256인지 헷갈린다면? 헤더의 alg 값을 요약 영역에 바로 표시해줍니다.

팀원에게 디코딩 결과를 그대로 공유하기

동료에게 "이 토큰 좀 봐줘"라고 말하고 싶다면? '공유 링크 복사' 버튼을 누르면 지금 입력한 토큰이 담긴 링크가 복사되고, 그 링크를 연 사람은 같은 토큰이 바로 디코딩된 화면을 보게 됩니다.

서드파티 API의 OAuth 액세스 토큰 들여다보기

OAuth 제공자가 알 수 없는 문자열처럼 보이는 액세스 토큰을 줬는데, 사실 JWT라면? 붙여넣기만 하면 코드 한 줄 작성하지 않고도 scope, audience(aud), issuer(iss) 클레임을 확인할 수 있습니다.

커스텀 클레임이 토큰에 제대로 들어갔는지 확인하기

토큰 발급 로직에 "role": "admin"이나 "tenantId" 같은 커스텀 클레임을 막 추가했다면? 방금 발급받은 토큰을 붙여넣어 해당 클레임이 실제로 존재하고 이름이 정확한지, 인가 로직을 연결하기 전에 확인하세요.

시간차를 두고 발급된 두 토큰 비교하기

갱신된 토큰이 이전 토큰과 다르게 동작하는 이유를 찾고 있다면? 두 토큰을 나란히 디코딩해서 페이로드를 비교하면 정확히 어떤 클레임이 바뀌었는지 바로 알 수 있습니다.

버그 리포트에 붙여넣기 전에 토큰 한 번 더 확인하기

GitHub 이슈나 슬랙 스레드에 JWT를 붙여넣기 직전이라면? 먼저 디코딩해서 안에 정확히 무엇이 들어있는지 확인하고, 공유하기 전에 이메일이나 내부 ID 같은 민감한 클레임을 지워두세요.

빠른 참고표

Common JWT header segments

Base64URL헤더 (Header)
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9{"alg":"HS256","typ":"JWT"}
eyJhbGciOiJIUzM4NCIsInR5cCI6IkpXVCJ9{"alg":"HS384","typ":"JWT"}
eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9{"alg":"HS512","typ":"JWT"}
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9{"alg":"RS256","typ":"JWT"}
eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9{"alg":"RS512","typ":"JWT"}
eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9{"alg":"ES256","typ":"JWT"}
eyJhbGciOiJQUzI1NiIsInR5cCI6IkpXVCJ9{"alg":"PS256","typ":"JWT"}
eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9{"alg":"EdDSA","typ":"JWT"}
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9{"typ":"JWT","alg":"HS256"}
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9{"typ":"JWT","alg":"HS512"}
eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9{"typ":"JWT","alg":"RS256"}
eyJ0eXAiOiJKV1QiLCJhbGciOiJFUzI1NiJ9{"typ":"JWT","alg":"ES256"}

자주 묻는 질문

이 도구가 서명을 검증하나요?

아니요. 서명을 검증하려면 발급자만 아는 비밀 키(또는 공개 키)가 필요한데, 그 값을 여기 입력하는 것 자체가 보안상 위험합니다. 이 도구는 헤더와 페이로드를 디코딩해서 내용만 보여줄 뿐, 서명이 유효한지는 확인하지 않습니다.

공유 링크에는 토큰이 어떻게 담기나요?

'공유 링크 복사'를 누르면 주소 뒤에 ?jwt=토큰값이 붙은 링크가 복사됩니다. 즉 토큰 자체가 URL에 그대로 노출됩니다. 그 링크를 열면 저장돼 있던 값 대신 이 토큰이 바로 디코딩되어 보이고, 로컬 저장소도 이 값으로 갱신됩니다. 채팅이나 메일로 링크를 공유하면 그 기록에 토큰이 그대로 남을 수 있으니, 실제 서비스에서 쓰이는 유효한 토큰이라면 공유 전에 한 번 더 생각해보는 것이 좋습니다.

붙여넣은 토큰이 서버로 전송되나요?

아니요. 모든 디코딩은 브라우저 안에서만 이뤄지고 서버로는 전송되지 않습니다. 다시 방문했을 때 이어서 볼 수 있도록 입력한 토큰은 브라우저의 로컬 저장소(localStorage)에만 저장되며, 다른 기기나 브라우저와는 공유되지 않습니다. 입력창을 지우면 저장된 내용도 함께 지워집니다. 다만 실제 서비스에서 쓰이는 토큰을 아무 웹사이트에나 붙여넣는 습관은 피하는 것이 좋습니다.

exp, iat, nbf는 무엇인가요?

JWT에서 자주 쓰이는 표준 클레임입니다. iat는 발급 시간, exp는 만료 시간, nbf는 그 시간 이전에는 사용할 수 없다는 뜻의 적용 시작 시간입니다. 모두 1970년 1월 1일부터 흐른 초를 나타내는 유닉스 타임스탬프로 저장되어 있어서, 이 도구가 사람이 읽기 쉬운 날짜로 변환해서 보여줍니다.

형식이 잘못됐다는 오류가 뜹니다.

JWT는 점(.)으로 구분된 3부분(헤더.페이로드.서명)으로 이루어져야 합니다. 앞뒤에 공백이 섞여 들어갔거나, 토큰이 잘려서 복사됐는지 확인해보세요.

JWT의 페이로드는 암호화되어 있나요?

아니요 — JWT에 대해 가장 흔한 오해 중 하나입니다. RFC 7519에 따르면 헤더와 페이로드는 base64url로 인코딩되어 있을 뿐 암호화된 것이 아닙니다. base64url은 되돌릴 수 있는 인코딩이지 암호가 아니므로, 토큰을 손에 넣은 사람이라면 누구나 비밀 키 없이도 모든 클레임을 디코딩해서 읽을 수 있습니다. 이 도구가 하는 일도 바로 그것입니다. 서명은 발급자가 토큰이 변조되지 않았고 실제로 자신이 발급했음을 검증할 수 있게 해줄 뿐, 페이로드 내용을 숨기지는 않습니다. 토큰에 민감한 데이터가 담겨 있다면 그 내용은 읽을 수 있는 평문이라고 간주하고, 비밀번호나 카드 번호 원본처럼 진짜 비밀 정보는 클레임에 절대 넣지 마세요.

base64url이 정확히 무엇이고, 일반 base64와 어떻게 다른가요?

base64url은 임의의 바이트를 텍스트로 인코딩한다는 아이디어는 표준 base64와 같지만, URL에서 안전하지 않은 두 문자를 바꿉니다. +는 -로, /는 _로 바뀌고, 끝의 = 패딩은 보통 생략됩니다. JWT가 헤더와 페이로드에 base64url을 쓰는 이유는, 결과 토큰이 추가 이스케이프 없이도 URL, HTTP 헤더, 쿠키 안에서 안전하게 이동해야 하기 때문입니다.

이 도구가 보여주는 내용으로 토큰을 위조할 수 있나요?

디코딩된 헤더와 페이로드를 보는 것만으로는 유효한 토큰을 위조할 수 없습니다. 서버가 받아들일 토큰을 만들려면 발급자의 비밀 키(HS256류 알고리즘의 경우)나 개인 키(RS256/ES256류 알고리즘의 경우)로 다시 서명해야 하는데, 이 도구는 그런 정보를 요구하지도 접근하지도 않습니다. 디코딩된 JSON을 직접 수정하고 다시 인코딩하면 페이로드는 바뀌지만 서명이 무효화되므로, 제대로 구현된 서버라면 그 토큰을 거부합니다.

서명 부분은 왜 JSON이 아니라 무작위 문자처럼 보이나요?

헤더나 페이로드와 달리 서명은 인코딩된 JSON이 아니라, 헤더에 명시된 알고리즘(예: HMAC-SHA256이나 RSA-SHA256)으로 헤더와 페이로드를 서명한 결과인 원시 암호학적 출력값입니다. 그래서 더 디코딩해도 읽을 수 있는 텍스트가 나오지 않는 것이며, 이 도구는 이미 base64url 문자열인 그대로 보여줄 뿐입니다.