Đăng nhập VNeID (SSO)

Đăng nhập VNeID (SSO) qua HiTechCloud eKYC: tích hợp đăng nhập một lần theo chuẩn OAuth2/OIDC — điều hướng, đổi access token và lấy thông tin người dùng.

Xem Markdown

SSO cho phép công dân đăng nhập ứng dụng của TCDN bằng tài khoản VNeID. Luồng theo chuẩn Authorization Code: điều hướng sang VNeID → nhận code tại redirect_uri → đổi lấy token → lấy thông tin người dùng.

Bước 1: Điều hướng đăng nhập

URL điều hướng sang VNeID
WEB: $[URL-SSO]/auth?response_type=code&client_id=$[client_id]&scope=openid&redirect_uri=$[redirect_uri]
APP: $[UNIVERSAL-LINK-SSO]/$[client_id]

Sau khi đăng nhập thành công, VNeID chuyển hướng về redirect_uri của TCDN kèm code và (tuỳ chọn) encrypt_key:

Redirect URI của TCDN
$[Redirect_uri]?code=$[code]&encrypt_key=$[encrypt_key]

Bước 2: Đổi code lấy token

MethodEndpointservice-code
POST/api/tcdn/{service-code}/api/vneid/form/ssosso-token
cURL lấy token (x-www-form-urlencoded)
curl -X POST "https://ekyc-c06.hitechcloud.vn/api/tcdn/sso-token/api/vneid/form/sso" \
  -H "content-type: application/x-www-form-urlencoded" \
  -H "api_key: YOUR_API_KEY" \
  -H "request_id: 456b0443-8b89-4b4f-810d-fc5e2a04c162" \
  -H "request_time: 31102026094500" \
  --data-urlencode "grant_type=authorization_code" \
  --data-urlencode "client_id=YOUR_CLIENT_ID" \
  --data-urlencode "client_secret=YOUR_CLIENT_SECRET" \
  --data-urlencode "code=CODE_TU_REDIRECT_URI" \
  --data-urlencode "redirect_uri=https://app.tcdn.vn/callback"
Phản hồi token
{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldU",
  "expires_in": 3600,
  "refresh_expires_in": 1800,
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCIgOiAiSldU",
  "token_type": "Bearer",
  "id_token": "Dr4wTq9W07d7k3iK5T6J232CNXFngIhEXojH8nJV2jfiI8NiXQ",
  "session_state": "456b0443-8b89-4b4f-810d-fc5e2a04c162",
  "scope": "openid email profile"
}

Bước 3: Lấy thông tin người dùng

MethodEndpointservice-code
GET/api/tcdn/{service-code}/api/vneid/ssosso-userinfo
cURL lấy userinfo
curl -X GET "https://ekyc-c06.hitechcloud.vn/api/tcdn/sso-userinfo/api/vneid/sso" \
  -H "content-type: application/json; charset=utf-8" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "api_key: YOUR_API_KEY" \
  -H "request_id: 57cf4c7c-ce43-42c2-89f6-5d9e5c88c760" \
  -H "request_time: 31102026094600"
Dữ liệu sau khi giải mã
{
  "accountType": 1,
  "accountLevel": 2,
  "transactionCode": "57cf4c7c-ce43-42c2-89f6-5d9e5c88c760",
  "citizenPid": "030095008791",
  "fullName": "Nguyễn Huy Hoàng",
  "birthDate": "30-11-1995",
  "signature": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpPU0UvSldTIn0=.<payload>.<signature>"
}

Đăng xuất (chỉ Web SSO)

URL đăng xuất
$[URL-LOGOUT]?client_id=$[client_id]&redirect_uri=$[redirect_uri]
Phản hồi token/userinfo có thể trả về dạng mã hoá { data, key } — data mã hoá AES, key là khoá AES đã được mã hoá RSA. Không dùng hàm getQueryParam có sẵn để lấy encrypt_key. Luồng đăng xuất chỉ áp dụng cho Web SSO.