Khoá CSK & chữ ký

Mỗi request phải kèm chữ ký RSA-SHA256 tạo bằng khoá CSK của đơn vị. Sandbox dùng khoá mẫu của RAR; Production dùng cặp khoá đơn vị tự sinh.

Quy tắc ký

MụcQuy định
Thuật toánSHA256withRSA, padding RSASSA-PKCS1-v1_5
Độ dài khoáRSA 2048 bit
Mã hoá kết quảBase64, một dòng, không xuống dòng
Mã hoá chuỗi kýUTF-8

Chuỗi cần ký nối 7 trường theo đúng thứ tự, ngăn bằng dấu |:

request_id|request_time|license_id|device_type|dia_chi|id_card|dscert
signature = Base64( RSA-SHA256( UTF-8(chuỗi ký), khoá bí mật CSK ) )

Mẫu ký bằng OpenSSL

SIGNING="$REQUEST_ID|$REQUEST_TIME|$LICENSE_ID|$DEVICE_TYPE|$DIA_CHI|$ID_CARD|$DSCERT"
SIGNATURE=$(printf '%s' "$SIGNING" | openssl dgst -sha256 -sign "$CSK_KEY" | base64 -w0)

Mẫu lệnh do người soạn wiki viết theo quy tắc trên; tài liệu gốc chỉ nêu công thức.

Hai môi trường

SandboxProduction
Khoá bí mậtKhoá mẫu do RAR cấpĐơn vị tự sinh, tự giữ; RAR không nhận, không lưu
Khoá công khaiRAR cấu hình sẵnĐơn vị gửi RAR, gắn với license_id
Định danh đơn vịKhông (khoá dùng chung)Có, mỗi đơn vị một cặp, không dùng chung
Dữ liệuChỉ dữ liệu thử đã đăng ký trước (số CCCD + dscert)Dữ liệu thật
Khi nào dùng đượcNhận đủ URL, license_id, khoá, dữ liệu thửSau khi RAR xác nhận đã kích hoạt khoá công khai

Khoá mẫu Sandbox chỉ dùng kiểm thử với dữ liệu thử. Không dùng trên Production, không ký dữ liệu thật, không đưa vào kho mã công khai hay tài liệu công khai, không chia cho bên ngoài nhóm kiểm thử. RAR có thể đổi hoặc thu hồi bất kỳ lúc nào.

Vì vậy wiki này không chứa file khoá. File nằm ở thư mục tài liệu gốc trên máy chủ, xem Tài liệu gốc.

Sinh cặp khoá Production

openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out csk_private_key.pem
openssl pkey -in csk_private_key.pem -pubout -out csk_public_key.pem
chmod 600 csk_private_key.pem

Chữ ký của response

RAR ký đối tượng responds bằng khoá bí mật của hệ thống; đơn vị kiểm bằng khoá công khai do RAR công bố (bộ tài liệu có một file cho Sandbox, một file cho Production). Phải kiểm trên đúng chuỗi dữ liệu và quy tắc tuần tự hoá RAR quy định, không tự định dạng lại JSON trước khi kiểm.

Danh sách kiểm trước khi gửi request thử