Công cụ mã hóa và giải mã Z85

Z85 là gì?

Z85 được đặc tả trong ZeroMQ RFC 32 (một đặc tả của cộng đồng ZeroMQ, không phải RFC của IETF). Giống các kiểu mã hóa Base85 khác, nó biến mỗi 4 byte thành 5 ký tự, đọc mỗi nhóm như một số 32 bit big-endian và viết nó thành 5 chữ số cơ số 85, chữ số có trọng số lớn nhất đứng trước. Đầu ra lớn hơn đầu vào 25%.

Điểm làm Z85 khác biệt là bảng ký tự của nó: 0-9, a-z, A-Z và 23 ký hiệu .-:+=^!/*?&<>()[]{}@%$#. Bảng này loại bỏ cả hai loại dấu nháy, dấu gạch chéo ngược, dấu backtick, dấu phẩy, dấu chấm phẩy, dấu gạch đứng, dấu ngã và dấu gạch dưới. Bảng ký tự được thiết kế để an toàn trong chuỗi ký tự của mã nguồn, nên một giá trị Z85 có thể được dán giữa hai dấu nháy trong C, Python hay JSON mà không cần thoát ký tự nào.

Z85 được dùng ở đâu

ZeroMQ dùng Z85 để in khóa CurveZMQ. Một khóa công khai hoặc khóa bí mật 32 byte trở thành một chuỗi Z85 dài 40 ký tự, đây là dạng được zmq_curve_keypair() trả về và được các tùy chọn socket cho bảo mật CURVE chấp nhận. Thư viện cũng cung cấp zmq_z85_encode() và zmq_z85_decode(), và các thư viện liên kết như pyzmq có các hàm tương tự.

// C (libzmq)
char text[41];                       // 32 byte -> 40 ký tự + NUL
zmq_z85_encode(text, key, 32);

# Python (pyzmq)
from zmq.utils import z85
z85.encode(bytes.fromhex('864fd26fb559f75b'))   # b'HelloWorld'

Dòng cuối là vectơ kiểm thử lấy từ đặc tả.

Độ dài đầu vào: lưu ý về công cụ này

RFC 32 yêu cầu dữ liệu nhị phân đầu vào phải là bội số của 4 byte và chuỗi đã mã hóa phải là bội số của 5 ký tự. Đặc tả không định nghĩa phần đệm, và các bản triển khai nghiêm ngặt như zmq_z85_encode() từ chối các độ dài khác.

Công cụ này cũng chấp nhận các độ dài khác, theo cùng quy tắc với Ascii85 và Base85: nhóm cuối gồm n byte trở thành n + 1 ký tự. Đây là một phần mở rộng không theo tiêu chuẩn. Đầu ra tạo theo cách này có thể bị các bộ giải mã Z85 khác từ chối, vì vậy hãy đệm dữ liệu cho đủ bội số của 4 byte khi bạn cần tính tương thích. Khóa CurveZMQ dài 32 byte nên luôn phù hợp.