Pular para o conteúdo principal
A autenticação da Didit com acesso de agentes permite que as pessoas que usam o seu aplicativo aprovem os próprios agentes de IA para agir em nome delas. A pessoa vê o que o agente está pedindo, aprova, e o agente recebe uma sessão própria, com escopo limitado, que se encerra automaticamente e que a pessoa ou a sua equipe pode revogar a qualquer momento. O seu backend diferencia a requisição de um agente da requisição da pessoa pela declaração act no token. O acesso de agentes está incluído em todos os planos, sem preço separado.

Como funciona

  1. Um agente de IA pede para agir em nome de uma pessoa na sua aplicação, informando os escopos de que precisa.
  2. A pessoa faz login na tela de aprovação hospedada da sua aplicação ou na sua própria tela de consentimento, e vê o nome do agente, se ele é verificado e quais escopos ele solicita.
  3. A pessoa pode restringir a solicitação (menos escopos, uma sessão mais curta, apenas algumas das suas organizações) e, em seguida, aprová-la, com uma nova chave de acesso quando as suas configurações exigirem.
  4. O agente recebe um código de uso único e o troca pelos seus próprios tokens. Os tokens de acesso dele valem no máximo 5 minutos, assim como os de uma pessoa.
  5. Toda requisição que o agente faz ao seu backend carrega um token cujo claim act identifica o agente e os escopos que a pessoa aprovou.
A sessão do agente termina quando o seu tempo de vida expira, após o tempo limite de inatividade configurado por você, ou quando a pessoa ou a sua equipe a revoga.

Ative e escolha as regras

O acesso de agentes vem desativado em uma aplicação nova. Ative-o em Authentication > Agent access e, em seguida, clique em Edit settings: As pessoas podem desativar, na tela de aprovação, qualquer escopo que você oferecer, mas nunca podem ativar um escopo. As alterações valem para as novas aprovações: as sessões de agentes ativas mantêm o que a pessoa aprovou. Somente pessoas aprovam pedidos de agentes (agent_humans_only) só pode ser alterada por um Owner ou Admin da sua organização na Didit, que precisa antes ter uma passkey na própria conta do console. Ela comprova que a pessoa que aprova usou o próprio autenticador com verificação do usuário, dentro de cinco minutos e vinculado àquele pedido; ela não detecta automação de modo geral. Para a sua própria tela de consentimento, as chamadas estão em aprovação de agente com passkey.

Adicione ao seu app

Agentes que oferecem suporte a isso encaminham as pessoas para a sua tela de aprovação por conta própria. Seu app faz duas coisas: Permita que as pessoas vejam e revoguem os seus agentes. No React, renderize <ConnectedAgents /> na página de configurações da conta: ela lista os agentes que a pessoa aprovou, cada um com um botão Revogar. Veja o guia rápido do React. Verifique o claim act no seu backend. O token de acesso de um agente é assinado com a mesma chave e tem os mesmos typ, iss e aud que o de uma pessoa, por isso somente o act os diferencia: O sid no token de um agente é o ID do acesso que a pessoa concedeu, e GET /session/ sempre rejeita o token de um agente. Veja verificar um token no seu servidor para as verificações em código.

Acompanhe e revogue no console

Authentication > Agent access mostra:
  • Visão geral: sessões de agentes ativas, sessões que as pessoas aprovaram nos últimos 7 dias, pessoas com um agente e revogações neste mês, por pessoas e pela sua equipe.
  • Sessões de agentes ativas: cada pessoa, o agente com sua descrição e se ele é verificado, o que ele pode fazer, sua última atividade e quando termina, com um botão Revogar.
A página Agent access no Business Console da Didit, com as configurações do agente, as métricas principais e as sessões de agentes ativas com um botão Revogar

Authentication > Agent access.

Revogar encerra a sessão do agente imediatamente, e você pode enviar um e-mail à pessoa informando que a sessão foi encerrada. Sua equipe também pode encerrar todas as sessões de agentes de uma pessoa: bloquear uma pessoa, redefinir o MFA dela ou revogar as sessões dela em Users também revoga o acesso dela ao agente.

E-mails e eventos

Quando sua equipe revoga o acesso de um agente pelo console, você pode optar por enviar um e-mail à pessoa informando que o acesso foi encerrado. O e-mail usa a sua marca, como todo e-mail de login. As aprovações e revogações são registradas como os eventos security.agent_access_approved e security.agent_access_revoked na linha do tempo da pessoa. A Didit registra uma aprovação quando a pessoa dá consentimento, mesmo que o agente nunca troque o código. Consulte a auditoria de aprovação do agente.
Última modificação em 22 de novembro de 2026