REST và Core LTANS Adapter
Ánh xạ danh tính, profile, dữ liệu, thao tác, trạng thái và lỗi từ API sản phẩm tới Core.
Từ REST sản phẩm đến engine bảo quản
WSO2 tiếp nhận API; LTANS API Services thực thi quyền và điều phối; Core LTANS Adapter chuyển contract và giữ ngữ nghĩa; Core thực thi nghiệp vụ được hỗ trợ. Keycloak cấp danh tính/token, không xử lý archive thay Core.
| Thành phần | Trách nhiệm |
|---|---|
| WSO2 API Manager/Gateway | Gateway, công bố API, chính sách truy cập và rate limit; không thay kiểm tra nghiệp vụ. |
| Keycloak | Authorization server/IAM: client, service account, token và federation; JWKS/introspection theo cấu hình. |
| LTANS API Services | Quyền tổ chức/hồ sơ, idempotency, Job và điều phối; tin danh tính đã xác minh. |
| Core LTANS Adapter | Map giao thức, profile, ID, trạng thái và lỗi; giữ byte cùng ngữ nghĩa. |
| Core LTANS | Engine bảo quản theo profile; XMLERS/ERS chỉ công bố theo cú pháp đã kiểm thử. |
| Giao nhận webhook | Nhóm giao nhận thứ chín của mô hình logic; gắn event, retry và dead-letter, không thêm thao tác Core giả. |
Ánh xạ theo chương 11 ADSS v8.3.3
Tài liệu tham chiếu: tháng 3/2024, Document Version 1.0.0, trang 129–136. LTAP/XML và HTTP interface không tự là REST/JSON của Mobile-ID. Adapter/profile phải được kiểm thử theo phiên bản Core thực tế; bảng này là thiết kế mapping.
| Đối tượng/thao tác | Ánh xạ | Điểm kiểm soát |
|---|---|---|
| Danh tính client | OAuth client/service account → mapping backend → clientID đã đăng ký. | Không nhận quyền Core từ clientID tự khai trong JSON. |
| Profile / service | profileId, policyId và serviceID có vai trò riêng; SetPolicyID(profile) được map theo SDK. | Giữ phiên bản policy áp dụng và profile được phép cho client. |
| Archive | POST /v1/archives → kiểm tra byte/custody/profile → Archive Core → biên nhận/Job. | 202 không chứng minh evidence đã sẵn sàng. |
| Status | GET archive/status và Job → tách status giao thức, thực thi và archive state. | granted/rejected không phải VALID/INVALID. |
| Liệt kê ID | GET /v1/archives → filter/pagination/tenant quyền → listids Core nếu hỗ trợ. | Cần chốt filter, sorting, continuation và giới hạn metadata. |
| Verify | POST verification → profile đánh giá → Core verify → VerificationReport. | Job thành công không tự chuyển outcome thành VALID. |
| Export | POST exports, GET export → Core export → manifest/kênh tải byte. | Metadata không chứng minh đã tải hay kiểm chứng gói. |
| Renew | POST /v1/renewals → kiểm tra mode, dữ liệu, quyền → HTTP renewal của Core tham chiếu. | PDF v8.3.3 mô tả Renew Evidence qua HTTP; không suy HTTP là REST/JSON. |
| Delete / disposition | API disposition → retention + mọi hold + approval → Core delete theo profile. | Không ánh xạ lệnh xóa trực tiếp bỏ qua kiểm soát. |
| Data / MIME / path | Byte/kênh ingest → SetData/SetDataType; path chỉ từ connector được phép. | Không cho client chỉ định file hệ thống hoặc URL fetch tùy ý. |
| Reference / IDs | sourceReference, Core transactionId, correlationId, requestId, nonce và idempotency key được giữ riêng. | Nonce chống phát lại không thay idempotency; correlation không cấp quyền. |
| Kết xuất bằng chứng | GetData/timestamp tokens/XML input → resource, kênh byte và báo cáo có nguồn. | Cú pháp thực và công cụ phải được kiểm tra; không đổi nhãn JSON thành XMLERS. |
| Quản trị thuần REST | Legal hold, transfer acknowledgement và webhook có thể thuộc lớp sản phẩm Mobile-ID. | Không gán là thao tác native ADSS nếu chương LTANS không mô tả. |
Phiên bản giao thức cần chốt
PDF tham chiếu mô tả LTAP draft-07; tài liệu adapter kế thừa mô tả draft-08. Cần cố định phiên bản Core, giao thức, SDK, profile và bộ ca tương tác trước công bố tương thích. Không tự coi hai draft hoặc HTTP mode là cùng một REST contract.
Những gì phải giữ qua adapter
Giữ mapping request/correlation/Core transaction/Job, profile/policy phiên bản, custody và byte digest. Timeout không tự cho phép gửi lại lệnh tạo archive. Cùng idempotency key với payload khác bị từ chối ở lớp sở hữu giao dịch. Lỗi Core được chuẩn hóa cho client và giữ diagnostic nội bộ có quyền.