MOBILE-ID · TRUSTED LTANS
Chẩn đoán lỗi theo từng lớp
Phân biệt lỗi TLS, OAuth, gateway, nghiệp vụ và Core; xử lý retry mà không nhân đôi giao dịch.
Đọc lỗi ở đúng lớp
Mã ADSS dưới đây được đối chiếu chương 11.8 của tài liệu tham chiếu; HTTP/code công khai cho lỗi Core phải được adapter chốt. Đây không phải cam kết Core Mobile-ID hiện trả nguyên những mã đó. Không đưa stack trace hoặc thông tin kho/khóa nội bộ ra client.
| Nguồn lỗi | Phạm vi phản hồi | Chẩn đoán | Phục hồi |
|---|---|---|---|
| Bắt tay TLS | Chưa có HTTP | Chứng thư máy chủ/client, hostname, truststore và thời gian. | TLS có thể không có Problem JSON; không tắt kiểm tra. |
| OAuth / IAM | 401 / 403 | Issuer, audience, exp/nbf, scope, key rotation và mapping tổ chức. | Lấy token mới không tự cấp thêm quyền; không log token. |
| Gateway | 429 / 503 theo contract | Quota/rate limit hoặc upstream không đáp ứng; đọc thời gian chờ được công bố. | Giữ idempotency key; đối soát trước thử lại POST. |
| Core 48011 / 48031 / 48032 | Profile không hợp lệ/không được cấp | Đối soát tên, trạng thái và quyền profile với backend mapping. | Mã công khai/HTTP do adapter chốt; không lộ cấu hình nội bộ. |
| Core 48012 / 48013 | Thiếu token / không tạo evidence | Kiểm tra Job, TSA, phiên bản nguồn và log tương quan nội bộ. | Không công bố EvidenceGenerated hoặc EVIDENCE_READY khi chưa có kết quả. |
| Core 48024 / 48025 | Profile chặn thao tác | Kiểm tra deletion policy, retention, hold và thẩm quyền. | Không retry như lỗi mạng; sửa điều kiện theo quyền. |
| Core 48049 / 48051 / 48056 | Sai liên kết/toàn vẹn | Giữ mẫu lỗi và đúng byte/bằng chứng; kiểm tra bước thất bại. | Không đổi mismatch thành VALID hoặc thiếu dữ liệu để che lỗi. |
| Sai lệch chuyển giao | 409 hoặc mã đã chốt | transfer/export/recipient/digest/scope và báo cáo bên nhận. | Không xác nhận hoặc tự xóa nguồn; đối soát phạm vi. |
Thông tin cần gửi khi hỗ trợ
Gửi thời điểm và múi giờ, endpoint, correlationId/requestId, archiveId/jobId được phép, mức ảnh hưởng và bước đã thử. Không gửi token, private key hoặc hồ sơ thật qua kênh khảo sát chung. Giữ nguyên key giao dịch để đối soát; ca không rõ đã commit cần truy vấn trước khi gửi lại.