Base64URL 디코딩, 패딩 복구까지.

표준 Base64는 URL과 파일 이름에서 의미가 있는 +와 /를 쓰고, 쿼리 문자열에서 퍼센트 인코딩해야 하는 =로 패딩합니다. RFC 4648 5절에 정의된 Base64URL은 이 문자들만 바꿔서 값이 URL 안에서 그대로 전달되게 합니다:

나머지 62개 문자는 같으므로, 변환은 문자 교체와 패딩 추가뿐입니다.

엄격한 디코더 상당수는 패딩이 없는 입력을 거부합니다. 패딩을 다시 붙이는 규칙은 문자열 길이를 4로 나눈 나머지에만 달려 있습니다:

• 나머지 0 — 패딩 필요 없음
• 나머지 2 — == 추가
• 나머지 3 — = 추가
• 나머지 1 — 올바른 Base64에서는 불가능하며, 값이 잘린 것입니다

이 디코더는 규칙을 자동으로 적용하고, 잘린 값은 조용히 엉뚱한 결과를 내는 대신 오류로 알려 줍니다.

• JSON Web Token — 헤더, 페이로드, 서명은 점으로 이어진 세 개의 base64url 구간입니다. 서명은 보여 주지만 키가 필요하므로 검증하지는 않습니다.
• WebAuthn과 패스키 — 챌린지, 자격 증명 ID, 클라이언트 데이터.
• OAuth PKCE — code_challenge는 base64url로 인코딩한 SHA-256 다이제스트입니다.
• Gmail API — 메시지 본문과 첨부 파일이 base64url로 인코딩되어 있습니다.
• 짧은 ID와 토큰 — URL, 쿠키, 파일 이름 안에서 쓰입니다.

# Python: urlsafe_b64decode still needs the padding back
import base64
def b64url_decode(s: str) -> bytes:
    return base64.urlsafe_b64decode(s + "=" * (-len(s) % 4))

// Node.js 16+
Buffer.from(token, "base64url").toString("utf8");

// Go
base64.RawURLEncoding.DecodeString(s)

// Java 8+: the URL decoder accepts unpadded input
Base64.getUrlDecoder().decode(s);

표준 Base64와 다른 언어는 기본 Base64 디코딩 페이지를 참고하세요.