Kết quả kiểm thử Sandbox
66 ca thử do phía RAR chạy trên Sandbox, kèm HTTP status và phản hồi thật. Đây là hành vi đo được, có vài chỗ khác tài liệu đặc tả.
Rút ra từ kết quả
| Quan sát | Hệ quả khi tích hợp |
|---|---|
Chữ ký sai trả 400 BAD_REQUEST “Xác thực chữ ký đối tác thất bại”, không phải 401 như phần hướng dẫn gỡ lỗi của đặc tả. | Bắt lỗi chữ ký theo thông điệp của mã 400. |
request_time chỉ nhận trong vòng 10 phút và không được lớn hơn giờ hiện tại. | Đồng bộ giờ máy chủ (NTP); lệch giờ là hỏng toàn bộ. |
license_id sai hoặc viết thường trả 403. | Phân biệt hoa / thường. |
device_type giá trị lạ (“Desktop”, “Web”) trả 500 INTERNAL_SERVER_ERROR, không phải exitcode 3. | Gặp 500 ngay lần đầu thì kiểm device_type trước khi nghĩ hệ thống lỗi. |
id_card 6 hoặc 11 chữ số vẫn qua bước kiểm định dạng (1–12 số) rồi trả 500 VRF_CRYPTO_FAIL; 13 số, có chữ, ký tự đặc biệt trả 400. | Tự kiểm đủ 12 chữ số ở phía mình trước khi gọi. |
dscert không phải Base64 trả 500 VRF_CRYPTO_FAIL; chứng thư giả đúng dạng trả 200 với result: false, “invalid dscert”. | Luôn đọc result, không dựa vào HTTP 200. |
request_id không bị kiểm định dạng (1 ký tự, 100 ký tự, có khoảng trắng đều qua). | Vẫn nên dùng UUID v4 để tránh trùng (trùng sẽ bị 409). |
Thiếu hoặc sai Content-Type vẫn trả 200; dư trường trong body / header cũng được chấp nhận. | Không ảnh hưởng, nhưng nên gửi đúng chuẩn. |
Method GET bị treo tới hết 30 giây; PUT, DELETE, PATCH trả 405. | Đặt timeout phía gọi. |
| Thông điệp thành công thực tế là “valid DSCert”, đặc tả ghi “valid idcard”. | Không so chuỗi message. |
Cột “Hệ quả” là nhận định của người soạn wiki. Bảng gốc đánh số tới 73 nhưng không có các ca 59–65 (nhóm 6).
Toàn bộ ca thử
| # | Nhóm | Trường hợp | HTTP | Kết quả trả về |
|---|---|---|---|---|
| 1 | 1. Hợp lệ | Valid Request Baseline | 200 | exitcode 0, result true — valid DSCert |
| 2 | 2. Thiếu dữ liệu | Missing header request_id | 400 | VRF_MISSING_HEADER — missing required header: request_id |
| 3 | 2. Thiếu dữ liệu | Missing header request_time | 400 | VRF_MISSING_HEADER — missing required header: request_time |
| 4 | 2. Thiếu dữ liệu | Missing header license_id | 400 | VRF_MISSING_HEADER — missing required header: license_id |
| 5 | 2. Thiếu dữ liệu | Missing header device_type | 400 | VRF_MISSING_HEADER — missing required header: device_type |
| 6 | 2. Thiếu dữ liệu | Missing header dia_chi | 400 | VRF_MISSING_HEADER — missing required header: dia_chi |
| 7 | 2. Thiếu dữ liệu | Missing header Content-Type | 200 | exitcode 0, result true — valid DSCert |
| 8 | 2. Thiếu dữ liệu | Missing header signature | 400 | VRF_MISSING_HEADER — missing required header: signature |
| 9 | 2. Thiếu dữ liệu | Missing payload id_card | 400 | VRF_INVALID_BODY — request body invalid: id_card and dscert required |
| 10 | 2. Thiếu dữ liệu | Missing payload DSCert | 400 | VRF_INVALID_BODY — request body invalid: id_card and dscert required |
| 11 | 2. Thiếu dữ liệu | Missing all custom headers | 400 | VRF_MISSING_HEADER — missing required header: request_id |
| 12 | 2. Thiếu dữ liệu | Missing all payload | 400 | VRF_INVALID_BODY — request body invalid: id_card and dscert required |
| 13 | 3. Dữ liệu rỗng | Empty header request_id | 400 | VRF_MISSING_HEADER — missing required header: request_id |
| 14 | 3. Dữ liệu rỗng | Empty header request_time | 400 | VRF_MISSING_HEADER — missing required header: request_time |
| 15 | 3. Dữ liệu rỗng | Empty header license_id | 400 | VRF_MISSING_HEADER — missing required header: license_id |
| 16 | 3. Dữ liệu rỗng | Empty header device_type | 400 | VRF_MISSING_HEADER — missing required header: device_type |
| 17 | 3. Dữ liệu rỗng | Empty header dia_chi | 400 | VRF_MISSING_HEADER — missing required header: dia_chi |
| 18 | 3. Dữ liệu rỗng | Empty payload id_card | 400 | VRF_INVALID_BODY — request body invalid: id_card and dscert required |
| 19 | 3. Dữ liệu rỗng | Empty payload DSCert | 400 | VRF_INVALID_BODY — request body invalid: id_card and dscert required |
| 20 | 4. Sai định dạng (request_id) | Quá ngắn (1 ký tự) | 200 | exitcode 0, result true — valid DSCert |
| 21 | 4. Sai định dạng (request_id) | Ký tự đặc biệt | 200 | exitcode 0, result true — valid DSCert |
| 22 | 4. Sai định dạng (request_id) | Chứa khoảng trắng | 200 | exitcode 0, result true — valid DSCert |
| 23 | 4. Sai định dạng (request_id) | Quá dài (100 ký tự) | 200 | exitcode 0, result true — valid DSCert |
| 24 | 4. Sai định dạng (request_time) | Sai chuẩn (YYYY-MM-DD) | 400 | BAD_REQUEST — request_time không đúng định dạng yyyyMMddHHmmss |
| 25 | 4. Sai định dạng (request_time) | Tương lai xa | 400 | BAD_REQUEST — request_time không được lớn hơn thời gian hiện tại |
| 26 | 4. Sai định dạng (request_time) | Quá khứ xa | 400 | BAD_REQUEST — request_time đã quá hạn (chấp nhận trong vòng 10 phút) |
| 27 | 4. Sai định dạng (request_time) | Không phải số | 400 | BAD_REQUEST — request_time không đúng định dạng yyyyMMddHHmmss |
| 28 | 4. Sai định dạng (request_time) | Thiếu giờ phút giây | 400 | BAD_REQUEST — request_time không đúng định dạng yyyyMMddHHmmss |
| 29 | 4. Sai định dạng (license_id) | License không tồn tại | 403 | FORBIDDEN — Không có quyền truy cập tài nguyên này |
| 30 | 4. Sai định dạng (license_id) | License chữ thường | 403 | FORBIDDEN — Không có quyền truy cập tài nguyên này |
| 31 | 4. Sai định dạng (device_type) | Desktop | 500 | INTERNAL_SERVER_ERROR — Lỗi hệ thống, vui lòng thử lại sau |
| 32 | 4. Sai định dạng (device_type) | Web | 500 | INTERNAL_SERVER_ERROR — Lỗi hệ thống, vui lòng thử lại sau |
| 33 | 4. Sai định dạng (device_type) | Là số nguyên | — | Không gửi được: thư viện gọi từ chối header không phải chuỗi |
| 34 | 4. Sai định dạng (id_card) | Thiếu số (11 số) | 500 | VRF_CRYPTO_FAIL — cryptographic wrap failed |
| 35 | 4. Sai định dạng (id_card) | Thiếu nhiều (6 số) | 500 | VRF_CRYPTO_FAIL — cryptographic wrap failed |
| 36 | 4. Sai định dạng (id_card) | Thừa số (13 số) | 400 | VRF_INVALID_ID_CARD — request body invalid: id_card must be 1-12 ASCII digits |
| 37 | 4. Sai định dạng (id_card) | Chứa chữ cái | 400 | VRF_INVALID_ID_CARD — request body invalid: id_card must be 1-12 ASCII digits |
| 38 | 4. Sai định dạng (id_card) | Ký tự đặc biệt | 400 | VRF_INVALID_ID_CARD — request body invalid: id_card must be 1-12 ASCII digits |
| 39 | 4. Sai định dạng (id_card) | Dạng số nguyên (int) | 400 | VRF_INVALID_BODY — request body invalid: not valid JSON |
| 40 | 4. Sai định dạng (id_card) | Boolean | 400 | VRF_INVALID_BODY — request body invalid: not valid JSON |
| 41 | 4. Sai định dạng (DSCert) | Không phải base64 | 500 | VRF_CRYPTO_FAIL — cryptographic wrap failed |
| 42 | 4. Sai định dạng (DSCert) | Chứng chỉ rỗng | 400 | VRF_INVALID_BODY — request body invalid: id_card and dscert required |
| 43 | 4. Sai định dạng (DSCert) | Chứng chỉ giả ngẫu nhiên | 200 | exitcode 0, result false — invalid dscert |
| 44 | 4. Sai định dạng (DSCert) | Chỉ có header BEGIN CERT | 500 | VRF_CRYPTO_FAIL — cryptographic wrap failed |
| 45 | 4. Sai định dạng (Content-Type) | text/plain | 200 | exitcode 0, result true — valid DSCert |
| 46 | 4. Sai định dạng (Content-Type) | application/xml | 200 | exitcode 0, result true — valid DSCert |
| 47 | 4. Sai định dạng (Content-Type) | Thiếu charset | 200 | exitcode 0, result true — valid DSCert |
| 48 | 5. Logic chữ ký | Thay đổi request_id sau khi ký | 400 | BAD_REQUEST — Xác thực chữ ký đối tác thất bại |
| 49 | 5. Logic chữ ký | Thay đổi request_time sau khi ký | 400 | BAD_REQUEST — request_time không đúng định dạng yyyyMMddHHmmss |
| 50 | 5. Logic chữ ký | Thay đổi license_id sau khi ký | 403 | FORBIDDEN — Không có quyền truy cập tài nguyên này |
| 51 | 5. Logic chữ ký | Thay đổi device_type sau khi ký | 400 | BAD_REQUEST — Xác thực chữ ký đối tác thất bại |
| 52 | 5. Logic chữ ký | Thay đổi dia_chi sau khi ký | 400 | BAD_REQUEST — Xác thực chữ ký đối tác thất bại |
| 53 | 5. Logic chữ ký | Thay đổi id_card sau khi ký | 400 | VRF_INVALID_ID_CARD — request body invalid: id_card must be 1-12 ASCII digits |
| 54 | 5. Logic chữ ký | Thay đổi DSCert sau khi ký | 500 | VRF_CRYPTO_FAIL — cryptographic wrap failed |
| 55 | 5. Logic chữ ký | Ký bằng private key rác | 400 | BAD_REQUEST — Xác thực chữ ký đối tác thất bại |
| 56 | 5. Logic chữ ký | Chữ ký rác (không base64) | 400 | BAD_REQUEST — Xác thực chữ ký đối tác thất bại |
| 57 | 5. Logic chữ ký | Chữ ký rỗng | 400 | VRF_MISSING_HEADER — missing required header: signature |
| 58 | 5. Logic chữ ký | Chữ ký chỉ đổi 1 ký tự | 400 | BAD_REQUEST — Xác thực chữ ký đối tác thất bại |
| 66 | 7. Method | Method GET | — | Không có phản hồi (quá 30 giây) |
| 67 | 7. Method | Method PUT | 405 | VRF_METHOD_NOT_ALLOWED — POST required |
| 68 | 7. Method | Method DELETE | 405 | VRF_METHOD_NOT_ALLOWED — POST required |
| 69 | 7. Method | Method PATCH | 405 | VRF_METHOD_NOT_ALLOWED — POST required |
| 70 | 8. Cấu trúc JSON | Gửi dư trường trong payload | 200 | exitcode 0, result true — valid DSCert |
| 71 | 8. Cấu trúc JSON | Gửi dư trường trong header | 200 | exitcode 0, result true — valid DSCert |
| 72 | 8. Cấu trúc JSON | id_card là mảng (Array) | 400 | VRF_INVALID_BODY — request body invalid: not valid JSON |
| 73 | 8. Cấu trúc JSON | DSCert là mảng (Array) | 400 | VRF_INVALID_BODY — request body invalid: not valid JSON |