환경 변수를 읽다가 eyJhbGciOiJIUzI1NiJ9처럼 알아볼 수 없는 값을 발견합니다. Base64라는 것은 알지만 그 자리에서 읽을 수는 없습니다. 그래서 이를 복사하고, Terminal을 열고, echo "..." | base64 --decode를 입력한 뒤 macOS에서는 -D 플래그를 써야 한다는 것을 뒤늦게 깨닫고 다시 시도해서 겨우 디코딩된 결과를 봅니다. 2초면 끝날 일에 30초를 써버린 셈입니다.
Base64 인코딩은 어디에서나 등장합니다: 인증 헤더, 이메일 첨부파일, CSS의 데이터 URI, Kubernetes 시크릿, CI/CD 파이프라인 설정. API나 인프라 작업을 한다면 하루에도 여러 번 Base64를 디코딩하게 됩니다.
터미널이 부족한 이유
macOS에 내장된 base64 명령어는 작동은 하지만 까다로운 부분이 있습니다. 디코드 플래그가 macOS에서는 -D(대문자)인데 Linux에서는 -d여서, 두 환경을 오가며 작업하는 사람에게는 헷갈리기 쉽습니다. 여러 줄에 걸친 입력은 인용부호 처리에 신경을 써야 합니다. 그리고 시각적 피드백이 전혀 없어서, 명령어를 입력하고 문자열을 받은 뒤 입력값이 실수로 잘리지 않았기를 바라야 합니다.
브라우저 기반 도구는 사용성 문제는 해결해 주지만 보안 문제를 만들어 냅니다. Base64로 인코딩된 값은 API 키, 토큰, 인증서 데이터 같은 시크릿인 경우가 많습니다. 이런 것을 웹사이트에 붙여넣는 순간 애초에 인코딩한 의미가 사라져버립니다.
로컬에서 한 번의 클릭으로 인코딩·디코딩
Bellows는 macOS용 41가지 개발자 도구 모음의 일부로 Base64 인코더와 디코더를 제공합니다. 인코딩된 문자열을 붙여넣으면 즉시 디코딩된 결과를 볼 수 있습니다. 방향을 바꿔서 평문을 Base64로 인코딩할 수도 있습니다. 모든 작업이 사용자의 기기 안에서만 이루어지며, 어떤 데이터도 맥을 벗어나지 않습니다.
흔한 사용 사례
YAML 매니페스트에 Base64로 저장된 Kubernetes 시크릿을 디코딩하는 일. Base64url로 인코딩된 JWT의 페이로드를 확인하는 일. 이미지를 HTML에 삽입하기 위해 Base64 데이터 URI로 변환하는 일. HTTP 기본 인증 헤더에 쓸 자격 증명을 인코딩하는 일. 이 모든 작업은 터미널 명령이나 브라우저 왕복 대신 붙여넣고 읽는 한 번의 상호작용으로 끝납니다.
클립보드 인식
Base64 문자열을 복사하고 메뉴 바에서 Bellows를 엽니다. 앱이 클립보드의 인코딩된 콘텐츠를 감지해 Base64 도구를 제안하므로, 직접 찾아 이동하는 단계를 건너뛸 수 있습니다.
설치 부담 없음
유지관리가 필요한 Homebrew 포뮬러나 파이썬 스크립트와 달리, Bellows는 Mac App Store에서 한 번 설치하면 자동으로 업데이트됩니다. Apple Silicon과 Intel 맥 모두에서 별도의 의존성 없이 네이티브로 작동합니다.