Đă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.
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
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]?code=$[code]&encrypt_key=$[encrypt_key]Bước 2: Đổi code lấy token
| Method | Endpoint | service-code |
|---|---|---|
POST | /api/tcdn/{service-code}/api/vneid/form/sso | sso-token |
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"{
"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
| Method | Endpoint | service-code |
|---|---|---|
GET | /api/tcdn/{service-code}/api/vneid/sso | sso-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"{
"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-LOGOUT]?client_id=$[client_id]&redirect_uri=$[redirect_uri]{ 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.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
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:
Bước 2: Đổi code lấy token
| Method | Endpoint | service-code |
|---|---|---|
POST | /api/tcdn/{service-code}/api/vneid/form/sso | sso-token |
Bước 3: Lấy thông tin người dùng
| Method | Endpoint | service-code |
|---|---|---|
GET | /api/tcdn/{service-code}/api/vneid/sso | sso-userinfo |
Đăng xuất (chỉ Web SSO)
{ 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.WEB: $[URL-SSO]/auth?response_type=code&client_id=$[client_id]&scope=openid&redirect_uri=$[redirect_uri]
APP: $[UNIVERSAL-LINK-SSO]/$[client_id]$[Redirect_uri]?code=$[code]&encrypt_key=$[encrypt_key]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"{
"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"
}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"{
"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>"
}$[URL-LOGOUT]?client_id=$[client_id]&redirect_uri=$[redirect_uri]