> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# KI-Agenten-Zugriff: Benutzer-KI-Agenten in Ihrer App autorisieren

> Didit lässt Nutzer KI-Agenten in Ihrer App in einer eingeschränkten Sitzung autorisieren, die automatisch endet und widerrufbar ist.

Mit dem Agent-Zugriff von Didit Authentication können die Nutzer Ihrer App ihre eigenen KI-Agenten autorisieren, in ihrem Auftrag zu handeln.
Die Person sieht, was der Agent anfordert, und genehmigt es. Der Agent erhält dann eine eigene, eingeschränkte Sitzung, die automatisch endet und die die Person oder Ihr Team jederzeit widerrufen kann.
Ihr Backend erkennt anhand des `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

1. Ein KI-Agent bittet darum, in Ihrer Anwendung im Auftrag einer Person zu handeln, und nennt dabei die Scopes, die er benötigt.
2. 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.
3. Die Person kann die Anfrage eingrenzen (weniger Scopes, eine kürzere Sitzung, nur einige ihrer [Organisationen](https://docs.didit.me/de/authentication/organizations.md)) und sie dann genehmigen, bei Bedarf mit einem neuen Passkey, sofern Ihre Einstellungen dies verlangen.
4. 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.
5. 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.

Die Sitzung des Agenten endet, wenn ihre Lebensdauer abläuft, nach Ihrem Inaktivitäts-Timeout oder wenn die Person oder Ihr Team sie widerruft.

## 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**:

| Einstellung | Optionen | Standard |
| - | - | - |
| What agents can do | **Read only** (`read`): die Kontoinformationen der Person einsehen. **Acts for them** (`act`): die Kontoeinstellungen und Präferenzen der Person ändern. | Keine, bis Sie eine Option wählen |
| Which agents may ask | Derzeit kann jeder Agent eine Anfrage stellen, und der Genehmigungsbildschirm zeigt an, ob er verifiziert ist. Die Beschränkung auf verifizierte Agenten ist noch nicht verfügbar. | Jeder Agent |
| How long a session lasts | 1, 7 oder 30 Tage. | 7 Tage |
| Ends when idle for | 30 Minuten, 2 Stunden oder 24 Stunden. | 2 Stunden |
| How people approve | **A passkey** oder **Their usual sign-in**. | Ein Passkey |
| Only people approve agent requests | Jede Genehmigung erfordert eine neue Assertion mit dem eigenen Passkey der genehmigenden Person. | Aus |

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](https://docs.didit.me/de/authentication/sign-in-methods.md#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](https://docs.didit.me/de/authentication/quickstarts/react.md).

**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:

| `act` | Wer ruft auf | Was zu erlauben ist |
| - | - | - |
| `null` | Die Person. | Was die Person tun darf. |
| `{"sub", "agent", "scopes"}` | Ein KI-Agent, der im Auftrag der Person handelt. | Nur das, was `act.scopes` gewährt, und nur auf den Routen, die Sie für Agenten öffnen. Überall sonst ablehnen. |

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](https://docs.didit.me/de/authentication/tokens-and-jwks.md#token-auf-ihrem-server-prüfen).

## Ü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**.

![Die Seite „Agent access“ in der Didit Business Console mit den Agent-Einstellungen, den Kennzahlen und den aktiven Agent-Sitzungen mit einer Schaltfläche „Revoke“](https://mintcdn.com/didit-0f962782/RpqZjIB1GnUPdMTN/images/authentication/console-agent-access.png?fit=max\&auto=format\&n=RpqZjIB1GnUPdMTN\&q=85\&s=7cc518e37e2ccafa5515eb22e6ef9b8d)

Authentication > Agent access.

Durch das Widerrufen wird die Agent-Sitzung sofort beendet. Sie können die Person außerdem per E-Mail darüber informieren, dass die Sitzung beendet wurde.
Ihr Team kann außerdem alle Agent-Sitzungen einer Person beenden: Wenn Sie eine Person sperren, ihre MFA zurücksetzen oder ihre Sitzungen im Bereich **Users** widerrufen, wird auch ihr Agent-Zugriff widerrufen.

## 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](https://docs.didit.me/de/authentication/branding-and-custom-domain.md#e-mails-zum-anmelden).

Genehmigungen und Widerrufe werden als `security.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](https://docs.didit.me/de/authentication/events-and-webhooks.md#audit-der-agent-genehmigung).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.