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.

Xem Markdown

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ụcGiá trị
Issuerhttps://iam.hitechcloud.vn
Discovery (OIDC)https://iam.hitechcloud.vn/api/v1/sso/oauth2/.well-known/openid-configuration
JWKShttps://iam.hitechcloud.vn/api/v1/sso/oauth2/.well-known/jwks.json
AuthorizationGET https://iam.hitechcloud.vn/api/v1/sso/oauth2/authorize
TokenPOST https://iam.hitechcloud.vn/api/v1/sso/oauth2/token
UserInfoGET 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ínhGiá trị
response_types_supportedcode
grant_types_supportedauthorization_code, refresh_token, urn:ietf:params:oauth:grant-type:device_code
code_challenge_methods_supportedS256
token_endpoint_auth_methods_supportedclient_secret_post, none
id_token_signing_alg_values_supportedRS256
subject_types_supportedpublic

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 authorize thiếu code_challenge sẽ bị từ chối. Không chấp nhận plain.
  • 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_token trực tiếp từ authorize).
  • Xác thực client ở token endpoint: client bí mật (confidential) dùng client_secret_post — gửi client_id + client_secret trong thân yêu cầu (application/x-www-form-urlencoded). Client công khai (public, SPA/mobile/CLI) dùng none và 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ạiDùng choXác thực token endpointclient_secret
ConfidentialWeb server có backend giữ được bí mậtclient_secret_postCó — giữ phía máy chủ
PublicSPA, ứng dụng di động, CLI/thiết bịnoneKhô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