API payload를 Base64로 디코딩하기

문제 상황

급하게 처리하면 입력 범위, 인코딩, 순서, 민감한 정보, 출력 형식을 놓치기 쉽습니다. API payload를 Base64로 디코딩하기에서는 BASE64 인코딩/디코딩를 사용해 로컬에서 확인하며 공유 전 문제를 줄입니다.

이럴 때 사용하세요

• JSON 필드 안의 긴 인코딩 값이 실제로 무엇을 담고 있는지 확인해야 할 때 사용합니다.
• 웹훅 payload가 metadata를 Base64 텍스트로 담아 보내는 경우에 적합합니다.
• 쿠키, 헤더, 로컬 로그의 값을 디버깅 중에 사람이 읽을 수 있는 텍스트로 확인해야 할 때 도움이 됩니다.
• 지원 티켓이나 로그를 공유하기 전에 인코딩된 필드 안에 민감한 값이 들어 있는지 확인해야 할 때 사용합니다.

단계

1. 1단계

   값이 일반 Base64인지 확인

   문자 조합과 padding을 보고 Base64인지 살핍니다. 값이 URL 안에 들어 있다면 URL 디코딩을 먼저 한 뒤 Base64 디코딩을 진행합니다.

2. 2단계

   UTF-8 텍스트로 디코딩

   Base64 디코더에 값을 붙여 넣고 결과가 읽을 수 있는 텍스트, JSON, XML, 또는 다른 구조화 형식인지 확인합니다.

3. 3단계

   디코딩 결과를 정리

   결과가 JSON이나 다른 구조화 텍스트라면 바로 공유하지 말고 먼저 보기 좋게 정리해 필드 이름과 중첩 값을 확인합니다.

4. 4단계

   Base64를 보안 처리로 착각하지 않기

   Base64는 되돌릴 수 있는 인코딩입니다. 인증 정보, access token, 개인 정보를 보호하는 방법으로 의존하면 안 됩니다.

5. 5단계

   디코딩한 계층의 다음 작업 결정

   결과가 JSON이면 포맷팅하고, 토큰 조각이면 해당 조각만 다시 확인합니다. 바이너리나 압축 결과라면 추측하지 말고 맞는 뷰어를 사용하세요.

예시

eyJldmVudCI6InBheW1lbnQuc3VjY2VlZGVkIiwiaWQiOiJldnRfMTIzIiwidGVuYW50IjoiYWNtZSJ9

{
  "event": "payment.succeeded",
  "id": "evt_123",
  "tenant": "acme"
}

흔한 실수

자주 묻는 질문