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 atuar em nome de uma pessoa na sua aplicação, indicando os âmbitos de que precisa.
- A pessoa inicia sessão no ecrã de aprovação alojado pela sua aplicação ou no seu próprio ecrã de consentimento, e vê o nome do agente, se está verificado e os âmbitos que pede.
- A pessoa pode restringir o pedido (menos âmbitos, uma sessão mais curta, apenas algumas das suas organizações) e depois aprová-lo, com uma nova chave de acesso quando as suas definições o exigirem.
- O agente recebe um código de utilização única e troca-o pelos seus próprios tokens. Os tokens de acesso duram no máximo 5 minutos, tal como os de uma pessoa.
- Cada pedido que o agente faz ao seu back-end inclui um token cuja declaração
actidentifica o agente e os âmbitos que a pessoa aprovou.
Ativar e escolher as regras
O acesso de agentes está desativado numa aplicação nova. Ative-o em Authentication > Agent access e, depois, escolha Edit settings:
As pessoas podem desativar qualquer âmbito que disponibilize no ecrã de aprovação, mas nunca o ativar.
As alterações aplicam-se a novas aprovações: as sessões de agente ativas mantêm o que a pessoa aprovou.
Only people approve agent requests (
agent_humans_only) só pode ser alterada por um Owner ou Admin da sua organização Didit, que precisa primeiro de uma passkey na sua própria conta da consola.
Comprova que a pessoa que aprova usou o seu próprio autenticador com verificação do utilizador, nos últimos cinco minutos e associado a esse pedido; não deteta automação em geral.
Para o seu próprio ecrã de consentimento, as chamadas estão em aprovação de agente com passkey.
Integrar na sua aplicação
Os agentes que o suportam encaminham as pessoas para o seu ecrã de aprovação por iniciativa própria. A sua aplicação faz duas coisas: Permita que as pessoas vejam e revoguem os seus agentes. Em React, renderize<ConnectedAgents /> na página de definições da conta: lista os agentes que a pessoa aprovou, cada um com um botão Revogar.
Consulte o início rápido de React.
Verifique a declaração 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 só act os distingue:
O
sid no token de um agente é o ID do acesso que a pessoa concedeu, e GET /session/ rejeita sempre o token de um agente.
Consulte verificar um token no seu servidor para ver as verificações em código.
Acompanhar e revogar na consola
Authentication > Agent access mostra:- At a glance: sessões de agente ativas, sessões aprovadas por pessoas nos últimos 7 dias, pessoas com um agente e revogações deste mês, por pessoas e pela sua equipa.
- Active agent sessions: cada pessoa, o agente com a respetiva descrição e se está verificado, o que pode fazer, a última atividade e quando termina, com um botão Revoke.

Authentication > Agent access.
E-mails e eventos
Quando a sua equipa revoga o acesso de um agente a partir da consola, pode optar por enviar um e-mail à pessoa para a informar de que o acesso foi terminado. O e-mail usa a sua marca, tal como acontece com todos os e-mails de início de sessão. As aprovações e as revogações são registadas como eventossecurity.agent_access_approved e security.agent_access_revoked na cronologia da pessoa. O Didit regista uma aprovação quando a pessoa dá o seu consentimento, mesmo que o agente nunca troque o seu código. Consulte o registo de auditoria de aprovação do agente.