Base45 인코더 및 디코더

Base45란?

Base45는 RFC 9285에 정의되어 있습니다. 알파벳은 숫자 0-9, 대문자 A-Z, 그리고 공백과 $ % * + - . / :의 기호 9개입니다. 이는 QR 코드가 간결한 영숫자 모드로 저장할 수 있는 45개 문자와 정확히 같습니다. 공백은 구분자가 아니라 알파벳에 속한 실제 문자라는 점에 유의하십시오.

인코더는 입력을 2바이트씩 읽어 0부터 65535까지의 숫자로 해석하고, 이 숫자를 가장 낮은 자리부터 Base45 숫자 세 자리로 씁니다. 마지막에 1바이트가 남으면 두 문자가 됩니다. 텍스트로 보면 결과는 입력의 1.5배로, Base64보다 큽니다.

Base45가 QR 코드에 적합한 이유

영숫자 모드에서 QR 코드는 두 문자를 11비트에 담습니다. Base64는 소문자가 필요해 이 모드를 쓸 수 없으므로, 문자당 8비트를 쓰는 바이트 모드로 대체되어 데이터 1바이트당 약 10.7비트가 듭니다. Base45는 영숫자 모드에서 바이트당 8.25비트만 필요하므로, 같은 데이터를 더 작고 스캔하기 쉬운 QR 코드에 담을 수 있습니다.

디코딩할 때는 공백을 있는 그대로 유지하십시오. 무시되는 것은 줄 바꿈뿐입니다. 소문자는 알파벳에 속하지 않으므로 유효하지 않은 문자로 표시됩니다.

EU 디지털 코로나19 증명서 디코딩하기

EU 디지털 코로나19 증명서의 QR 코드에는 HC1:로 시작하는 텍스트가 들어 있습니다. 나머지 부분은 Base45입니다. 증명서 데이터는 CBOR로 인코딩되고 COSE로 서명된 뒤 zlib으로 압축되고 마지막으로 Base45로 인코딩됩니다. 내용을 확인하는 방법은 다음과 같습니다.

1. HC1: 접두사를 제거합니다. 이 네 문자도 올바른 Base45 문자이므로, 남겨 두면 잘못된 바이트가 나옵니다.
2. 나머지를 이 페이지에서 16진수 출력으로 디코딩합니다. zlib 데이터는 보통 78 바이트로 시작합니다.
3. 다른 도구로 바이트를 zlib 압축 해제하고 CBOR를 분석합니다.

이 도구는 Base45 단계만 처리합니다. 데이터의 압축 해제, 분석, 서명 검증은 하지 않습니다.

코드에서 Base45 사용하기

# Python (pip install base45)
import base45
base45.b45encode(b'AB')     # RFC 9285 예시: BB8
base45.b45decode('BB8')     # b'AB'