JWT 생성기 / 서명 도구
브라우저에서 JWT 토큰을 생성하고 서명(HS256, HS384, HS512). 헤더와 페이로드 JSON을 편집하고, 비밀 키를 설정하여 서명된 토큰을 복사. 데이터는 서버로 전송되지 않습니다.
- 브라우저에서 처리
- 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
- 무료 · 회원가입 불필요
WeChat으로 스캔하여 공유
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.
주요 사용 사례
- 로컬 개발: 백엔드 없이 API 엔드포인트나 인증 흐름 테스트용 토큰을 빠르게 생성.
- 디버깅: 헤더와 페이로드 JSON이 JWT에 어떻게 인코딩되는지 확인.
- 문서화: API 문서나 README 파일용 예시 토큰 생성.
- 학습: JWT의 구조와 서명 방식 이해.
예시: jjwt(Spring 프로젝트 등)에서 Base64로 디코딩하는 키
jjwt(0.13.0) README는 Base64로 인코딩된 비밀 키 문자열을 Keys.hmacShaKeyFor(Decoders.BASE64.decode(secretString))로 키로 바꾸라고 안내합니다. 설정 파일의 키 문자열을 이렇게 읽는 서버와 같은 토큰을 만들려면 이 도구에서도 Base64 모드를 골라야 합니다. 예시용으로 만든 키 문자열 하나로 두 모드를 비교해 보겠습니다.
c2VjcmV0LWtleS1mb3ItZGVtby1vbmx5
{"alg":"HS256","typ":"JWT"}
페이로드의 iat는 한국 시간 2026-10-09 오전 9시인 1791504000입니다. 한국 시간을 UTC로 착각해 계산하면 9시간 어긋납니다.
{"sub":"user-7","name":"홍길동","iat":1791504000}
Base64 모드에서는 32자가 24바이트로 디코딩되어, 서명은 하지만 다음 경고가 나옵니다. “키가 24바이트입니다. RFC 7518은 HS256에 32바이트 이상을 요구합니다. 서명은 하지만 이 키는 너무 짧습니다.”
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyLTciLCJuYW1lIjoi7ZmN6ri464-ZIiwiaWF0IjoxNzkxNTA0MDAwfQ.YbnfzHixwRLd1N9HaIci4A8Dag2pFLwyio2gh3uHmnY
jjwt도 같은 기준을 씁니다. Keys.java의 hmacShaKeyFor는 키가 256비트(32바이트)보다 짧으면 WeakKeyException을 던지도록 되어 있습니다. 이 키로 서버를 설정하면 그 호출에서 예외가 나므로 토큰을 만들 수도, 검증할 수도 없습니다.
같은 문자열을 UTF-8 모드로 두면 32바이트라 경고가 사라지지만, 서버가 쓰는 키 바이트와 달라 서명이 맞지 않습니다.
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyLTciLCJuYW1lIjoi7ZmN6ri464-ZIiwiaWF0IjoxNzkxNTA0MDAwfQ.zJjAxr_JLJ9Qwy0mpu6P8_eRxOx424uZsRY_T0yvTjU
경고가 없다고 모드가 맞는 것은 아닙니다. 서버가 키를 Base64로 디코딩하는지, 문자열 그대로 쓰는지 먼저 확인하세요.
예시: 32바이트 키와 한글 클레임
디코딩하면 32바이트가 되는 예시용 키(MDEyMzQ1Njc4OWFiY2RlZjAxMjM0NTY3ODlhYmNkZWY=)를 Base64 모드로 넣고, 헤더와 페이로드는 앞의 예시와 같게 둡니다.
{"alg":"HS256","typ":"JWT"}
{"sub":"user-7","name":"홍길동","iat":1791504000}
경고 없이 서명된 토큰입니다.
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyLTciLCJuYW1lIjoi7ZmN6ri464-ZIiwiaWF0IjoxNzkxNTA0MDAwfQ.sOnn_hJ30VRpulgHBMT4kcLd5YL6qnoJrn7ccryMmJU
페이로드 부분의 7ZmN6ri464-Z는 ‘홍길동’의 UTF-8 9바이트를 Base64URL로 바꾼 것으로, URL 안전 문자 -가 들어 있습니다. 도구는 iat·exp·nbf를 자동으로 넣거나 검사하지 않으니 필요한 시각은 직접 쓰세요(Unix 초, RFC 7519 §4.1).
예를 들어 HS256을 선택한 상태에서 헤더의 alg를 HS512로 바꾸면 오류를 표시하고 이전 토큰을 지웁니다.
키 고르기
HMAC 서명의 강도는 키에 달려 있습니다. 토큰 하나를 손에 넣은 사람은 서명이 맞을 때까지 후보 키를 오프라인으로 시험할 수 있습니다. RFC 8725 §3.5는 사람이 기억할 수 있는 비밀번호를 HMAC 키로 쓰면 안 된다고 합니다. 난수로 만든 키를 Base64 모드로 붙여 넣으세요.
openssl rand -base64 32 # HS256
openssl rand -base64 64 # HS512
제한
- HMAC 알고리즘(HS256, HS384, HS512)만 지원합니다. 개인 키가 필요한 RS256, ES256은 지원하지 않습니다.
- RFC 7518 §3.2는 키 길이를 해시 출력 이상으로 요구합니다(HS256은 32바이트, HS384는 48, HS512는 64). 더 짧은 비밀 키로도 서명은 하지만 바이트 수와 함께 경고를 표시합니다. 기본 예시
your-256-bit-secret는 19바이트라 경고가 나옵니다. - Base64 모드에서는 비밀 키를 먼저 디코딩합니다(표준·URL 안전 알파벳 모두 가능, 패딩 생략 가능, 공백 무시). 디코딩 결과가 0바이트(공백만 입력한 경우 등)이면 오류를 표시합니다.
- 페이로드는 JSON 객체여야 합니다. 배열·문자열·숫자·
null은 오류가 나고 토큰을 만들지 않습니다. RFC 7519 §7.2가 클레임을 JSON 객체로 정하고 있고, PyJWT 같은 라이브러리도 다른 형태는 거부하기 때문입니다. - 헤더와 페이로드는 앞뒤 공백만 지웁니다. UTF-8 모드에서는 비밀 키를 입력한 그대로 쓰므로 앞뒤 공백 하나로도 서명이 달라집니다(Base64 모드에서는 공백을 무시합니다).
- 헤더, 페이로드, UTF-8 모드의 비밀 키에 이모지의 반쪽(짝이 없는 UTF-16 서로게이트)이 있으면 UTF-8로 인코딩할 수 없어 위치를 알려 주고 오류로 처리합니다. Base64 모드에서는 유효하지 않은 Base64로 오류를 표시합니다.
- 운영 환경의 서명용 비밀 키는 어떤 웹 페이지에도 붙여 넣지 마세요. 테스트 전용 비밀 키를 쓰세요.
FAQ
JWT란 무엇인가요?
JSON Web Token(JWT)은 RFC 7519에서 정의한, URL에도 넣을 수 있는 간결한 토큰 형식입니다. 점으로 구분된 세 개의 Base64URL 부분(헤더, 페이로드, 서명)으로 이루어지며 인증과 정보 교환에 널리 쓰입니다.
비밀 키가 서버로 전송되나요?
아니요. 서명은 브라우저 내장 Web Crypto API(SubtleCrypto)로 하며, 헤더·페이로드·비밀 키는 어디에도 전송되지 않습니다. 도구는 이 값들을 저장하지 않고, 이 페이지용으로 저장된 값도 페이지를 열 때마다 지웁니다. 비밀 키를 다루는 페이지라서 Google Analytics와 AdSense를 불러오지 않습니다.
어떤 알고리즘을 선택해야 하나요?
HS256(HMAC-SHA256)이 가장 널리 쓰이며 대부분의 경우에 맞습니다. HS384와 HS512는 해시가 더 깁니다. 셋 다 대칭 알고리즘이라 서명과 검증에 같은 키를 씁니다. 어느 것을 고르든 RFC 7518은 키를 해시 출력 이상, 즉 32·48·64바이트 이상으로 하도록 요구합니다.
여기서 만든 토큰이 검증을 통과하는지 어떻게 확인하나요?
HMAC을 지원하는 JWT 라이브러리로, 같은 알고리즘과 같은 키 바이트를 써서 검증하세요. 예를 들어 PyJWT 2.10.1에서는 jwt.decode(token, key, algorithms=["HS256"])로 씁니다. Base64 모드의 키는 Base64 문자열이 아니라 디코딩한 바이트를 넘겨야 합니다. 이 사이트의 JWT 디코더는 클레임만 보여 주고 서명은 검증하지 않습니다.
Base64 비밀 키 형식 옵션은 무엇인가요?
일부 서비스는 Base64(또는 Base64URL)로 인코딩된 비밀 키를 줍니다. 그런 키라면 Base64를 선택하세요. 서명 전에 디코딩하므로 서명이 맞게 나옵니다. 키 길이는 디코딩한 뒤의 바이트 수로 따지며, Base64 44자는 32바이트입니다.
같은 클레임인데 라이브러리로 만든 토큰보다 긴 이유는 무엇인가요?
도구는 헤더와 페이로드를 입력한 그대로 서명하므로 줄바꿈과 들여쓰기도 들어갑니다(앞뒤 공백만 제거). 라이브러리는 보통 공백 없는 JSON을 만듭니다. 둘 다 유효하며 같은 키로 검증됩니다. 짧은 형태가 필요하면 {"alg":"HS256","typ":"JWT"}처럼 공백 없는 JSON을 붙여 넣으세요.