Tích hợp Định danh Điện tử Quốc gia (VNeID)

Giải pháp xác thực người dùng và tự động hóa dữ liệu nhân sự thông qua nền tảng Cơ sở dữ liệu Quốc gia về dân cư.

🛡️

Xác thực Chính chủ

Loại bỏ tài khoản ảo. Đảm bảo nhân viên đăng nhập là người sở hữu CCCD gắn chip hợp pháp.

⚡

Tự động hóa Dữ liệu

eKYC tự động. Tự động điền thông tin nhân sự (Họ tên, Ngày sinh, Quê quán) từ dữ liệu gốc.

⚖️

Tuân thủ Pháp lý

Đáp ứng Nghị định 59/2022/NĐ-CP về định danh và xác thực điện tử.

Đáp ứng NGHỊ ĐỊNH 337/2025/NĐ-CР về hợp đồng lao động điện tử.

Tại sao cần tích hợp VNeID vào App Nhân sự?

Việc tích hợp VNeID không chỉ là một tính năng đăng nhập (Single Sign-On). Nó thay đổi quy trình quản lý hồ sơ nhân sự. Thay vì nhập liệu thủ công và xác minh giấy tờ vật lý, hệ thống có thể truy xuất thông tin đã được xác thực bởi Bộ Công an. Dưới đây là so sánh hiệu quả dự kiến:

Giảm 85% thời gian Onboarding

Nhân viên mới không cần khai báo lại thông tin cơ bản.

Độ chính xác 100%

Dữ liệu được đồng bộ trực tiếp từ CSDL Quốc gia, không có sai sót do nhập liệu.

Kiến trúc Kỹ thuật (OpenID Connect)

Hệ thống VNeID hoạt động như một Identity Provider (IdP) tuân theo chuẩn OAuth 2.0 và OpenID Connect. Dưới đây là mô phỏng tương tác giữa App Nhân sự của bạn và hệ thống VNeID.

Mô phỏng Luồng Xác thực (Auth Code Flow)

👤
Người dùng
Nhân viên
📱
HR App (Client)
Backend Server
🏛️
VNeID (IdP)
Bộ Công an

> Ready to start simulation...

Nhấn "Bước tiếp theo" để xem luồng dữ liệu.

Data Payload Preview
Waiting for interaction...

Thông số Kết nối

  • • Protocol: OAuth 2.0 / OpenID Connect
  • • Grant Type: Authorization Code
  • • Scope yêu cầu: `openid`, `profile`, `email`, `phone`
  • • Encryption: JWE (JSON Web Encryption) cho ID Token

Dữ liệu trả về (Claims)

  • sub: Mã định danh duy nhất
  • name: Họ và tên đầy đủ
  • birthdate: Ngày sinh
  • gender: Giới tính

Quy trình Thủ tục Hành chính

Để kết nối với hệ thống VNeID, doanh nghiệp cần thực hiện các bước pháp lý với Cục Cảnh sát Quản lý hành chính về trật tự xã hội (C06).

1. Đăng ký Nhu cầu Kết nối

Thời gian ước tính: 5-7 ngày làm việc

Gửi công văn đề nghị kết nối, khai thác dữ liệu đến Cục C06. Nêu rõ mục đích sử dụng (Quản lý nhân sự) và các trường dữ liệu cần khai thác.

2. Thẩm định & Ký Hợp đồng

Thời gian ước tính: 2-4 tuần

C06 thẩm định tính pháp lý và hạ tầng an toàn thông tin của doanh nghiệp. Sau khi thông qua, hai bên ký hợp đồng sử dụng dịch vụ xác thực điện tử.

3. Cấp Tài khoản Sandbox (Kỹ thuật)

Thời gian ước tính: 3 ngày

Đội ngũ kỹ thuật nhận tài liệu hướng dẫn (Integration Guide), `Client_ID` và `Client_Secret` cho môi trường thử nghiệm (Sandbox).

4. Kiểm thử & Go-live

Thời gian ước tính: Tùy thuộc tiến độ Dev

Thực hiện kết nối thử nghiệm. Sau khi pass các test case của C06, hệ thống sẽ được cấp Credential cho môi trường Production.

Checklist Sẵn sàng Hệ thống

✓

Hạ tầng SSL/TLS

Redirect URI phải là HTTPS hợp lệ. Chứng chỉ bảo mật phải còn hạn.

✓

Thư viện OIDC Client

Backend hỗ trợ thư viện OIDC (vd: `node-openid-client`, `IdentityModel` cho .NET).

✓

Xử lý JWE (Decryption)

Có khả năng giải mã ID Token (thường được mã hóa JWE bởi VNeID).

✓

Mapping User Database

Cập nhật Schema Database để lưu `sub` (Subject ID) từ VNeID làm khóa ngoại.

Tài nguyên Hỗ trợ

  • Tài liệu Kỹ thuật RAR (C06)
  • Sandbox Environment URL
  • Hotline Hỗ trợ Kỹ thuật

Lưu ý: Việc kết nối yêu cầu tuân thủ nghiêm ngặt các quy định về bảo vệ dữ liệu cá nhân.