가이드

오프라인 JWT 디코딩, Base64URL 및 시맨틱 JSON Diff 비교

전송 제로 브라우저 메모리에서 JWT 헤더·클레임을 디코딩하고 패딩 없는 Base64URL 인코딩, 키 순서 무관 시맨틱 JSON Diff, 로그 정제를 실행합니다.

읽기 4분

빠른 답변: JWT 헤더와 페이로드는 단지 Base64URL로 인코딩된 UTF-8 JSON이므로 네트워크 전송 없이 브라우저 RAM에서 안전하게 디코딩할 수 있습니다. API 응답 비교 시에는 키 순서와 들여쓰기를 무시하는 시맨틱 JSON Diff를 쓰고, 로그 공유 전에는 Bearer 토큰을 먼저 마스킹하세요.

운영 환경 JWT를 온라인 디코더 사이트에 붙여넣으면 위험한 이유

실제 사용 중인 JSON Web Token에는 사용자 ID, 이메일 클레임, 테넌트 권한과 만료 전까지 유효한 세션 접근 권한이 들어 있습니다. 활성 Bearer 토큰을 외부 웹 디코더에 붙여넣으면 서버 액세스 로그나 원격 수집 스크립트에 자격 증명이 남을 수 있습니다.

JWT의 세 부분(header.payload.signature) 중 앞의 두 영역은 암호화되지 않은 Base64URL UTF-8 JSON일 뿐이므로, 클레임을 확인하는 데 서버 통신이 전혀 필요하지 않습니다.

  • RFC 4648 제5절의 Base64URL은 +와 /를 -와 _로 바꾸고 끝의 = 패딩을 생략합니다.
  • 브라우저 RAM 디코딩만으로 alg, typ, sub, exp 및 사용자 정의 클레임을 즉시 파악합니다.
  • 단, 암호학적 서명 검증은 클라이언트 화면이 아닌 서명 키를 보유한 백엔드 인증 서버나 JWKS 검증기에서 수행해야 합니다.

JWT 자동 감지와 패딩 없는 Base64URL 오프라인 인코딩

Base64 및 JWT 디코더를 디코딩 모드(autoDetectJwt 활성)로 두고 3단 구조의 Base64URL JWT를 붙여넣으면, header와 payload JSON은 물론 signature 문자열까지 자동 추출해 보기 좋은 JSON으로 출력합니다.

인코딩 모드로 바꾸고 urlSafe를 켜면 OAuth state나 URL 쿼리 매개변수에 바로 쓸 수 있는 = 패딩 없는 Base64URL 문자열을 만들며, 표준 +/ Base64와 UTF-8·ASCII 문자셋 디코딩도 모두 지원합니다.

json
{
  "header": {
    "alg": "HS256",
    "typ": "JWT"
  },
  "payload": {
    "sub": "user_123",
    "name": "Maya Lin",
    "local": "true"
  },
  "signature": "dGVzdF9zaWduYXR1cmU"
}

브라우저 메모리에서 JWT 클레임과 Base64URL 디코딩하기

줄 단위 비교 대신 시맨틱 JSON Diff로 API 응답 차이 파악하기

스테이징과 운영 API 응답을 비교할 때 직렬화기마다 객체 키 순서가 다르거나 한쪽만 압축되어 있으면 일반 줄 단위 Diff는 온통 변경 표시로 뒤덮입니다. 텍스트·JSON 비교(Diff)에서 semanticJsonDiff를 켜면 두 창을 JSON 트리로 파싱해 키 순서나 공백을 무시하고 실제 값의 차이만 정확히 보여 줍니다.

// 주석이나 후행 쉼표가 섞인 JSONC 조각이라면 JSON 포맷터의 구문 복구 기능으로 먼저 정리하세요. 스냅샷을 TOML로 내보낼 때는 TOML 명세에 null 타입이 없으므로 JSON → TOML 변환기가 null 키를 경고와 함께 안전하게 생략합니다.

시맨틱 JSON Diff 또는 나란히 텍스트 비교하기

비교 모드키 순서 변경공백 및 압축 포맷 차이적합한 용도
줄 단위 Diff (기본)삭제 후 추가로 표시공백 무시 꺼짐 시 모두 표시코드 패치, .env 파일, 일반 텍스트
줄 단위 Diff + 공백 무시삭제 후 추가로 표시줄 내부 들여쓰기 공백 무시들여쓰기 YAML, SQL, 마크다운
시맨틱 JSON Diff자동으로 무시자동으로 무시API 응답, JWT 클레임, JSON 설정

디버그 로그 공유 전 JWT와 DB 연결 문자열 먼저 정제하기

로컬에서 문제가 된 토큰을 디코딩하거나 API 페이로드를 비교한 뒤에도, 오류 추적이나 HTTP 로그를 Slack 티켓이나 AI 채팅에 붙여넣을 때는 원본 Authorization 헤더나 데이터베이스 접속 주소를 그대로 남기지 마세요.

공유하기 전에 '서버 로그 AI 정화'를 거쳐 JWT([[JWT-01]]), 사내 IP 주소, API 키 및 Postgres·Redis 연결 문자열을 결정론적으로 마스킹하는 것이 안전합니다.

공유 전 로그 속 JWT 및 시크릿 로컬 정제하기

참고 자료

자주 묻는 질문

Base64 및 JWT 디코더가 JWT의 암호학적 서명도 검증하나요?

아니요. 비밀 키를 입력받거나 전송하지 않도록 로컬에서 Base64URL 헤더와 페이로드 JSON을 디코딩하고 원본 서명 문자열만 표시합니다. 서명 검증은 반드시 서버 측에서 수행하세요.

표준 Base64와 Base64URL의 핵심적인 차이는 무엇인가요?

Base64URL은 +를 -로, /를 _로 대체하고 보통 끝부분의 = 패딩을 생략해 URL 쿼리와 HTTP 헤더에 안전하게 넣을 수 있도록 만든 인코딩입니다.

시맨틱 JSON Diff가 양쪽 모두 유효한 JSON을 요구하는 이유는 무엇인가요?

키 순서나 줄바꿈에 구애받지 않는 구조적 비교를 위해 두 입력을 JSON 객체로 먼저 파싱해야 하기 때문입니다. 주석이나 후행 쉼표가 있다면 JSON 포맷터로 먼저 정리하세요.

관련 파일 형식

관련 비교 페이지

관련 가이드