Gọi API thay khách (resource gateway)
Dùng access_token của HiTechCloud ID để gọi API thay mặt người dùng qua resource gateway https://iam.hitechcloud.vn/api/v1/gw/<route>, giới hạn bằng scope.
Sau khi có access_token, ứng dụng của bạn gọi API thay mặt khách qua resource gateway. Gateway kiểm tra token, đối chiếu scope rồi chuyển tiếp tới các route User API tương ứng.
Gọi gateway
Đặt access_token vào header Bearer và gọi tới https://iam.hitechcloud.vn/api/v1/gw/<route>.
curl 'https://iam.hitechcloud.vn/api/v1/gw/profile' \
-H 'Authorization: Bearer at_opaque_xxx'Danh mục scope
Mỗi route yêu cầu một scope nhất định; token phải được cấp scope đó (ở bước authorize) thì gateway mới cho qua.
| Scope | Cho phép |
|---|---|
openid | Bắt buộc cho OIDC; mở UserInfo |
profile | Đọc họ tên, hồ sơ cơ bản |
email | Đọc địa chỉ email |
offline_access | Nhận refresh_token để gọi lâu dài |
profile:read / profile:write | Đọc / cập nhật hồ sơ khách |
services:read / services:write | Đọc / thao tác dịch vụ đã đăng ký |
domains:read / domains:write | Đọc / quản lý tên miền |
dns:read / dns:write | Đọc / sửa bản ghi DNS |
billing:read / billing:write | Đọc / thao tác hoá đơn, thanh toán |
orders:write | Tạo đơn hàng / đặt dịch vụ |
tickets:read / tickets:write | Đọc / tạo & trả lời ticket hỗ trợ |
Lỗi uỷ quyền
| Lỗi | HTTP | Xử lý |
|---|---|---|
invalid_token | 401 | Token sai/hết hạn/đã thu hồi — làm mới hoặc đăng nhập lại. |
insufficient_scope | 403 | Token thiếu scope cho route này — xin thêm scope rồi cấp lại token. |
Các lỗi này trả kèm header WWW-Authenticate mô tả error và scope còn thiếu, theo RFC 6750.
Sau khi có access_token, ứng dụng của bạn gọi API thay mặt khách qua resource gateway. Gateway kiểm tra token, đối chiếu scope rồi chuyển tiếp tới các route User API tương ứng.
Gọi gateway
Đặt access_token vào header Bearer và gọi tới https://iam.hitechcloud.vn/api/v1/gw/<route>.
Danh mục scope
Mỗi route yêu cầu một scope nhất định; token phải được cấp scope đó (ở bước authorize) thì gateway mới cho qua.
| Scope | Cho phép |
|---|---|
openid | Bắt buộc cho OIDC; mở UserInfo |
profile | Đọc họ tên, hồ sơ cơ bản |
email | Đọc địa chỉ email |
offline_access | Nhận refresh_token để gọi lâu dài |
profile:read / profile:write | Đọc / cập nhật hồ sơ khách |
services:read / services:write | Đọc / thao tác dịch vụ đã đăng ký |
domains:read / domains:write | Đọc / quản lý tên miền |
dns:read / dns:write | Đọc / sửa bản ghi DNS |
billing:read / billing:write | Đọc / thao tác hoá đơn, thanh toán |
orders:write | Tạo đơn hàng / đặt dịch vụ |
tickets:read / tickets:write | Đọc / tạo & trả lời ticket hỗ trợ |
Lỗi uỷ quyền
| Lỗi | HTTP | Xử lý |
|---|---|---|
invalid_token | 401 | Token sai/hết hạn/đã thu hồi — làm mới hoặc đăng nhập lại. |
insufficient_scope | 403 | Token thiếu scope cho route này — xin thêm scope rồi cấp lại token. |
Các lỗi này trả kèm header WWW-Authenticate mô tả error và scope còn thiếu, theo RFC 6750.
curl 'https://iam.hitechcloud.vn/api/v1/gw/profile' \
-H 'Authorization: Bearer at_opaque_xxx'