Get Access Token cho API vServer sử dụng tool Postman

Get Access Token cho API vServer sử dụng tool Postman

GreenNodeHelp Center

Hướng dẫn lấy Access Token để gọi vServer API

Mô tả cách tạo Service Account và lấy Access Token thông qua Postman, phục vụ việc xác thực các request tới vServer API.

1. Tổng quan

Mọi request gửi tới vServer API (https://vserver-api-docs.vngcloud.vn/service-docs/vserver.html) đều yêu cầu một Access Token hợp lệ trong phần header xác thực. Để lấy được Access Token, trước tiên cần có cặp thông tin client_id và client_secret từ một Service Account đã được khởi tạo trên hệ thống VNG Cloud.

2. Tạo Service Account để lấy thông tin xác thực

Bước 1: Truy cập trang quản lý Service Account theo hướng dẫn tại https://docs.vngcloud.vn/display/ONVINA/Service+accounts và tiến hành tạo một Service Account mới.

Sau khi tạo thành công, hệ thống sẽ cấp cặp thông tin xác thực như minh họa dưới đây:

Màn hình Service Account hiển thị Client ID và Client Secret

Ghi lại hai giá trị này để dùng ở bước tiếp theo. Ví dụ:

  • Client ID: 16614e47-746d-462f-aba2-dabad8xxxxx
  • Client Secret: 5e564687-2d90-42d8-a053-xxxxxxxx
⚠ Lưu ý: Client Secret chỉ hiển thị một lần tại thời điểm tạo. Hãy lưu lại ngay, nếu mất sẽ cần tạo lại Service Account.

3. Lấy Access Token bằng Postman

Bước 2: Mở Postman, chọn New → HTTP Request để tạo một request mới.

Bước 3: Chuyển sang tab Authorization, chọn kiểu xác thực OAuth 2.0, sau đó điền các thông tin sau vào phần cấu hình:

  • Access Token URL:
https://iamapis.vngcloud.vn/accounts-api/v2/auth/token
  • Client ID: giá trị client_id lấy từ Bước 1
  • Client Secret: giá trị client_secret lấy từ Bước 1

Tham khảo hình minh họa cấu hình dưới đây:

Cấu hình OAuth 2.0 trong Postman với Access Token URL và thông tin Client

Bước 4: Nhấn Get New Access Token để Postman gửi yêu cầu xác thực và nhận về token.

Kết quả sau khi nhấn Get New Access Token trong Postman

Hộp thoại xác nhận token trả về từ IAM API

Bước 5: Sao chép Access Token vừa nhận được và đính kèm vào header Authorization của các request gọi tới vServer API.

▸ Token có thời hạn sử dụng nhất định; khi hết hạn cần lặp lại Bước 3–4 để lấy token mới.

▸ Không chia sẻ Access Token ra bên ngoài — token mang đầy đủ quyền của Service Account tương ứng.

✅ Hoàn tất: Hoàn tất. Bạn đã có Access Token hợp lệ và có thể bắt đầu gọi các endpoint của vServer API.

Tài liệu tham khảo

    • Related Articles

    • Hướng dẫn sử dụng vstorage api HAN02 lấy tempURL để upload file

      Help Center Hướng dẫn tạo Token và upload file qua Temp URL trên vStorage API HAN01 Mô tả các bước xác thực bằng Service Account và sử dụng Temp URL để upload object lên vStorage tại region HAN01. 1. Tạo Authen Token Bước 1: Truy cập trang quản lý ...

    • Hướng dẫn sử dụng Storage Gateway

      Help Center Hướng Dẫn Cấu Hình và Sử Dụng Storage Gateway VNG Cloud Hướng dẫn từng bước để truy cập, cấu hình Credential, tạo user, tạo file share và kết nối client NFS/SMB với Storage Gateway. 1. Truy Cập Storage Gateway Bước 1: Sau khi khởi tạo ...

    • Hướng dẫn thay đổi IP private cho vServer

      Help Center Thay đổi Private IP cho vServer Hướng dẫn thay đổi địa chỉ IP nội bộ của vServer thông qua portal và cấu hình lại trực tiếp trên hệ điều hành. ⚠ Lưu ý: Quá trình thay đổi IP sẽ khiến network interface tạm thời bị down, làm gián đoạn kết ...

    • Hướng dẫn generate Token để tạo Temp URL upload file trong vStorage API

      Generate Authen Token: - Truy cập https://iam.console.vngcloud.vn/service-accounts để tạo Service Account để lấy cặp ClientID và SecretID cho project vStorage Client ID: ec2d4f62-6580-406e-95e3-b17xxxxxxx Secret ID: 4ec7b98b-df1c-480e-bc01-38fxxxxxxx ...

    • Hướng dẫn setup HA nginx đơn giản bằng keepalived sử dụng VIP

      Help Center Cấu hình High Availability với VIP, NGINX và Keepalived trên VNG Cloud Hướng dẫn triển khai cụm HA sử dụng Virtual IP Address kết hợp NGINX và keepalived trên nền tảng VNG Cloud, đảm bảo dịch vụ tiếp tục hoạt động khi một node gặp sự cố. ...