HƯỚNG DẪN TÍCH HỢPHợp đồng tham chiếu

Hướng dẫn Tích hợp Trusted ThingID

Đi từ đăng ký Client đến tích hợp vận hành thực tế có quản trị trong khi vẫn bảo toàn danh tính chủ thể, tổ chức, ủy quyền, ngữ cảnh vật thể, trạng thái, thẩm quyền và bằng chứng.

Hướng dẫn tích hợp Khám phá Trung tâm API Xem API tham chiếu Mở Môi trường thử nghiệm

MÔ HÌNH KẾT NỐI THAM CHIẾU

Một yêu cầu đi qua nhiều ranh giới tin cậy.

Thành công ở lớp truyền dẫn không bao giờ được xem là thẩm quyền pháp lý hoặc chấp thuận nghiệp vụ.

01ỨNG DỤNGNgười dùng hoặc Dịch vụ Client

→

02API GATEWAYĐịnh tuyến · hạn mức · tương quan

→

03ĐỊNH DANH / IAMClient · chủ thể · tổ chức

→

04TRUSTED THINGIDChính sách · trạng thái · bằng chứng

→

05BỘ KẾT NỐIThử lại · đối soát · trạng thái

→

06THẨM QUYỀN BÊN NGOÀIThông tin có thẩm quyền theo miền dữ liệu

BẮT ĐẦU

Từ đăng ký Client đến đưa vào vận hành có bằng chứng.

Dùng trình tự dưới đây làm danh mục kiểm tra khi triển khai.

Đăng ký Client

Đăng ký ứng dụng/Client, chủ sở hữu, môi trường, ranh giới callback và chuyển hướng, cùng tổ chức chịu trách nhiệm.

Chọn môi trường

Tách riêng thông tin xác thực, điểm kết nối và gói bằng chứng cho môi trường thử nghiệm, thí điểm và vận hành thực tế.

Xác thực

Dùng Hồ sơ OAuth/OIDC được phê duyệt và bảo toàn ngữ cảnh Client cùng chủ thể khi cần.

Danh tính & ủy quyền

Truyền ai đang hành động, đại diện tổ chức nào, theo vai trò/ủy quyền nào và mức Bảo đảm nào.

Chọn nhóm API

Phân giải, DPP, Tuyên bố, Bằng chứng, ủy quyền, vòng đời, Tra cứu, Thiết bị tin cậy và Bộ kết nối có Ý nghĩa nghiệp vụ khác nhau.

Trạng thái & bằng chứng

Với các thao tác ghi quan trọng, phải nắm rõ trạng thái trước và sau, phiên bản chính sách, khóa chống trùng lặp và bằng chứng được sinh ra.

Sự kiện & webhook

Xác minh lệnh gọi lại, tương quan sự kiện và thiết kế cơ chế thử lại, mà không suy diễn nghiệp vụ đã thành công chỉ vì việc phân phối thành công.

Lỗi & phục hồi

Xử lý một cách rõ ràng các trường hợp: chính sách từ chối, ủy quyền không hợp lệ, bộ kết nối hết thời gian chờ, trạng thái bên ngoài chưa rõ và việc đối soát.

Môi trường thử nghiệm & kiểm thử tuân thủ

Dùng dữ liệu mô phỏng, trường hợp không hợp lệ và tiêu chí nghiệm thu có bằng chứng trước vận hành thực tế.

Đưa vào vận hành cổng kiểm soát

Khóa cứng phiên bản API và lược đồ, hồ sơ định danh đã phê duyệt, tính tương thích của bộ kết nối, chủ sở hữu vận hành và phương án quay lui.

VÒNG ĐỜI YÊU CẦU

Mỗi yêu cầu quan trọng cần một gói ngữ cảnh nghiệp vụ.

Dùng khung này khi rà soát thiết kế và khi lập bằng chứng kiểm thử.

Chủ thể & tổ chức

Ai khởi tạo và đại diện tổ chức nào.

Thẩm quyền & ủy quyền

vai trò, ủy quyền, Mục đích và Bảo đảm nào làm hành động đủ điều kiện.

Ngữ cảnh vật thể

Định danh chính thức, vật thể đã phân giải và ngữ cảnh DPP/thiết bị nào bị tác động.

Chính sách & trạng thái

Phiên bản chính sách nào sẽ đánh giá yêu cầu, và chuyển trạng thái nào đang được yêu cầu.

Bằng chứng

Tương quan, nguồn gốc dữ liệu, tin cậy thời gian và bằng chứng tham chiếu nào được sinh.

Thẩm quyền bên ngoài

Những dữ kiện nào vẫn thuộc thẩm quyền bên ngoài Trusted ThingID, và trạng thái chưa rõ ràng được đối soát ra sao.

KIỂM SOÁT KỸ THUẬT

Chất lượng tích hợp là chất lượng vận hành.

Thiết kế cho lỗi và khả năng lặp lại trước vận hành thực tế.

Idempotency

Dùng Idempotency-Key cho các thao tác ghi quan trọng và xác định rõ hành vi khi phát lại.

Tương quan

Truyền X-Correlation-ID xuyên suốt API, sự kiện, bộ kết nối và bản ghi bằng chứng.

Thử lại & đối soát

Tách bạch việc thử lại ở tầng truyền tải với việc đối soát trạng thái nghiệp vụ cùng cơ quan thẩm quyền bên ngoài.

Xác minh webhook

Xác minh nguồn, hồ sơ chữ ký và khóa bí mật, định danh sự kiện và các lần gửi trùng lặp.

BƯỚC TIẾP THEO

Đọc tài liệu HTML trước khi tải hợp đồng máy đọc được.

Trung tâm API giải thích mục đích nghiệp vụ, phân quyền, trạng thái, bằng chứng và hành vi khi xảy ra lỗi. Đặc tả thô vẫn được giữ lại cho các công cụ.

Khám phá Trung tâm API Xem API tham chiếu

Đặc tả đọc được bằng máy

Tải OpenAPI YAML Tải AsyncAPI YAML Tải Postman JSON