JSON을 Base64로: JSON 페이로드 인코딩

JSON을 Base64로 인코딩하는 방법

1. 입력 · 텍스트에 JSON을 붙여넣거나, 예시를 눌러 예시 객체를 불러오세요.
2. 출력 · Base64에서 Base64를 복사하세요. 크기 수치로 얼마나 길어졌는지 알 수 있습니다.
3. URL, 쿠키, 토큰 같은 값이라면 URL-safe (- _) 와 패딩 없음 (=) 을 선택하세요.
4. 다운로드는 결과를 base64.txt로 저장합니다.

이 페이지의 예시 {"id":42,"name":"base64hub","tags":["json","encode"],"active":true}는 67바이트이며 eyJpZCI6NDIsIm5hbWUiOiJiYXNlNjRodWIiLCJ0YWdzIjpbImpzb24iLCJlbmNvZGUiXSwiYWN0aXZlIjp0cnVlfQ==로 인코딩됩니다. 결과를 확인하려면 바꾸기를 누르거나, 보기 좋게 정렬까지 해 주는 Base64를 JSON으로를 사용하세요.

공백과 서식이 Base64를 바꿉니다

Base64는 JSON 텍스트의 문자를 그대로 인코딩하므로, 의미가 같은 두 문서라도 공백 하나만 달라도 Base64가 달라집니다.

Base64를 비교하거나, 캐시하거나, 서명한다면 한 직렬화기와 고정된 설정으로 JSON을 만들고 그 문자열을 그대로 인코딩하세요. 키 순서도 함정입니다. 대부분의 직렬화기는 삽입 순서를 유지하므로 {"a":1,"b":2}와 {"b":2,"a":1}은 다르게 인코딩됩니다.

기본 설정에서는 Python과 JavaScript가 다릅니다

객체 {"name": "Zoë", "n": 1}을 각 언어의 기본 설정으로 직렬화한 결과입니다.

URL-safe와 패딩 없음을 선택하면 JavaScript 버전은 eyJuYW1lIjoiWm_DqyIsIm4iOjF9가 됩니다.

Base64 JSON이 쓰이는 곳

• HTTP 헤더. 추적 정보나 사용자 메타데이터 같은 컨텍스트를 담는 커스텀 헤더는 Base64 JSON을 담는 경우가 많습니다. JSON의 따옴표와 비 ASCII 문자는 헤더 값에 그대로 쓰기 안전하지 않기 때문입니다. 많은 서버가 약 8 KB보다 긴 헤더 줄을 거부하므로 페이로드는 작게 유지하세요.
• URL 파라미터. OAuth state 값, 리디렉션 대상, 공유 링크에는 작은 JSON 객체가 Base64URL로 들어가기도 합니다.
• 환경 변수와 시크릿. CI 시스템의 서비스 계정 키처럼 JSON 설정 전체를 이스케이프 없이 변수 하나에 담을 수 있습니다.
• 토큰 형식. JWT의 헤더와 페이로드는 패딩 없이 Base64URL로 인코딩한 JSON입니다. 서명된 토큰을 만들려면 JWT 인코더를 사용하세요. 이 페이지는 인코딩만 합니다.

Base64는 크기를 3분의 1 늘리며, JSON 자체의 따옴표와 키가 값보다 큰 경우도 많습니다. 먼저 압축하는 것이 언제 이득인지는 Base64 크기 오버헤드에서 보여 줍니다.

코드에서 JSON을 Base64로

const obj = { name: "Zoë", n: 1 };
const bytes = new TextEncoder().encode(JSON.stringify(obj));
btoa(String.fromCharCode(...bytes));                     // "eyJuYW1lIjoiWm/DqyIsIm4iOjF9"
Buffer.from(JSON.stringify(obj)).toString("base64url"); // "eyJuYW1lIjoiWm_DqyIsIm4iOjF9" (Node.js)

TextEncoder 단계가 없으면 btoa(JSON.stringify(obj))는 ë를 Latin-1 1바이트로 인코딩하는데(eyJuYW1lIjoiWm/rIiwibiI6MX0=), UTF-8 디코더는 이를 읽지 못합니다. 또한 한글이나 이모지처럼 Latin-1 밖의 문자에서는 예외를 던집니다.

import base64, json

obj = {"name": "Zoë", "n": 1}
text = json.dumps(obj, separators=(",", ":"), ensure_ascii=False)
base64.b64encode(text.encode("utf-8")).decode()   # 'eyJuYW1lIjoiWm/DqyIsIm4iOjF9'

더 많은 옵션은 JavaScript, Node.js, Python 페이지에 있습니다.

자주 묻는 질문