JWT 디코더

JWT 디코더란?

JWT 디코더는 JSON Web Token(JWT)을 분석하여 그 내부 구조와 데이터를 확인할 수 있는 개발자 도구입니다. JWT는 웹 애플리케이션에서 사용자 인증과 정보 교환에 널리 사용되는 표준(RFC 7519)으로, 이 도구를 통해 토큰의 헤더, 페이로드, 서명을 쉽게 분석할 수 있습니다.

주요 기능

• 실시간 디코딩: JWT 토큰을 입력하면 즉시 헤더와 페이로드가 JSON 형식으로 표시됩니다.
• 서명 검증: HMAC 알고리즘(HS256, HS384, HS512)으로 서명된 토큰의 유효성을 검증할 수 있습니다.
• 만료 시간 확인: exp, iat, nbf 등 시간 관련 클레임을 사람이 읽기 쉬운 날짜 형식으로 변환합니다.
• 히스토리 관리: 최근 디코딩한 토큰을 저장하여 빠르게 다시 확인할 수 있습니다.
• 100% 클라이언트 처리: 모든 디코딩이 브라우저에서 이루어져 보안이 유지됩니다.

JWT 구조 이해하기

JWT는 점(.)으로 구분된 세 부분으로 구성됩니다:

• 헤더(Header): 토큰 타입(typ)과 서명 알고리즘(alg)을 명시합니다. 예: {“alg”: “HS256”, “typ”: “JWT”}
• 페이로드(Payload): 클레임(claims)이라 불리는 실제 데이터를 담고 있습니다. 사용자 정보, 권한, 만료 시간 등이 포함됩니다.
• 서명(Signature): 헤더와 페이로드를 인코딩한 값을 비밀키로 서명한 결과입니다. 토큰 위변조 방지에 사용됩니다.

주요 클레임 설명

JWT 페이로드에는 다양한 표준 클레임이 포함될 수 있습니다:

• iss (Issuer): 토큰을 발급한 주체를 식별합니다.
• sub (Subject): 토큰의 주제(보통 사용자 ID)를 나타냅니다.
• aud (Audience): 토큰의 수신자를 지정합니다.
• exp (Expiration Time): 토큰 만료 시간입니다. 이 시간이 지나면 토큰은 유효하지 않습니다.
• nbf (Not Before): 이 시간 이전에는 토큰이 유효하지 않습니다.
• iat (Issued At): 토큰이 발급된 시간입니다.
• jti (JWT ID): 토큰의 고유 식별자입니다.

사용 방법

1. JWT 토큰을 입력창에 붙여넣거나, 샘플 버튼을 클릭하여 예제 토큰을 확인합니다.
2. 토큰이 입력되면 자동으로 헤더, 페이로드, 서명 정보가 표시됩니다.
3. 서명 검증이 필요한 경우, Secret Key 입력란에 비밀키를 입력합니다.
4. 시간 관련 클레임은 자동으로 읽기 쉬운 날짜 형식으로 변환됩니다.
5. 최근 디코딩한 토큰은 히스토리에 저장되어 나중에 다시 확인할 수 있습니다.

보안 고려사항

• 민감한 정보 주의: JWT 페이로드는 암호화되지 않고 Base64로만 인코딩됩니다. 민감한 정보는 페이로드에 포함하지 마세요.
• 서명 검증 필수: 프로덕션 환경에서는 반드시 서명을 검증하여 토큰 위변조를 방지해야 합니다.
• 만료 시간 확인: exp 클레임을 항상 확인하여 만료된 토큰을 사용하지 않도록 합니다.
• HTTPS 사용: JWT 전송 시 반드시 HTTPS를 사용하여 토큰 탈취를 방지하세요.