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ố.
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ì
Xác thực chip CCCD (eID)Kiểm tra tính hợp lệ của chứng thư số (DS Certificate) trên chip thẻ CCCD gắn chip qua Trung tâm RAR.Sinh trắc học khuôn mặtSo khớp ảnh mặt (face matching), chống giả mạo (liveness) và cảnh báo thiết bị rủi ro (deviceRisk).Chia sẻ & xác thực dữ liệuLấy dữ liệu công dân công dân đồng ý chia sẻ từ VNeID hoặc xác thực Đúng/Sai với CSDL dân cư.Đăng nhập VNeID (SSO)Cho phép công dân đăng nhập ứng dụng của bạn bằng tài khoản VNeID theo chuẩn OAuth2/OIDC.Định danh tổ chứcChia sẻ và xác thực thông tin định danh doanh nghiệp (orgPid, mã số thuế, người đại diện).Chứng thư số (CTS)Đăng ký chứng thư chữ ký số (SmartCA) cho cá nhân, tổ chức và cá nhân thuộc tổ chức.
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ục | Giá trị |
|---|---|
| Base URL — Production | https://ekyc-c06.hitechcloud.vn |
| Base URL — Sandbox | https://ekyc-c06-sandbox.hitechcloud.vn |
| Giao thức | REST / HTTPS, dữ liệu JSON (UTF-8) |
| Xác thực eID | Ký yêu cầu RSA-SHA256 bằng khoá CSK + license_id |
| Xác thực VNeID | api_key + target_code theo service-code; SSO dùng OAuth2 Bearer |
| Kết nối đối tác | mTLS (TLS 1.3) + IP/Domain whitelist |
| Dữ liệu công dân | userInfo đó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 |
|---|---|
| TCDN | Tổ chức/doanh nghiệp khai thác dịch vụ (Đơn vị khai thác) |
| AgentGW | Agent Gateway — cổng tiếp nhận do HiTechCloud vận hành |
| NT / NEID | Nền tảng định danh và xác thực điện tử |
| TTXT | Trung tâm xác thực điện tử |
| RAR | Trung tâm dữ liệu dân cư / căn cước (Bộ Công An) |
| CCCD | Căn cước công dân gắn chip |
| DS Certificate | Chứng thư số lưu trên chip CCCD |
| CSK | Client Signing Key — khoá ký yêu cầu của TCDN |
| CTS | Chứng thư số / chữ ký số (SmartCA) |
Danh mục tài liệu
- Bắt đầu nhanh — Gọi API xác thực chip CCCD đầu tiên.
- Mô hình kết nối — Vai trò TCDN ↔ AgentGW ↔ NT/C06.
- Ký yêu cầu & Xác thực — CSK RSA-SHA256, api_key, header.
- Quy trình eKYC đầy đủ — Luồng consent từ VNeID và từ TCDN.
- Bảng mã dịch vụ — Danh sách
service-code. - Mã lỗi & Xử lý lỗi — exitcode, responseCode, HTTP status.
