管理代理程式身分驗證提供者

在代理身分驗證管理員中，您可以編輯驗證供應商的詳細資料、啟用或停用驗證供應商，以及視需要刪除及還原驗證供應商。

事前準備

  1. 確認您選擇的驗證方法正確無誤。
  2. 確認您具備完成這項工作所需的角色。

必要的角色

如要取得管理 Agent Identity 驗證供應商所需的權限，請要求管理員授予專案的Agent Identity 編輯者 (roles/agentidentity.editor) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備管理 Agent Identity 驗證提供者所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

所需權限

如要管理代理程式身分驗證供應商，必須具備下列權限：

  • agentidentity.authProviders.update
  • agentidentity.authProviders.delete

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

編輯驗證提供者

如要更新驗證供應商的說明或驗證詳細資料，請使用Google Cloud 控制台或 Google Cloud CLI。

如要更新驗證供應商，請執行下列指令：

gcloud alpha agent-identity authProviders update AUTH_PROVIDER_NAME \
    --location="LOCATION" \
    --description="NEW_DESCRIPTION" \
    --three-legged-oauth-client-id="NEW_CLIENT_ID" \
    --three-legged-oauth-client-secret="NEW_CLIENT_SECRET" \
    --three-legged-oauth-authorization-url="NEW_ENDPOINT"

更改下列內容：

  • AUTH_PROVIDER_NAME：驗證提供者的名稱。
  • LOCATION：驗證供應商的位置。
  • NEW_DESCRIPTION：驗證供應器的全新說明。
  • NEW_CLIENT_ID：第三方應用程式的新用戶端 ID。
  • NEW_CLIENT_SECRET：第三方應用程式的新用戶端密鑰。
  • NEW_ENDPOINT：第三方授權伺服器的新網址。

啟用或停用驗證提供者

如要暫時停止代理程式使用驗證提供者，但不想刪除驗證提供者，可以停用驗證提供者。你隨時可以重新啟用。

  1. 如要啟用驗證供應商，請執行下列指令：

    gcloud alpha agent-identity authProviders enable AUTH_PROVIDER_NAME \
    --location="LOCATION"

  2. 如要停用驗證供應商，請執行下列指令：

    gcloud alpha agent-identity authProviders disable AUTH_PROVIDER_NAME \
    --location="LOCATION"

更改下列內容：

  • AUTH_PROVIDER_NAME：驗證提供者的名稱。
  • LOCATION：驗證供應商的位置。

刪除驗證提供者

如果不再需要驗證提供者，可以將其刪除。刪除驗證提供者後，該提供者會停用，並進入虛刪除狀態 30 天。在這段期間，您可以視需要還原驗證提供者。30 天後，系統會再花一天時間清除政策，屆時您就能建立名稱相同的驗證供應商。

如要刪除驗證供應商，請執行下列指令：

gcloud alpha agent-identity authProviders delete AUTH_PROVIDER_NAME \
    --location="LOCATION"

更改下列內容：

  • AUTH_PROVIDER_NAME：驗證提供者的名稱。
  • LOCATION：驗證供應商的位置。

還原已刪除的驗證提供者

如果不小心刪除驗證供應商，可以在刪除後的 30 天內，從軟刪除狀態還原。在這段期間內，您可以視需要還原驗證提供者。 30 天後，系統會再花一天時間清除政策，屆時您就能建立同名的授權供應商。

如要還原驗證供應商，請執行下列指令：

gcloud alpha agent-identity authProviders undelete AUTH_PROVIDER_NAME \
    --location="LOCATION"

更改下列內容：

  • AUTH_PROVIDER_NAME：驗證提供者的名稱。
  • LOCATION：驗證供應商的位置。

後續步驟