JWT 디코더 및 인스펙터

브라우저에서 RFC 7519 JSON Web Token(JWT)을 디코딩, 검사 및 로컬 검증하세요.

업로드 없음회원가입 없음즉각적인 결과
RFC 7519 클레임 및 날짜HS256 / HS384 / HS512 검증100% 로컬 처리 • 서버 업로드 없음
JWT 디코딩
오프라인 엔진 준비 완료브라우저 내 100% 개인정보 보호 • 클라우드 업로드 없음
100% 비공개 • 서버 파일 업로드 제로

Utiliome의 무료 JWT 디코더 및 인스펙터를 사용하는 이유

철저한 개인정보 보호, 즉각적인 실행, 번거로움 없는 사용을 위해 처음부터 설계되었습니다. 구독, 결제, 회원가입이 필요 없습니다.

100% 클라이언트 사이드 토큰 검사

운영 환경의 OAuth2 액세스 토큰, OIDC ID 토큰 및 공유 서명 시크릿 키는 네트워크 전송 없이 오직 브라우저 메모리 내에서만 파싱됩니다.

Web Crypto 기반 HS256, HS384 및 HS512 검증

원시 UTF-8 또는 Base64URL로 인코딩된 시크릿 키를 사용하여 SubtleCrypto를 통해 로컬에서 RFC 7515 JWS HMAC-SHA2 서명을 재계산하고 검증합니다.

실시간 exp, nbf 및 iat 타임스탬프 감사

RFC 7519 유닉스 에포크 NumericDate 필드를 UTC 및 로컬 ISO 8601 타임스탬프로 변환하고 실시간 만료 및 활성화 카운트다운을 제공합니다.

엄격한 RFC 7519 및 Base64URL 표준 준수

멀티바이트 UTF-8을 완벽하게 지원하여 패딩 없는 Base64URL 세그먼트를 디코딩하고, Authorization Bearer 접두사를 제거하며 검증되지 않은 alg:none 헤더를 경고합니다.

Utiliome vs 기존 클라우드 대안

로컬 우선 WebAssembly 엔진과 기존 클라우드 도구를 비교해 보세요.

기능 Utiliome (로컬 브라우저) 기존 클라우드 변환기
100% 클라이언트 사이드 토큰 검사 운영 환경의 OAuth2 액세스 토큰, OIDC ID 토큰 및 공유 서명 시크릿 키는 네트워크 전송 없이 오직 브라우저 메모리 내에서만 파싱됩니다. 고급 설정이 없는 제한적인 기본 옵션
Web Crypto 기반 HS256, HS384 및 HS512 검증 원시 UTF-8 또는 Base64URL로 인코딩된 시크릿 키를 사용하여 SubtleCrypto를 통해 로컬에서 RFC 7515 JWS HMAC-SHA2 서명을 재계산하고 검증합니다. 별도 프로그램 설치나 수동 작업이 필요함
데이터 개인정보 보호 및 처리 100% 브라우저 로컬 처리 (서버 업로드 제로) 데이터를 외부 클라우드 서버로 전송 및 저장
이용 요금 및 회원가입 평생 100% 무료 · 회원가입 및 로그인 불필요 회원가입 강제 또는 유료 구독 결제 필요
작동 방식

간단한 3단계 JWT 디코더 및 인스펙터 사용법

소프트웨어 설치가 필요 없습니다. 웹 브라우저 내에서 모든 작업이 직접 실행됩니다.

1

JSON Web Token 붙여넣기 또는 업로드

점으로 구분된 3파트 JWT 문자열(Authorization Bearer 접두사 포함 여부 무관)을 붙여넣거나 로컬 .jwt 또는 .txt 파일을 인스펙터에 드롭합니다.

2

JOSE 헤더, 클레임 및 수명 주기 검사

포맷팅된 JSON 헤더와 페이로드를 exp, nbf, iat 클레임의 디코딩된 UTC 및 로컬 타임스탬프와 함께 검토하여 시간 오차(Clock-skew)나 만료 문제를 진단합니다.

3

로컬에서 HMAC 서명 검증

HS256, HS384 또는 HS512 공유 시크릿 키를 입력하여 Web Crypto API를 통해 브라우저에서 직접 토큰 무결성을 검증합니다.

JSON Web Token(JWT) 단계별 디코딩 및 서명 검증 방법

빠른 답변: 컴팩트 JWT를 두 개의 마침표 구분자를 기준으로 Base64URL 헤더, 페이로드, 서명 세그먼트로 분리합니다. 처음 두 세그먼트를 UTF-8 JSON으로 디코딩하여 클레임과 NumericDate 타임스탬프를 검사한 다음, 시크릿 키를 사용해 원시 ASCII header.payload 문자열에 대한 HMAC 다이제스트를 재계산하여 진위 여부를 확인합니다.

JWS Compact Serialization 형식으로 전송되는 RFC 7519 JSON Web Token은 마침표로 연결된 패딩 없는 세 개의 Base64URL 문자열인 <header>.<payload>.<signature>로 구성됩니다. Authorization: Bearer <token>과 같은 HTTP 헤더 값을 복사해 붙여넣으면, 디코더가 .으로 분리하기 전에 앞부분의 Bearer 스킴 접두사를 자동으로 제거합니다.

다음과 같은 표준 HS256 서명 컴팩트 토큰을 살펴보겠습니다.

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

1. 디코딩된 JOSE 보호 헤더

첫 번째 세그먼트(eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9)를 Base64URL로 디코딩하면 암호화 알고리즘과 미디어 타입을 설명하는 27바이트의 UTF-8 데이터가 나타납니다.

{
  "alg": "HS256",
  "typ": "JWT"
}

2. 디코딩된 클레임 페이로드 및 NumericDate 타임스탬프

두 번째 세그먼트(eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ)를 Base64URL로 디코딩하면 JSON 클레임 세트가 드러납니다.

{
  "sub": "1234567890",
  "name": "John Doe",
  "iat": 1516239022
}

여기서 iat(1516239022)는 UTC 기준 2018-01-18T01:30:22Z로 변환됩니다. 전체 수명 주기 경계가 포함된 프로덕션 액세스 토큰을 검사할 때, 인스펙터는 현재 시스템 시계를 기준으로 각 NumericDate 클레임을 평가합니다.

{
  "iss": "https://auth.example.com",
  "sub": "usr_9481",
  "iat": 1735689600,
  "nbf": 1735689600,
  "exp": 1735693200
}
  • iat (1735689600): 발급 시각 2025-01-01T00:00:00Z
  • nbf (1735689600): 유효 시작 시각 2025-01-01T00:00:00Z
  • exp (1735693200): 만료 시각 2025-01-01T01:00:00Z (정확히 3,600초 TTL)

3. 로컬 HMAC-SHA256 서명 검증

디코딩은 처음 두 세그먼트가 유효한 Base64URL 인코딩 JSON이라는 것만 증명할 뿐, 클레임이 위변조되지 않았음을 증명하지는 않습니다. 위의 첫 번째 예제에 대해 공유 시크릿 your-256-bit-secret을 입력하면, 검증기는 정확한 ASCII 서명 입력값(eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ)과 43자의 Base64URL 서명(SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c)을 crypto.subtle.verify("HMAC", key, signatureBytes, signingInputBytes)에 전달합니다. 디코딩된 JSON 페이로드에서 단 1비트라도 수정되면 예상되는 32바이트 MAC 태그가 변경되어 즉시 서명 불일치가 발생합니다.

RFC 7519 구조, Base64URL 인코딩 및 JWS 보안 핵심 사항

빠른 답변: JWS Compact Serialization 형식의 RFC 7519 JWT는 마침표로 구분된 패딩 없는 세 개의 Base64URL 세그먼트로 구성됩니다. 디코딩은 단지 Base64URL 인코딩을 읽을 수 있는 UTF-8 JSON으로 되돌릴 뿐이며, 무결성과 진위 여부는 명시적인 알고리즘 허용 목록에 따라 암호화 서명을 검증하는 것에 엄격히 의존합니다.

JOSE 사양(RFC 7515 JWS, RFC 7518 JWA, RFC 7519 JWT 및 RFC 8725 JWT 모범 사례)이 어떻게 상호작용하는지 이해하면 미묘한 인증 버그와 보안 취약점을 예방할 수 있습니다.

Base64URL 대 표준 Base64 (RFC 4648 Section 5)

표준 Base64는 URL 쿼리 구분자, 경로 세그먼트 및 쿠키 파서와 충돌하는 +, / 및 = 패딩 문자를 사용합니다. 따라서 JWS는 패딩이 없는 Base64URL 인코딩을 의무화합니다.

  • 인덱스 62는 + 대신 -(하이픈 마이너스)에 매핑됩니다.
  • 인덱스 63은 / 대신 _(밑줄)에 매핑됩니다.
  • 끝부분의 = 패딩 문자는 직렬화할 때 생략되며, 디코딩 시 (4 - (segment.length % 4)) % 4 공식을 통해 복원됩니다.
  • 디코딩된 바이트는 이름이나 다국어 클레임의 멀티바이트 유니코드(한글 등) 문자를 깨뜨리는 브라우저 atob() Latin-1 문자열이 아니라, TextDecoder("utf-8")를 통해 UTF-8 로 해석되어야 합니다. JWT가 아닌 일반 독립형 페이로드를 다룰 때는 Base64 인코더 및 디코더를 사용하세요.

JWA HMAC-SHA2 알고리즘 사양 (RFC 7518 Section 3.2)

  • HS256 (HMAC with SHA-256): 43자의 Base64URL 문자로 인코딩되는 256비트(32바이트) 인증 태그를 생성합니다. 최소 256비트(32바이트) 이상의 시크릿 키가 필요합니다.
  • HS384 (HMAC with SHA-384): 64자의 Base64URL 문자로 인코딩되는 384비트(48바이트) 인증 태그를 생성합니다. 최소 384비트(48바이트) 이상의 시크릿 키가 필요합니다.
  • HS512 (HMAC with SHA-512): 86자의 Base64URL 문자로 인코딩되는 512비트(64바이트) 인증 태그를 생성합니다. 최소 512비트(64바이트) 이상의 시크릿 키가 필요합니다.

NumericDate 정밀도 및 시간 오차 허용 범위(Clock-Skew Leeway)

RFC 7519 Section 2는 NumericDate를 윤초를 무시하고 1970-01-01T00:00:00Z UTC로부터 경과된 초 (밀리초 아님)를 나타내는 JSON 숫자 값으로 정의합니다. 표준을 준수하는 검증기는 current_time < exp + leeway(토큰이 만료되지 않음) 및 current_time >= nbf - leeway(토큰이 활성화됨) 조건을 만족하지 않으면 토큰을 거부합니다. 여기서 leeway는 분산 호스트 간의 NTP 시간 오차를 흡수하기 위해 일반적으로 30~60초로 설정됩니다.

치명적인 서명 검증 취약점 (RFC 8725)

  1. 보안되지 않은 alg: "none" 다운그레이드 공격: 헤더의 alg 필드를 동적으로 신뢰하지 마세요. 백엔드가 비어 있는 서명 세그먼트(header.payload.)와 함께 {"alg":"none","typ":"JWT"}를 허용하면, 공격자는 키 없이 임의의 관리자 클레임을 위조할 수 있습니다.
  2. 알고리즘 혼동 공격 (RS256에서 HS256으로 변조): 서버가 공개 RSA 키로 검증되는 비대칭 RS256 토큰을 예상하지만 JWT 라이브러리가 오직 수신된 alg 헤더에만 의존해 검증 로직을 분기하는 경우, 공격자는 alg를 HS256으로 바꾼 뒤 공개된 RSA 공개 키 바이트를 HMAC 시크릿 키처럼 사용하여 토큰에 대칭 서명을 할 수 있습니다.
  3. 프로덕션 환경의 검증되지 않은 decode() 호출: jwt.verify(token, secret, { algorithms: ["HS256"] }) 대신 jwt.decode(token) 같은 헬퍼 메서드를 호출하면 서명을 확인하지 않은 채 신뢰할 수 없는 사용자 입력을 그대로 파싱하게 됩니다.

JWT 디코더 vs JWT 생성기: 어떤 도구가 필요할까요?

빠른 답변: API 요청이나 ID 공급자(IdP)에서 캡처한 기존 토큰을 파싱하고 타임스탬프를 감사하며 서명을 검증하려면 'JWT 디코더 및 인스펙터'를 사용하세요. 테스트를 위해 커스텀 클레임을 작성하고 새로운 HS256, HS384 또는 HS512 토큰에 암호화 서명을 해야 할 때는 'JWT 생성기'를 사용하세요.

두 도구 모두 Web Crypto API를 사용하여 브라우저 내에서 100% 로컬로 실행되지만, 인증 디버깅 수명 주기에서 서로 반대되는 역할을 수행합니다. 이미 보유하고 있는 불투명한 토큰을 검사할 때는 JWT 디코더 및 인스펙터 를 사용하고, 처음부터 새로 서명된 테스트 토큰을 발급할 때는 JWT 생성기 로 전환하세요.

기능 JWT 디코더 및 인스펙터 (현재 도구) JWT 생성기
주요 워크플로 기존 JWT 파싱, 타임스탬프 감사 및 서명 검증 클레임 구성 및 새로운 JWT 서명 생성
입력 형식 컴팩트 토큰(<header>.<payload>.<signature>) + 선택적 시크릿 JOSE 헤더 옵션 + JSON 클레임 + HMAC 시크릿 키
생성되는 출력 포맷팅된 헤더/페이로드 JSON, 타임스탬프 감사, 서명 유효성 결과 서명된 3파트 구조의 컴팩트 Base64URL Bearer 토큰
Web Crypto 연산 SubtleCrypto.verify() (HMAC-SHA256/384/512) SubtleCrypto.sign() (HMAC-SHA256/384/512)
타임스탬프 처리 exp, nbf, iat를 UTC/로컬 날짜 및 카운트다운으로 변환 커스텀 TTL에 맞춰 유닉스 에포크 NumericDate 초 단위 값 생성
최적의 엔지니어링 활용 사례 401 Unauthorized 응답, OIDC 토큰 및 시간 오차 디버깅 로컬 API 인증 픽스처 생성, RBAC 테스트 및 만료 토큰 테스트

3파트 구조의 JOSE 토큰이 아닌 원시 Base64 또는 Base64URL 문자열(예: HTTP Basic Auth 자격 증명 또는 바이너리 데이터 블롭)로 작업하는 경우 Base64 인코더 및 디코더를 사용하세요.

FAQ

JWT 디코더 및 인스펙터 자주 묻는 질문 및 기술 가이드

Utiliome의 무료 온라인 jwt 디코더 사용에 관한 모든 정보.

프로덕션 JWT를 온라인 디코더에 붙여넣어도 안전한가요?

서버 기반 웹사이트에 활성 상태의 Bearer 토큰을 붙여넣으면 원격 액세스 로그, 애널리틱스 페이로드 또는 브라우저 기록 동기화를 통해 라이브 세션 자격 증명이 유출될 위험이 있습니다. 이 디코더는 네트워크 요청 없이 로컬 브라우저 탭 내부에서만 Base64URL 세그먼트를 파싱하고 Web Crypto HMAC 검증을 실행합니다. 그럼에도 불구하고 최소 권한 보안 원칙에 따라, 공유 시크릿이 신뢰할 수 있는 환경 외부에 노출된 적이 있다면 마스킹하거나 키를 교체(Rotate)하세요.

시크릿 키를 모르는 사람도 왜 내 JWT 페이로드를 디코딩할 수 있나요?

표준 3파트 JWT는 JSON Web Encryption 토큰(JWE, RFC 7516)이 아니라 JSON Web Signature(JWS, RFC 7515)이기 때문입니다. JWS에서 헤더와 페이로드는 URL에 안전한 전송을 위해 단순히 Base64URL로 인코딩된 UTF-8 JSON일 뿐입니다. 시크릿 키는 서명을 통해 무결성과 진위 여부를 보호하여 누구도 몰래 클레임을 수정할 수 없게 만들지만, 기밀성(암호화)은 전혀 제공하지 않습니다. JWS 클레임 내부에는 평문 비밀번호, API 시크릿 또는 암호화되지 않은 민감한 개인정보(PII)를 절대 저장하지 마세요.

시크릿 키가 정확한 것 같은데도 왜 서명 검증에 실패하나요?

HMAC 검증에서 거짓 음성(False-negative) 실패가 발생하는 원인은 대부분 다음 네 가지 중 하나입니다. (1) 키 인코딩 불일치: 발급자는 Base64/Base64URL 시크릿 문자열에서 디코딩된 원시 바이너리 바이트로 서명했으나 검증 시 리터럴 UTF-8 문자로 검증한 경우(또는 그 반대), (2) 시크릿이나 토큰을 복사할 때 앞뒤 공백이나 줄바꿈 문자가 실수로 포함된 경우, (3) 원본 Base64URL ASCII 세그먼트 그대로 검증하지 않고 보기 좋게 정렬(Pretty-print)된 JSON을 다시 인코딩하여 검증한 경우, (4) 비대칭 RS256 또는 ES256 토큰을 발급자의 공개 키가 아닌 HMAC 공유 시크릿으로 검증하려고 시도한 경우입니다.

왜 JWT exp 타임스탬프가 수만 년 뒤의 미래 날짜로 표시되나요?

RFC 7519 Section 2는 NumericDate를 유닉스 에포크 초 단위(예: 1767225600 같은 10자리 숫자)로 정의하는 반면, JavaScript의 Date.now()는 유닉스 에포크 밀리초 단위(예: 1767225600000 같은 13자리 숫자)를 반환합니다. 밀리초 값을 exp나 iat에 그대로 전달하면 에포크 오프셋이 1000배로 곱해져 2026년의 타임스탬프가 58000년 이후로 밀려나며, 결과적으로 토큰이 정상적으로 만료되지 않습니다.

JWT가 서명된 토큰(JWS)인지 암호화된 토큰(JWE)인지 어떻게 구분하나요?

마침표(.) 구분자의 개수를 세어 보고 디코딩된 JOSE 헤더를 확인하면 됩니다. 서명된 JWS는 세 개의 Base64URL 파트(헤더, 페이로드, 서명)를 구분하는 두 개의 마침표를 가지며, HS256, RS256 또는 ES256과 같은 alg 파라미터를 포함합니다. 반면 암호화된 RFC 7516 JWE는 다섯 개의 Base64URL 파트(헤더, 암호화된 키, 초기화 벡터, 암호문, 인증 태그)를 구분하는 네 개의 마침표를 가지며, A256GCM과 같은 enc 콘텐츠 암호화 파라미터를 포함합니다.