JWT 생성기 / 서명 도구

브라우저에서 JWT 토큰을 생성하고 서명(HS256, HS384, HS512). 헤더와 페이로드 JSON을 편집하고, 비밀 키를 설정하여 서명된 토큰을 복사. 데이터는 서버로 전송되지 않습니다.

  • 브라우저에서 처리
  • 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
  • 무료 · 회원가입 불필요
알고리즘
HS256, HS384 또는 HS512를 선택하면 JSON 객체 헤더의 alg가 갱신됩니다. 직접 편집한 alg는 선택한 알고리즘과 같아야 합니다. 수정을 멈춘 뒤 0.5초 후에 서명합니다.
유효한 JSON 객체를 입력하세요. iat, exp, nbf 등은 입력한 그대로 유지하며 타임스탬프를 추가하거나 검사하지 않습니다. 필드 수정을 멈춘 뒤 0.5초 후 새 서명을 생성합니다.
테스트용 비밀 키를 사용하세요. 길이는 UTF-8 인코딩 또는 Base64 디코딩 후 바이트 수입니다. HS256, HS384, HS512는 각각 최소 32, 48, 64바이트가 필요합니다. 더 짧아도 서명하며 경고를 표시합니다. UTF-8은 입력 텍스트를 키 바이트로 인코딩합니다. Base64는 먼저 디코딩하며 표준 및 URL 안전 알파벳을 지원합니다. 공백은 무시하고 패딩은 생략할 수 있습니다.
헤더
헤더를 펼쳐 JSON을 편집하세요. alg는 선택한 알고리즘과 같아야 합니다. 서명 전에 헤더와 페이로드 양끝의 공백을 제거하며 내부 줄바꿈과 들여쓰기는 유지합니다.
생성된 토큰 현재 토큰 전체를 복사합니다. 입력이 비었거나 유효하지 않으면 이전 토큰을 지웁니다. 도구 안에서 Ctrl+L(Mac은 ⌘+L)을 누르면 세 필드와 결과가 지워지고 알고리즘과 비밀 키 형식은 유지됩니다.

유효한 헤더와 페이로드 JSON, 비밀 키를 입력하면 서명된 토큰이 표시됩니다.

모든 처리는 브라우저에서 로컬로 수행됩니다.

예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.

주요 사용 사례

  • 로컬 개발: 백엔드 없이 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을 붙여 넣으세요.