eKYC — Xác thực VNeID

HiTechCloud eKYC (Xác thực VNeID): kết nối Trung tâm RAR/C06 để xác thực CCCD gắn chip, chia sẻ dữ liệu từ VNeID, xác thực sinh trắc học, SSO và cấp chứng thư số.

Xem Markdown

HiTechCloud eKYC — Xác thực VNeID là cổng kết nối (connector) giúp Đơn vị khai thác (TCDN) tích hợp với Nền tảng định danh và xác thực điện tử của Bộ Công An (C06 / Trung tâm RAR) thông qua Agent Gateway (AgentGW) do HiTechCloud vận hành. HiTechCloud đóng vai trò Tổ chức cung cấp dịch vụ, chuẩn hoá và chuyển tiếp các bản tin API giữa hệ thống của bạn và Nền tảng định danh (NT).

Luồng kết nối

Ứng dụng của bạn kết nối C06/VNeID qua eKYC Gateway của HiTechCloud
Ứng dụng (TCDN)Hệ thống của bạn
HiTechCloud eKYC GatewayAgentGW
C06 / VNeIDNền tảng định danh (NT)
Kết quả xác thựcuserInfo (JWS) · Đúng/Sai

HiTechCloud (AgentGW) chuẩn hoá và chuyển tiếp bản tin giữa hệ thống của bạn và Nền tảng định danh (NT).

Trình tự một giao dịch xác thực dữ liệu công dân
Tạo yêu cầu`agent/init` → `txnId`
Ký yêu cầuCSK RSA-SHA256
Lấy dữ liệu`get-transaction`
Nhận kết quảXác minh chữ ký JWS

Nền tảng cung cấp những gì

Hai lớp dịch vụ

  • Dịch vụ eID (chip CCCD): xác thực trực tiếp DS Certificate đọc từ chip thẻ CCCD. Yêu cầu được ký bằng khoá CSK (RSA-SHA256) — xem Ký yêu cầu & Xác thực.
  • Dịch vụ VNeID (AgentGW): chia sẻ dữ liệu công dân, xác thực sinh trắc học, SSO, định danh tổ chức, cấp CTS — theo luồng consent trên ứng dụng VNeID. Xác thực bằng api_key + target_code theo từng mã dịch vụ (service-code).

Thông tin kết nối API

Hạng mụcGiá trị
Base URL — Productionhttps://ekyc-c06.hitechcloud.vn
Base URL — Sandboxhttps://ekyc-c06-sandbox.hitechcloud.vn
Giao thứcREST / HTTPS, dữ liệu JSON (UTF-8)
Xác thực eIDKý yêu cầu RSA-SHA256 bằng khoá CSK + license_id
Xác thực VNeIDapi_key + target_code theo service-code; SSO dùng OAuth2 Bearer
Kết nối đối tácmTLS (TLS 1.3) + IP/Domain whitelist
Dữ liệu công dânuserInfo đóng gói JWS (ES256), xác minh bằng public key C06 cấp
Tuân thủLuật Bảo vệ dữ liệu cá nhân 2025 (91/2025/QH15), Nghị định 356/2025/NĐ-CP và Thông tư 95/2025/TT-BCA
Dữ liệu công dân (userInfo) và kết quả sinh trắc học (biometricResult) luôn được trả về dưới dạng chuỗi JWS <header>.<payload>.<signature>. Hệ thống của bạn dùng public key do C06 cung cấp để xác minh chữ ký và parse payload — không nhận dữ liệu thô chưa ký.

Từ viết tắt

Viết tắtÝ nghĩa
TCDNTổ chức/doanh nghiệp khai thác dịch vụ (Đơn vị khai thác)
AgentGWAgent Gateway — cổng tiếp nhận do HiTechCloud vận hành
NT / NEIDNền tảng định danh và xác thực điện tử
TTXTTrung tâm xác thực điện tử
RARTrung tâm dữ liệu dân cư / căn cước (Bộ Công An)
CCCDCăn cước công dân gắn chip
DS CertificateChứng thư số lưu trên chip CCCD
CSKClient Signing Key — khoá ký yêu cầu của TCDN
CTSChứng thư số / chữ ký số (SmartCA)

Danh mục tài liệu