Base64URL 디코더: URL-safe Base64 디코딩

Base64URL을 디코딩하는 방법

1. 입력 · Base64에 문자열을 붙여넣으세요. 페이지를 열면 URL-safe 예시가 들어 있습니다.
2. 출력 · 텍스트에서 결과를 읽으세요. 상태 표시줄에 변형(Base64URL 또는 Standard), 디코딩된 바이트 수, 감지된 유형이 나타납니다. 패딩이 빠져 있었다면 “누락된 패딩을 자동으로 추가했습니다.“라고 표시됩니다.
3. 토큰에 흔히 들어 있는 JSON은 JSON 보기 좋게 정렬로 들여쓰기됩니다.
4. 해시나 랜덤 ID 같은 바이너리 내용이면 도구가 바이너리 데이터라고 알려 주고 알맞은 디코더로 가는 링크를 보여 줍니다.
5. 출력 복사나 다운로드로 결과를 가져가세요.

인코딩하려면 Base64URL 인코더를 사용하세요. Base64URL 문자열을 디코딩하지 않고 표준 Base64로 바꾸려면 Base64URL을 Base64로를 사용하세요.

예시

마지막 행의 해시는 텍스트로 출력해도 의미가 없습니다. Base64를 Hex로에서 열면 13 d3 1e 96 ... 같은 바이트를 볼 수 있습니다.

패딩과 패딩을 복원할 수 있는 이유

Base64URL은 보통 = 없이 씁니다. 그래도 정보는 사라지지 않습니다. 올바른 문자열의 길이는 4n, 4n + 2, 4n + 3자 중 하나이고, 나머지를 보면 마지막 그룹에 바이트가 하나인지 둘인지 디코더가 알 수 있기 때문입니다. 도구는 디코딩 전에 빠진 =를 붙이고 상태 표시줄에 그 사실을 알립니다.

길이가 4n + 1인 경우는 있을 수 없습니다. “길이가 잘못되었습니다. 문자가 하나 많거나 적습니다.” 오류가 나오면 값을 복사할 때, 예를 들어 이메일이나 로그의 줄 바꿈에서 문자가 하나 빠지거나 더해진 것입니다. 계산 방법은 패딩 설명에 나와 있습니다.

많은 표준 디코더는 이보다 덜 관대합니다. 브라우저의 atob()는 -와 _를 InvalidCharacterError로 거부하고, Python의 base64.urlsafe_b64decode는 =가 없으면 Incorrect padding을 발생시킵니다.

토큰, 쿠키, URL 파라미터

• JWT. 토큰은 xxxxx.yyyyy.zzzzz 모양입니다. 앞의 두 부분은 Base64URL JSON이고, 세 번째는 바이너리인 서명입니다. 여기서 부분을 하나씩 디코딩하거나, 토큰 전체를 JWT 디코더에 붙여넣으세요. JWT 디코더는 만료 시각도 보여 주고 서명도 검증합니다. 형식은 JWT 속 Base64에서 설명합니다.
• 쿠키와 세션 ID. Flask 같은 일부 프레임워크의 세션 쿠키는 Base64URL 데이터와 서명을 점으로 이어 붙입니다. 데이터 부분만 디코딩하세요.
• URL 파라미터. OAuth state, 리디렉션 대상, 공유 링크에 Base64URL JSON이 담기기도 합니다. 값에 %2F나 %2B가 있다면 그 위에 퍼센트 인코딩이 한 번 더 된 것이므로 먼저 URL 디코딩이 필요합니다.

문자열에 -나 _가 +나 /와 섞여 있으면 디코더는 “입력에 표준(+ /) 문자와 URL-safe(- _) 문자가 섞여 있습니다"라며 멈춥니다. 대개 두 값이 합쳐졌거나 하나가 일부만 변환된 경우입니다.

코드에서 Base64URL 디코딩

// Node.js
Buffer.from("c3ViamVjdHM_X2Q", "base64url").toString("utf8");   // "subjects?_d"

// Browsers with Uint8Array.fromBase64
new TextDecoder().decode(Uint8Array.fromBase64("c3ViamVjdHM_X2Q", { alphabet: "base64url" }));

import base64

def b64url_decode(s: str) -> bytes:
    return base64.urlsafe_b64decode(s + "=" * (-len(s) % 4))

b64url_decode("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9")   # b'{"alg":"HS256","typ":"JWT"}'

이 패딩 처리 줄은 Base64로 유효한 모든 입력 길이에 맞게 작동합니다. 자세한 내용은 Node.js에서 Base64, JavaScript, Python에 있습니다.

자주 묻는 질문