act contenue dans le token.
L’accès des agents est inclus dans chaque forfait, sans tarif distinct.
Fonctionnement
- Un agent IA demande à agir pour une personne de votre application en indiquant les scopes dont il a besoin.
- La personne se connecte sur l’écran d’approbation hébergé de votre application, ou sur votre propre écran de consentement, et voit le nom de l’agent, s’il est vérifié et ce qu’il demande.
- La personne peut restreindre la demande (moins de scopes, une session plus courte, seulement certaines de ses organisations), puis l’approuver, avec une nouvelle clé d’accès si vos paramètres l’exigent.
- L’agent reçoit un code à usage unique et l’échange contre ses propres tokens. Ses tokens d’accès durent au maximum 5 minutes, comme ceux d’une personne.
- Chaque requête que l’agent envoie à votre backend porte un token dont le claim
actdésigne l’agent et les scopes approuvés par la personne.
Activer et choisir les règles
L’accès des agents est désactivé pour une nouvelle application. Activez-le sous Authentication > Agent access, puis sélectionnez Edit settings :
Les personnes peuvent désactiver sur l’écran d’approbation n’importe quelle portée que vous proposez, mais jamais l’activer.
Les modifications s’appliquent aux nouvelles approbations : les sessions d’agent actives conservent ce que la personne a approuvé.
Only people approve agent requests (
agent_humans_only) ne peut être modifié que par un propriétaire ou un administrateur de votre organisation Didit, qui doit d’abord disposer d’une clé d’accès sur son propre compte de console.
Cette option prouve que la personne qui approuve a utilisé son propre authentificateur avec vérification de l’utilisateur, dans les cinq minutes et en lien avec cette demande ; elle ne détecte pas l’automatisation en général.
Pour votre propre écran de consentement, les appels sont décrits dans approbation d’agent avec une clé d’accès.
Ajoutez-le à votre application
Les agents qui le prennent en charge envoient eux-mêmes les personnes vers votre écran d’approbation. Votre application fait deux choses : Permettez aux personnes de voir et de révoquer leurs agents. En React, affichez<ConnectedAgents /> sur la page des paramètres du compte : elle liste les agents approuvés par la personne, chacun avec un bouton Révoquer.
Consultez le démarrage rapide React.
Vérifiez la revendication act sur votre backend.
Le token d’accès d’un agent est signé avec la même clé et porte les mêmes typ, iss et aud que celui d’une personne. Seul act permet donc de les distinguer :
sid dans le token d’un agent est l’ID de l’accès accordé par la personne, et GET /session/ rejette toujours le token d’un agent.
Consultez vérifier un token sur votre serveur pour les contrôles à effectuer dans votre code.
Surveiller et révoquer dans la console
Authentication > Agent access affiche :- En un coup d’œil : les sessions d’agent actives, les sessions approuvées par des personnes au cours des 7 derniers jours, les personnes disposant d’un agent et les révocations du mois en cours, par les personnes et par votre équipe.
- Sessions d’agent actives : pour chaque personne, l’agent avec sa description et son statut de vérification, ce qu’il peut faire, sa dernière activité et la date et l’heure auxquelles sa session se termine, avec un bouton Revoke.

Authentication > Agent access.
E-mails et événements
Lorsque votre équipe révoque l’accès d’un agent depuis la console, vous pouvez choisir d’envoyer un e-mail à la personne concernée pour l’informer que cet accès a pris fin. L’e-mail reprend votre marque, comme chaque e-mail de connexion. Les approbations et les révocations sont enregistrées sous forme d’événementssecurity.agent_access_approved et security.agent_access_revoked dans l’historique de la personne.
Didit enregistre une approbation lorsque la personne donne son consentement, même si l’agent n’échange jamais son code.
Voir Journal d’audit des approbations d’agent.