w
문서 핵심 도구 Jwt Parser

기본 사용법

이 가이드는 JWT Parser 도구를 사용해 JSON Web Token을 분석하는 기본 단계를 안내합니다.

1단계: 도구 열기

메인 도구 페이지에서 JWT Parser 도구로 이동하거나 URL /jwt-parser 로 바로 접속합니다.

2단계: JWT 토큰 입력

방법 1: 수동 입력

  1. "JWT Token" 텍스트 영역을 클릭합니다
  2. JWT 토큰을 붙여넣거나 직접 입력합니다
  3. 입력하는 동안 도구가 토큰을 자동으로 파싱합니다

방법 2: 예제 불러오기

  1. "Load Example" 버튼을 클릭합니다
  2. 샘플 JWT 토큰이 자동으로 로드됩니다
  3. 이 방법은 테스트와 도구 기능 학습에 유용합니다

3단계: 파싱 결과 확인

유효한 JWT 토큰을 입력하면 세 가지 주요 섹션이 표시됩니다.

헤더 정보

  • 알고리즘: 사용된 서명 알고리즘(예: HS256, RS256)
  • 유형: 토큰 유형(일반적으로 "JWT")
  • 추가 클레임: 그 밖의 헤더 클레임

페이로드 데이터

  • 표준 클레임: iss, sub, aud, exp, nbf, iat, jti
  • 사용자 정의 클레임: 애플리케이션별 데이터
  • 만료 시간: 토큰이 만료되는 시점(지정된 경우)

서명

  • 원본 서명: base64url 인코딩된 서명
  • 검증 안내: 이 도구는 서명을 검증하지 않는다는 안내

4단계: 추가 기능 사용

결과 복사

  1. "Copy Result" 버튼을 클릭합니다
  2. 파싱된 정보가 클립보드에 복사됩니다
  3. 원하는 텍스트 편집기나 문서에 붙여넣습니다

내용 지우기

  1. "Clear All"을 클릭해 모든 내용을 제거합니다
  2. 새 토큰으로 다시 시작합니다

기록 보기

  • 이전에 파싱한 토큰이 기록 섹션에 표시됩니다
  • 기록 항목을 클릭하면 해당 토큰을 다시 불러올 수 있습니다
  • "Clear History"를 사용하면 저장된 토큰을 모두 삭제할 수 있습니다

출력 이해하기

헤더 예시

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

페이로드 예시

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

자주 쓰는 클레임 설명

  • sub (Subject): 토큰의 주체
  • iat (Issued At): 토큰이 발급된 시점
  • exp (Expiration): 토큰의 만료 시점
  • aud (Audience): 토큰의 대상 수신자
  • iss (Issuer): 토큰 발급자

오류 처리

잘못된 형식

잘못된 JWT 형식을 입력하면 다음 오류 메시지가 표시됩니다.

  • "Invalid JWT format. JWT should have 3 parts separated by dots."

파싱 오류

토큰을 파싱할 수 없으면 다음 메시지가 표시됩니다.

  • "Failed to parse JWT token"

일반적인 문제

  • 점 누락: JWT는 3개 부분을 구분하기 위해 정확히 2개의 점이 있어야 합니다
  • 잘못된 base64: 각 부분은 유효한 base64url 인코딩이어야 합니다
  • 잘못된 JSON: 헤더와 페이로드는 유효한 JSON이어야 합니다

모범 사례

보안

  • 이 도구는 테스트 토큰이나 본인이 소유한 토큰에만 사용하세요
  • 민감한 운영 환경 토큰은 절대 공유하지 마세요
  • 안전하고 개인적인 환경에서만 사용하세요

개발 워크플로

  1. 개발 환경에서 테스트 토큰을 생성합니다
  2. 토큰을 파싱해 구조와 클레임을 확인합니다
  3. 결과를 사용해 인증 문제를 디버깅합니다
  4. 프로젝트를 전환할 때는 기록을 지웁니다

토큰 관리

  • 중요한 테스트 토큰은 기록해 두세요
  • 자주 분석하는 토큰에는 기록 기능을 활용하세요
  • 개인정보 보호를 위해 기록을 정기적으로 지우세요

다음 단계

이제 기본을 이해했으니 더 고급 사용 패턴을 알아보려면 고급 기능을 살펴보고, 안전한 토큰 처리를 위해 보안 고려 사항을 확인하세요.

이 페이지가 도움이 되었나요?