Tổng quan & Discovery
HiTechCloud ID là máy chủ OAuth 2.0 / OpenID Connect của HiTechCloud (issuer https://iam.hitechcloud.vn). Trang này mô tả discovery, JWKS, các grant type được hỗ trợ, PKCE bắt buộc và phương thức xác thực client.
HiTechCloud ID (iam.hitechcloud.vn) là nhà cung cấp danh tính chung của toàn hệ sinh thái HiTechCloud. Ứng dụng của bạn dùng chuẩn OAuth 2.0 và OpenID Connect (OIDC) để cho khách đăng nhập một lần bằng tài khoản HiTechCloud, rồi nhận access_token gọi API thay khách và id_token để biết họ là ai.
Mọi endpoint đều chạy trên HTTPS. Issuer (giá trị iss trong mọi id_token) luôn đúng bằng https://iam.hitechcloud.vn — hãy so khớp chính xác chuỗi này khi xác minh token.
Các điểm cuối chính
| Mục | Giá trị |
|---|---|
| Issuer | https://iam.hitechcloud.vn |
| Discovery (OIDC) | https://iam.hitechcloud.vn/api/v1/sso/oauth2/.well-known/openid-configuration |
| JWKS | https://iam.hitechcloud.vn/api/v1/sso/oauth2/.well-known/jwks.json |
| Authorization | GET https://iam.hitechcloud.vn/api/v1/sso/oauth2/authorize |
| Token | POST https://iam.hitechcloud.vn/api/v1/sso/oauth2/token |
| UserInfo | GET https://iam.hitechcloud.vn/api/v1/sso/oauth2/userinfo |
| Revocation (RFC 7009) | POST https://iam.hitechcloud.vn/api/v1/sso/oauth2/revoke |
| Device Authorization (RFC 8628) | POST https://iam.hitechcloud.vn/api/v1/sso/oauth2/device_authorization |
| Dynamic Registration (RFC 7591) | POST https://iam.hitechcloud.vn/api/v1/sso/oauth2/register |
Luôn đọc discovery document lúc khởi động và dùng các URL trong đó thay vì ghi cứng. Cấu hình máy chủ có thể bổ sung endpoint theo thời gian; discovery là nguồn chính thức.
Những gì được hỗ trợ
| Thuộc tính | Giá trị |
|---|---|
response_types_supported | code |
grant_types_supported | authorization_code, refresh_token, urn:ietf:params:oauth:grant-type:device_code |
code_challenge_methods_supported | S256 |
token_endpoint_auth_methods_supported | client_secret_post, none |
id_token_signing_alg_values_supported | RS256 |
subject_types_supported | public |
Quy tắc bắt buộc
- PKCE với `S256` là BẮT BUỘC cho mọi client (cả public lẫn confidential). Yêu cầu
authorizethiếucode_challengesẽ bị từ chối. Không chấp nhậnplain. - Chỉ cấp `code`: luồng duy nhất để lấy token qua trình duyệt là Authorization Code. Không hỗ trợ implicit (
token/id_tokentrực tiếp từauthorize). - Xác thực client ở token endpoint: client bí mật (confidential) dùng
client_secret_post— gửiclient_id+client_secrettrong thân yêu cầu (application/x-www-form-urlencoded). Client công khai (public, SPA/mobile/CLI) dùngnonevà chỉ dựa vào PKCE. - KHÔNG dùng HTTP Basic: đừng gửi
Authorization: Basic base64(client_id:client_secret). Máy chủ không nhận phương thức này; hãy đặt thông tin client vào thân form. - `id_token` ký bằng RS256: xác minh chữ ký bằng khoá công khai lấy từ JWKS endpoint (xoay khoá định kỳ, nên cache theo
kid).
Chọn loại client
| Loại | Dùng cho | Xác thực token endpoint | client_secret |
|---|---|---|---|
| Confidential | Web server có backend giữ được bí mật | client_secret_post | Có — giữ phía máy chủ |
| Public | SPA, ứng dụng di động, CLI/thiết bị | none | Không — bảo vệ bằng PKCE |
Không bao giờ nhúng
client_secret vào mã chạy trên trình duyệt, ứng dụng di động hay CLI phân phối cho người dùng. Những ứng dụng đó phải là public client và dựa vào PKCE.Đọc tiếp
- Đăng nhập bằng HiTechCloud ID — luồng Authorization Code + PKCE đầy đủ.
- ID token & UserInfo — xác minh danh tính khách.
- Làm mới & thu hồi token — vòng đời token.
- Mã lỗi OAuth / OIDC — bảng mã lỗi chuẩn.