act no token.
O acesso de agentes está incluído em todos os planos, sem preço separado.
Como funciona
- Um agente de IA pede para agir em nome de uma pessoa na sua aplicação, informando os escopos de que precisa.
- 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.
- 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.
- 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.
- Toda requisição que o agente faz ao seu backend carrega um token cujo claim
actidentifica o agente e os escopos que a pessoa aprovou.
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.

Authentication > Agent access.
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 eventossecurity.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.