管理代理身份验证提供方

在 Agent Identity 身份验证管理器中，您可以通过修改身份验证提供方的详细信息、启用或停用身份验证提供方，或者根据需要删除和恢复身份验证提供方来管理身份验证提供方。

准备工作

  1. 验证您是否选择了正确的身份验证方法。
  2. 验证您是否拥有完成此任务所需的角色。

所需角色

如需获得管理 Agent Identity 身份验证提供方所需的权限，请让您的管理员为您授予项目的Agent Identity Editor (roles/agentidentity.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色包含 管理 Agent Identity 身份验证提供方所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

如需管理 Agent Identity 身份验证提供方，您需要具备以下权限：

  • 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：身份验证提供方的位置。

后续步骤