Base64 인코더 / 디코더 (UTF-8 및 URL-safe)

Base64가 무엇이고 무엇이 아닌지

Base64는 64자 알파벳(A-Z, a-z, 0-9, +, / 및 = 패딩) 사용해 임의 바이트 인코딩. JSON, HTML, 이메일 헤더 같은 텍스트 전용 형식에 이진 데이터 — 이미지 바이트, 암호화된 블롭, 서명된 토큰 — 임베딩하는 표준 방식. 출력은 입력보다 약 33% 큼.

Base64는 인코딩이지 암호화 아님. 누구나 Base64 문자열을 원래 바이트로 디코딩 가능. 비밀 숨기기에 사용 금지 — 기밀이 필요하면 실제 암호 알고리즘 사용.

URL-safe vs 표준

표준 Base64는 '+'와 '/' 포함, URL에서 특별한 의미 가지므로 퍼센트 인코딩 필요. URL-safe Base64(RFC 4648 §5)는 '+'를 '-'로, '/'를 '_'로 대체하고 후행 '=' 패딩 제거. JWT, OAuth 토큰, 많은 웹 API가 URL-safe 형식 사용.

JWT나 토큰을 수동 디코딩하면 URL-safe ON. 클래식 이메일이나 PDF 임베디드 데이터 작업이면 OFF. 디코더는 URL-safe ON일 때 양 형식 수용 — 표준 알파벳이 특별 쌍 빼고 슈퍼셋이기 때문.

UTF-8 처리

옛 브라우저 btoa()는 ASCII만 처리 가능. 본 도구는 TextEncoder로 입력을 먼저 UTF-8 바이트로 변환 후 그 바이트를 Base64 인코딩. 이로써 이모지, CJK 문자, 강세 라틴, 기타 유니코드 모두 올바르게 인코딩 및 왕복. 바이트-그-다음-base64 접근은 JWT 라이브러리와 대부분 현대 프레임워크와 동일.