Saltar para o conteúdo principal
O acesso de agentes do Didit Authentication permite que as pessoas que usam a sua aplicação aprovem os seus próprios agentes de IA para agirem em seu nome. A pessoa vê o que o agente pede, aprova-o, e o agente recebe uma sessão própria, com âmbito limitado, que termina automaticamente e que a pessoa ou a sua equipa pode revogar a qualquer momento. O seu backend distingue o pedido de um agente do pedido da pessoa através da reivindicaçã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 atuar em nome de uma pessoa na sua aplicação, indicando os âmbitos de que precisa.
  2. 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.
  3. 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.
  4. 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.
  5. Cada pedido que o agente faz ao seu back-end inclui um token cuja declaração act identifica o agente e os âmbitos que a pessoa aprovou.
A sessão do agente termina quando expira o seu tempo de vida, após o tempo limite de inatividade definido por si, ou quando a pessoa ou a sua equipa a revogam.

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.
A página Agent access na Didit Business Console, com as definições do agente, as métricas principais e as sessões de agente ativas com um botão Revoke

Authentication > Agent access.

Revogar termina de imediato a sessão do agente, e pode enviar um e-mail à pessoa a informar que a sessão terminou. A sua equipa também pode terminar todas as sessões de agente de uma pessoa: bloquear uma pessoa, repor o respetivo MFA ou revogar as suas sessões em Users também revoga o respetivo acesso ao agente.

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 eventos security.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.
Última modificação em 22 de novembro de 2026