Gerenciar provedores de autenticação de identidade do agente

No gerenciador de autenticação do Agent Identity, você gerencia os provedores de autenticação editando os detalhes, ativando ou desativando ou excluindo e restaurando conforme necessário.

Antes de começar

  1. Verifique se você escolheu o método de autenticação correto.
  2. Verifique se você tem os papéis necessários para concluir essa tarefa.

Funções exigidas

Para receber as permissões necessárias para gerenciar provedores de autenticação do Agent Identity, peça ao administrador para conceder a você o papel do IAM Editor do Agent Identity (roles/agentidentity.editor) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para gerenciar provedores de autenticação do Agent Identity. Para acessar as permissões exatas que são necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para gerenciar provedores de autenticação do Agent Identity:

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

Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.

Editar um provedor de autenticação

Para atualizar a descrição ou os detalhes de autenticação de um provedor de autenticação, use o Google Cloud console ou a Google Cloud CLI.

Para atualizar um provedor de autenticação, execute o seguinte comando:

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"

Substitua:

  • AUTH_PROVIDER_NAME: o nome do provedor de autenticação.
  • LOCATION: o local do provedor de autenticação.
  • NEW_DESCRIPTION: uma nova descrição para o provedor de autenticação.
  • NEW_CLIENT_ID: um novo ID do cliente do aplicativo de terceiros.
  • NEW_CLIENT_SECRET: um novo chave secreta do cliente do aplicativo de terceiros.
  • NEW_ENDPOINT: um novo URL do servidor de autorização de terceiros.

Ativar ou desativar um provedor de autenticação

Se você quiser impedir temporariamente que um agente use um provedor de autenticação sem excluí-lo, desative o provedor de autenticação. É possível ativá-lo novamente a qualquer momento.

  1. Para ativar um provedor de autenticação, execute o seguinte comando:

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

  2. Para desativar um provedor de autenticação, execute o seguinte comando:

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

Substitua:

  • AUTH_PROVIDER_NAME: o nome do provedor de autenticação.
  • LOCATION: o local do provedor de autenticação.

Excluir um provedor de autenticação

Quando você não precisar mais de um provedor de autenticação, poderá excluí-lo. A exclusão de um provedor de autenticação o desativa e o coloca em um estado de exclusão reversível por 30 dias. Durante esse período, você pode restaurar o provedor de autenticação, se quiser. Após 30 dias, leva mais um dia para que a política seja limpa. Depois disso, você pode criar um provedor de autenticação com o mesmo nome.

Para excluir um provedor de autenticação, execute o seguinte comando:

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

Substitua:

  • AUTH_PROVIDER_NAME: o nome do provedor de autenticação.
  • LOCATION: o local do provedor de autenticação.

Restaurar um provedor de autenticação excluído

Se você excluir um provedor de autenticação por engano, poderá restaurá-lo do estado de exclusão reversível em até 30 dias após a exclusão. Durante esse período, você pode restaurar o provedor de autenticação, se quiser. Após 30 dias, leva mais um dia para que a política seja limpa. Depois disso, você pode criar um provedor de autenticação com o mesmo nome.

Para restaurar um provedor de autenticação, execute o seguinte comando:

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

Substitua:

  • AUTH_PROVIDER_NAME: o nome do provedor de autenticação.
  • LOCATION: o local do provedor de autenticação.

A seguir