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ục | Quy định |
|---|---|
| Thuật toán | SHA256withRSA, 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 ) )
- Giá trị trong chuỗi ký phải giống tuyệt đối giá trị gửi trong header và body.
- Không thêm khoảng trắng đầu / cuối, không xuống dòng cuối chuỗi, không đổi hoa / thường, không mã hoá lại.
- Cả 7 trường bắt buộc, không rỗng, không chứa ký tự
|. dscertlà chuỗi Base64 của chứng thư số trên chip, đúng như gửi trong body.
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
| Sandbox | Production | |
|---|---|---|
| Khoá bí mật | Khoá mẫu do RAR cấp | Đơn vị tự sinh, tự giữ; RAR không nhận, không lưu |
| Khoá công khai | RAR 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ệu | Chỉ dữ liệu thử đã đăng ký trước (số CCCD + dscert) | Dữ liệu thật |
| Khi nào dùng được | Nhậ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
- Khoá bí mật: PEM, PKCS#8 (
-----BEGIN PRIVATE KEY-----). - Khoá công khai: PEM, SubjectPublicKeyInfo (
-----BEGIN PUBLIC KEY-----). - Chỉ gửi
csk_public_key.pem. Không lưu khoá bí mật trong mã nguồn, Git, image Docker, nhật ký; chỉ tài khoản dịch vụ ký request được đọc. - Khoá lộ hoặc nghi lộ: ngừng dùng, báo ngay RAR để thu hồi khoá công khai.
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ử
- Đúng URL AgentGW và
license_idcủa Sandbox. - Có khoá mẫu, đặt nơi an toàn, biến
CSK_KEYtrỏ đúng đường dẫn. - Đúng
device_typevàdia_chiđược cấp / đăng ký. - Đúng cặp
id_card+dscertcủa dữ liệu thử. request_idmới cho mỗi request.request_timetheo GMT+7, máy chủ đã đồng bộ giờ.- Chuỗi ký đúng thứ tự, không thừa khoảng trắng / xuống dòng, khớp tuyệt đối header và body.
- Chữ ký Base64 nằm trên một dòng.