本頁面由 Cloud Translation API 翻譯而成。

使用 get_token

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。資訊

get_token⁽¹⁾ 公用程式可讓您將 Apigee 憑證換成存取權和重新整理權杖，以便存取 Edge API。憑證也可以與 SAML 搭配使用和 LDAP 的 OAuth2 工作流程實作。

get_token 可讓您執行下列操作：

取得存取權或更新權杖。
將權杖列印至 stdout，以便在變數和指令中使用。
將權杖儲存在磁碟。

接著，您可以在向 Edge API 提出的要求中新增有效的權杖，並在權杖到期時取得新權杖。

前置作業：您必須先安裝 get_token，才能使用該服務。

get_token 語法

get_token 公用程式使用下列語法：

get_token -u USERNAME:PASSWORD [-m MFACODE]

或

get_token -p passcode

在此情況下：

元素	必填與否	說明
`USERNAME`	選填。必須輸入使用者名稱和密碼組合或密碼。	您的 Apigee 使用者名稱，通常是與 Apigee 帳戶相關聯的電子郵件地址。首次呼叫 `get_token` 時，您必須傳送使用者名稱或密碼。不需要傳遞電子郵件寫入憑證，直到存取權和更新權杖過期為止。如果您要快取權杖時，您必須在每次呼叫中指定使用者名稱。
`PASSWORD`	選填。必須輸入使用者名稱和密碼組合或密碼。	您的 Apigee 帳戶密碼。如果您省略密碼，系統會提示您第一次使用 `get_token` 以及進行後續呼叫時，請輸入有效的 PIN 碼重新整理權杖。如果您不想在指令中直接使用密碼，可以改用動態密碼代碼，而非密碼。
`MFACODE`	選用	臨時的六位數多重要素驗證碼驗證碼。使用 `-u` 並啟用 MFA 時，必須提供此代碼。如果省略，系統會提示您 (除非在密碼模式下)。若未啟用 MFA 或者，如果您有事先編寫指令碼的流程，您可以指定 `-m ""` 來避免顯示提示。
`PASSCODE`	選填。必須輸入使用者名稱和密碼或密碼代碼。	一次性密碼可用來取代密碼。使用 SAML IdP 進行驗證時，必須輸入密碼，並可用於透過 LDAP IdP 進行驗證。

例如：

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

如果呼叫成功，stdout 會輸出有效的存取權杖，並將存取及更新 ~/.sso-cli 中的權杖這些權杖可以使用「權杖有效期限」所述。

第一次成功呼叫 get_token 後，就不必加入直到權杖過期為止

首次呼叫 get_token

如果您在第一次呼叫時未指定任何選項，get_token 會提示您包括：

如果使用 SAML 識別資訊提供者 (IDP) 進行驗證，則需要密碼。
您的使用者名稱、密碼和臨時 MFA 代碼。

以下範例會首次呼叫 get_token，並使用使用者名稱/密碼組合，以及選用的雙重驗證碼進行驗證：

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

將存取權杖加進要求

成功呼叫 get_token 後，即可使用存取權杖透過多種方式在呼叫 Edge API 的 Authorization 標頭中傳遞這個字串。您可以：

複製 get_token 回應的內容，並直接插入標頭：

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

合併指令，取得權杖並新增至標頭：

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

請注意，get_token 使用指令替換語法 $(...)，因此測試環境

在 curl 呼叫中呼叫 get_token：

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

請注意，get_token 使用指令替換語法 $(...)，因此測試環境

這些範例要求會取得「ahamilton-eval」的詳細資料並根據貴機構的使命價值觀和目標進行調整完整清單 Edge API 端點，請參閱 Apigee Edge API 參考資料。

將 get_token 與 SAML 和 LDAP 搭配使用

get_token 公用程式可與 SAML、LDAP 或任何其他基礎 IdP 搭配使用。 get_token 支援多個單一登入 (SSO) 登入網址和多個帳戶。擁有多個帳戶的單一使用者會提示您指定使用者名稱每 get_token 次呼叫。

清除 get_token 快取

您可以使用下列選用旗標清除 get_token 快取：

```
--clear-sso-cache
```
清除 $HOME/.sso-cli 下 SSO_LOGIN_URL 的快取目錄，捨棄伺服器的任何快取存取權和重新整理權杖。
```
--clear-all-sso-cache
```
清除 $HOME/.sso-cli 下所有快取權杖的目錄。