Sử dụng get_token

Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến Tài liệu về Apigee X. thông tin

Tiện ích get_token⁽¹⁾ cho phép bạn trao đổi thông tin xác thực Apigee để lấy mã truy cập và làm mới mà bạn có thể dùng để truy cập vào các API Edge. Bạn cũng có thể sử dụng mã thông báo này với SAML và cách triển khai LDAP của quy trình làm việc OAuth2.

get_token cho phép bạn:

• Lấy mã truy cập hoặc mã làm mới.
• In mã thông báo thành stdout để sử dụng trong các biến và lệnh.
• Lưu trữ mã thông báo trên ổ đĩa.

Sau đó, bạn có thể thêm mã thông báo hợp lệ vào yêu cầu của mình vào API Edge và nhận mã thông báo mới khi mã thông báo của bạn hết hạn.

Điều kiện tiên quyết: Trước khi có thể sử dụng get_token, bạn phải cài đặt tiện ích đó.

cú pháp get_token

Tiện ích get_token sử dụng cú pháp sau:

get_token -u USERNAME:PASSWORD [-m MFACODE]

hoặc

get_token -p passcode

Trong trường hợp:

Ví dụ:

get_token
get_token -u ahamilton@apigee.com:mypassw0rd -m 424242
get_token -p mypass

Lệnh gọi thành công sẽ in mã thông báo truy cập hợp lệ tới stdout và lưu trữ cả hai truy cập và làm mới mã thông báo trong ~/.sso-cli. Bạn có thể sử dụng các mã thông báo này cho đến khi chúng hết hạn, như mô tả trong phần Hết hạn mã thông báo.

Sau lần gọi thành công đầu tiên đến get_token, bạn không cần đưa vào cho đến khi mã thông báo hết hạn.

Gọi get_token lần đầu tiên

Nếu bạn không chỉ định bất kỳ tuỳ chọn nào trong cuộc gọi đầu tiên, get_token sẽ nhắc bạn như sau:

• Mật mã, nếu xác thực với một nhà cung cấp danh tính (IDP) SAML.
• Tên người dùng, mật khẩu và mã xác thực đa yếu tố tạm thời.

Ví dụ sau đây gọi get_token lần đầu tiên và sử dụng tổ hợp tên người dùng/mật khẩu cùng với mã xác thực đa yếu tố (MFA) không bắt buộc để xác thực:

get_token
Enter username:
ahamilton@apigee.com
Enter the password for user 'ahamilton@apigee.com':
[hidden input]
Enter the six-digit code if 'ahamilton@apigee.com' is MFA-enabled or press ENTER:
123456

ey42bGciOiJSUzI1NiJ9.eyJqdGkiOiJhM2YwNjA5ZC1lZTIxLTQ1YjAtOGQyMi04MTQ0MTYxNjNhNTMiLCJzdWIiOiIyZDFl
  <snip>
VlLmNvbSIsInppZCI6InVhYSIsImF1ZCI6WyJlZGdlY2xpIiwic2NpbSIsIm9wZW5pZCIsInBhc3N3b3JkIiwiYXBwcm54242

Thêm mã truy cập vào yêu cầu

Sau khi gọi thành công get_token, bạn có thể sử dụng mã truy cập bằng cách truyền mã này vào tiêu đề Authorization của các lệnh gọi đến API Edge theo một số cách. Bạn có thể:

• Sao chép nội dung của phản hồi get_token rồi chèn trực tiếp vào tiêu đề:

  curl https://api.enterprise.apigee.com/v1/organizations/danger4242-eval \
    -H "Authorization: Bearer B42CnTIYPxr...88NI5Q"

• Kết hợp các lệnh để lấy mã thông báo và thêm mã đó vào tiêu đề:

  token=$(get_token); curl -H "Authorization: Bearer $token" \
    https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval

  Xin lưu ý rằng get_token sử dụng cú pháp thay thế lệnh $(...) để thực thi lệnh này.

• Gọi get_token trong lệnh gọi curl:

  curl -H "Authorization: Bearer $(get_token)" \
    https://api.enterprise.apigee.com/v1/organizations/ahamilton-eval

  Xin lưu ý rằng get_token sử dụng cú pháp thay thế lệnh $(...) để thực thi lệnh này.

Các yêu cầu mẫu này sẽ nhận thông tin chi tiết về tổ chức "ahamilton-eval". Để biết danh sách đầy đủ các điểm cuối của API Edge, hãy xem Tài liệu tham khảo API Apigee Edge.

Dùng get_token với SAML và Giao thức truy cập thư mục hạng nhẹ (LDAP)

Tiện ích get_token có thể được dùng với SAML, Giao thức truy cập thư mục hạng nhẹ (LDAP), hoặc bất kỳ IDP cơ bản nào khác. get_token hỗ trợ sử dụng nhiều URL đăng nhập SSO và nhiều tài khoản. Một người dùng có nhiều tài khoản sẽ được nhắc chỉ định tên người dùng cho từng lệnh gọi get_token.

Xoá bộ nhớ đệm get_token

Bạn có thể sử dụng các cờ không bắt buộc sau để xoá bộ nhớ đệm của get_token:

• --clear-sso-cache

  Xoá thư mục bộ nhớ đệm cho SSO_LOGIN_URL trong $HOME/.sso-cli huỷ mọi quyền truy cập đã lưu vào bộ nhớ đệm và mã làm mới cho máy chủ.

• --clear-all-sso-cache

  Xoá mọi thư mục trong $HOME/.sso-cli, đồng thời loại bỏ mọi mã thông báo đã lưu vào bộ nhớ đệm.

⁽¹⁾ Bản quyền 2023 Google LLC
Công cụ get_token được cung cấp dưới dạng "Phần mềm" trong thoả thuận chi phối việc bạn sử dụng Google Cloud Platform, bao gồm cả Dịch vụ Điều khoản cụ thể có tại https://cloud.google.com/terms/service-terms.