Base64를 Base64URL로 변환 (URL-safe)

Base64를 Base64URL로 변환하는 방법

1. 입력 · Base64에 Base64를 붙여넣으세요. 줄 바꿈된 Base64의 줄 바꿈과 data:...;base64, 접두사는 자동으로 제거됩니다.
2. 출력 · Base64URL에 URL-safe 문자열이 나타납니다.
3. 받는 쪽이 끝의 =를 유지하길 원하면 출력 아래의 패딩 (=) 을 선택하세요.
4. 출력 복사를 누르세요. Base64URL → Base64 전환이나 Base64URL을 Base64로를 쓰면 다시 되돌릴 수 있습니다.

입력을 바이트로 디코딩한 뒤 다시 인코딩하므로, 올바른 Base64가 아닌 문자열은 절반만 변환된 결과 대신 오류를 냅니다.

예시

마지막 행 같은 경우는 흔합니다. 짧은 JSON과 ASCII 텍스트는 +나 / 없이 인코딩되는 경우가 많고, 길이가 3바이트의 배수면 패딩도 없으므로 두 형식이 같아집니다. 그래서 변환을 깜빡해도 테스트에서는 드러나지 않다가, 어떤 값이 우연히 +나 /를 만들 때 비로소 문제가 됩니다.

URL을 깨뜨리는 표준 Base64 문자

표준 Base64의 세 문자는 URL에서 특별한 의미를 가집니다.

• +는 쿼리 문자열에서 공백을 뜻하므로, 많은 프레임워크에서 ?t=a+b가 a b로 전달됩니다.
• /는 경로 구간을 나누므로, 경로에 든 Base64가 쪼개지거나 엉뚱하게 라우팅될 수 있습니다.
• =는 쿼리 파라미터의 이름과 값을 나누므로, 안전하려면 %3D로 써야 합니다.

RFC 4648 5절은 이런 경우를 위해 Base64URL을 정의하며, +와 / 자리에 -와 _를 쓰고 패딩은 생략해도 됩니다. 이런 값은 경로, 쿼리 문자열, 쿠키, 파일 이름에서 이스케이프할 필요가 없습니다. 자세한 내용은 Base64와 Base64URL 비교 글에서 다룹니다.

Base64URL이 필요한 곳

• JWT와 JWS. JSON Web Token의 세 구간은 모두 패딩 없는 Base64URL을 씁니다. JWT 디코더로 읽을 수 있고, 형식은 JWT 속 Base64에서 설명합니다.
• OAuth PKCE. 해시 도구는 verifier의 SHA-256 다이제스트를 표준 Base64로 출력하는 경우가 많지만, code_challenge는 그 다이제스트를 패딩 없는 Base64URL로 쓴 값이어야 합니다. 이 변환이 마지막 단계입니다.
• WebAuthn과 JWK. 자격 증명 ID, challenge, JSON Web Key의 키 파라미터는 Base64URL입니다.
• 서명된 URL과 링크 속 토큰. 비밀번호 재설정 링크나 다운로드 링크처럼 값이 경로나 쿼리 문자열에 들어가는 경우입니다.

중간에 표준 형식을 거치지 않고 텍스트를 바로 Base64URL로 인코딩하려면 Base64URL 인코더를 사용하세요.

코드에서 Base64를 Base64URL로

import base64
base64.urlsafe_b64encode(b"<<???>>").rstrip(b"=").decode()   # 'PDw_Pz8-Pg'

Buffer.from("PDw/Pz8+Pg==", "base64").toString("base64url");   // 'PDw_Pz8-Pg'
"PDw/Pz8+Pg==".replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");   // same, without Buffer

Python의 urlsafe_b64encode는 패딩을 유지하므로 rstrip이 필요합니다. Node의 "base64url" 인코딩은 패딩을 제거합니다. 자세한 내용은 Python과 Node.js 가이드에 있습니다.

자주 묻는 질문