act-Claims im Token, ob eine Anfrage von einem Agenten oder von der Person selbst stammt.
Der Agent-Zugriff ist in jedem Tarif enthalten, ohne zusätzliche Kosten.
So funktioniert es
- Ein KI-Agent bittet darum, in Ihrer Anwendung im Auftrag einer Person zu handeln, und nennt dabei die Scopes, die er benötigt.
- Die Person meldet sich auf der gehosteten Genehmigungsseite Ihrer Anwendung oder auf Ihrer eigenen Einwilligungsseite an. Dort sieht sie den Namen des Agenten, ob dieser verifiziert ist und welche Scopes er anfordert.
- Die Person kann die Anfrage eingrenzen (weniger Scopes, eine kürzere Sitzung, nur einige ihrer Organisationen) und sie dann genehmigen, bei Bedarf mit einem neuen Passkey, sofern Ihre Einstellungen dies verlangen.
- Der Agent erhält einen Einmalcode und tauscht ihn gegen eigene Token ein. Seine Zugriffs-Token sind höchstens 5 Minuten gültig, genau wie die einer Person.
- Jede Anfrage, die der Agent an Ihr Backend stellt, enthält ein Token, dessen
act-Claim den Agenten und die Scopes nennt, die die Person genehmigt hat.
Aktivieren und Regeln festlegen
Der Agent-Zugriff ist für eine neue Anwendung deaktiviert. Aktivieren Sie ihn unter Authentication > Agent access und wählen Sie anschließend Edit settings:
Personen können auf dem Genehmigungsbildschirm jede von Ihnen angebotene Berechtigung deaktivieren, aber nie aktivieren.
Änderungen gelten für neue Genehmigungen: Aktive Agenten-Sitzungen behalten die Berechtigungen, die die Person genehmigt hat.
Only people approve agent requests (
agent_humans_only) kann nur von einem Owner oder Admin Ihrer Didit-Organisation geändert werden, der zuvor einen Passkey für sein eigenes Konsolenkonto eingerichtet haben muss.
Damit wird nachgewiesen, dass die genehmigende Person ihren eigenen Authenticator mit Benutzerverifizierung verwendet hat, innerhalb von fünf Minuten und an diese Anfrage gebunden. Automatisierung wird dadurch nicht allgemein erkannt.
Die Aufrufe für Ihren eigenen Zustimmungsbildschirm finden Sie unter Agent-Genehmigung mit einem Passkey.
Zu Ihrer App hinzufügen
Agenten, die das unterstützen, leiten Personen selbstständig zu Ihrem Genehmigungsbildschirm weiter. Ihre App übernimmt zwei Aufgaben: Ermöglichen Sie Personen, ihre Agenten einzusehen und zu widerrufen. Rendern Sie in React<ConnectedAgents /> auf der Seite mit den Kontoeinstellungen. Die Komponente listet die Agenten auf, die die Person genehmigt hat, jeweils mit einer Schaltfläche Widerrufen.
Siehe React-Schnellstart.
Prüfen Sie den act-Claim in Ihrem Backend.
Das Zugriffstoken eines Agenten ist mit demselben Schlüssel signiert und enthält dieselben typ-, iss- und aud-Werte wie das einer Person. Daher unterscheidet nur act die beiden:
Die
sid im Token eines Agenten ist die ID des Zugriffs, den die Person gewährt hat. GET /session/ lehnt das Token eines Agenten immer ab.
Die Prüfungen im Code finden Sie unter Token auf Ihrem Server verifizieren.
Überwachen und widerrufen in der Konsole
Authentication > Agent access zeigt:- Auf einen Blick: aktive Agent-Sitzungen, Sitzungen, die Personen in den letzten 7 Tagen genehmigt haben, Personen mit einem Agenten sowie Widerrufe in diesem Monat, aufgeschlüsselt nach Personen und nach Ihrem Team.
- Aktive Agent-Sitzungen: jede Person, der Agent mit seiner Beschreibung und der Angabe, ob er verifiziert ist, was er tun kann, seine letzte Aktivität und wann die Sitzung endet, mit einer Schaltfläche Revoke.

Authentication > Agent access.
E-Mails und Ereignisse
Wenn Ihr Team den Zugriff eines Agents in der Konsole widerruft, können Sie wählen, ob die betroffene Person per E-Mail darüber informiert wird. Die E-Mail verwendet Ihr Branding, wie jede Anmelde-E-Mail. Genehmigungen und Widerrufe werden alssecurity.agent_access_approved- und security.agent_access_revoked-Ereignisse in der Zeitleiste der Person erfasst.
Didit erfasst eine Genehmigung, sobald die Person ihre Einwilligung erteilt, auch wenn der Agent seinen Code nie austauscht.
Siehe Audit-Log der Agent-Genehmigung.