실용 가이드

JWT 파서 — 사용 가이드 및 기술 원리

JSON Web Tokens 디코딩 및 분석

도구 열기

개요

JWT 파서는 JSON Web Tokens를 디코딩하고 분석하는 도구입니다. JWT는 당사자 간에 클레임을 안전하게 전송하기 위한 압축되고 자체 포함된 방법입니다. 구조: 세 부분이 점으로 구분됩니다 - 헤더.페이로드.서명. 헤더: 토큰 유형(JWT) 및 서명 알고리즘(HS256, RS256). 페이로드: 클레임(사용자 ID, 역할, 만료 등). 서명: 헤더 + 페이로드 + 비밀 키의 암호화 해시. 주요 기능: 자동 JWT 디코딩, 헤더 및 페이로드 파싱, 클레임 표시, 구문 강조, 만료 시간 검증, 토큰 구조 검증. 일반적인 클레임: iss(발급자), sub(주체/사용자 ID), aud(대상), exp(만료 시간), iat(발급 시간), nbf(이전 시간 아님). 사용 사례: JWT 디버깅(인증 문제 해결), 토큰 검사(클레임 및 만료 확인), API 개발(JWT 페이로드 설계), 보안 감사(토큰 클레임 검토), 교육(JWT 작동 방식 학습). 보안 참고: 이 파서는 디코딩만 수행하며 서명을 검증하지 않습니다. 서명 검증을 위해서는 비밀 키가 있는 백엔드가 필요합니다. JWT는 암호화되지 않습니다 - 민감한 데이터를 페이로드에 넣지 마세요. 이 도구는 브라우저에서 로컬로 작동하며 토큰을 서버에 업로드하지 않습니다.

핵심 개념

JWT란

JWT(JSON Web 토큰)는 RFC 7519에서 정의한 컴팩트하고 URL 안전한 토큰 형식으로, 당사자 간에 JSON 객체로 정보를 안전하게 전송하는 데 사용됩니다. JWT는 점으로 구분된 세 개의 Base64URL 인코딩 부분으로 구성됩니다: 헤더(알고리즘 및 토큰 유형), Payload(클레임/데이터), Signature(암호화 검증). JWT는 자체 포함되어 있어 모든 필요한 정보가 토큰 자체에 포함되어 있으므로 검증 중에 데이터베이스 쿼리가 필요하지 않습니다.

JWT 구조 및 인코딩

헤더는 서명 알고리즘(HS256, RS256, ES256 등) 및 토큰 유형(JWT)을 지정합니다. Payload에는 클레임이 포함됩니다: 등록된 클레임(iss, sub, aud, exp, nbf, iat, jti), 공개 클레임 및 개인 클레임. Signature는 헤더와 페이로드를 인코딩한 다음 키(HMAC) 또는 개인 키(RSA/ECDSA)로 서명하여 생성됩니다. 형식: base64UrlEncode(헤더) + "." + base64UrlEncode(payload) + "." + signature. 이 구조는 서버 측 세션 저장소 없이 상태 비저장 인증을 가능하게 합니다.

보안 및 검증

JWT 보안은 암호화 서명에 의존합니다. HMAC 알고리즘(HS256/384/512)은 발급자와 검증자 간에 공유되는 대칭 키를 사용합니다. RSA/ECDSA 알고리즘(RS256, ES256)은 비대칭 키 쌍을 사용합니다: 서명을 위한 개인 키, 검증을 위한 공개 키. 주요 보안 고려 사항: 페이로드를 신뢰하기 전에 서명을 검증하고, 만료 시간(exp 클레임)을 확인하고, 발급자(iss) 및 대상(aud)을 검증하고, HTTPS를 통해 전송하고, 페이로드에 민감한 데이터를 저장하지 마세요(base64 인코딩되며 암호화되지 않음), 적절한 키 순환을 구현하고, "없음" 알고리즘 취약점을 조심하세요.

인증 흐름 및 사용 시나리오

일반적인 JWT 인증 흐름: 사용자가 자격 증명으로 로그인하면 서버가 사용자 정보 및 만료 시간이 포함된 JWT를 검증하고 생성하며, 클라이언트가 JWT를 저장하고(localStorage/cookie), 클라이언트가 후속 요청의 인증 헤더에 JWT를 포함하고(Bearer 토큰), 서버가 데이터베이스 쿼리 없이 JWT 서명 및 클레임을 검증합니다. 사용 시나리오에는 SSO(Single Sign-On), 상태 비저장 API 인증, 마이크로서비스 인증, 모바일 앱 인증, OAuth 2.0 액세스 토큰, 연합 ID 및 서비스 간 정보 교환이 포함됩니다.

기능 특징

자동 디코딩

JWT 헤더 및 페이로드를 자동으로 디코딩

서명 검증

키를 사용하여 JWT 서명 검증

상세 표시

모든 JWT 구성 요소를 명확하게 표시

클레임 분석

JWT 클레임 및 만료 시간 분석

자주 묻는 질문

JWT란 무엇인가요?

JWT(JSON Web 토큰)는 당사자 간에 정보를 안전하게 전송하기 위한 개방형 표준(RFC 7519)입니다. 세 부분으로 구성됩니다: 헤더(알고리즘 및 토큰 유형), 페이로드(클레임/데이터), 서명(무결성 검증). 점으로 구분됩니다: 헤더.payload.signature. 각 부분은 Base64URL로 인코딩됩니다. 인증, 정보 교환, API 액세스에 사용됩니다. 상태 비저장이며 자체 포함됩니다.

JWT는 어떻게 작동하나요?

JWT 워크플로우: 1) 사용자 로그인 → 서버가 JWT 생성 및 서명. 2) 클라이언트가 토큰 저장(로컬 저장소, 쿠키). 3) 클라이언트가 요청에 토큰 포함(인증: Bearer 토큰). 4) 서버가 서명 검증 및 클레임 추출. 5) 유효하면 액세스 허용. 서명은 무단 수정을 방지합니다. 만료(exp 클레임)는 토큰 수명을 제한합니다.

JWT는 암호화되나요?

아니요, JWT는 기본적으로 암호화되지 않습니다 - 인코딩만 됩니다(Base64URL). 누구나 헤더와 페이로드를 디코딩할 수 있습니다. 서명은 무결성을 보장하지만 기밀성은 보장하지 않습니다. 민감한 데이터를 페이로드에 넣지 마세요(비밀번호, 신용 카드). 암호화된 JWT에는 JWE(JSON Web Encryption)를 사용하세요. 항상 HTTPS를 통해 JWT를 전송하세요.

JWT 서명을 어떻게 검증하나요?

서명 검증: 1) 헤더와 페이로드를 다시 인코딩합니다. 2) 비밀 키(HMAC) 또는 공개 키(RSA)로 서명합니다. 3) 토큰의 서명과 비교합니다. 일치하면 유효합니다. 이 파서는 디코딩만 수행합니다 - 서명 검증을 위해서는 백엔드가 필요합니다(비밀 키 필요). 서명 알고리즘: HS256(HMAC), RS256(RSA), ES256(ECDSA).

JWT 파서를 왜 사용하나요?

사용 사례: JWT 디버깅(토큰 내용 검사), 클레임 검증(사용자 ID, 역할, 만료 확인), 인증 문제 해결(토큰 구조 이해), API 개발(JWT 페이로드 설계), 보안 감사(토큰 클레임 검토), 교육(JWT 작동 방식 학습). 파서는 서명을 검증하지 않고 토큰을 디코딩합니다 - 개발 및 디버깅에 사용하세요.

관련 문서

JWT 파서

도구를 열어 이 기능을 사용해 보세요.

도구 열기