# API-Zugriff nutzen

> Erstelle persönliche Zugriffstoken für Skripte und MCP-Clients und sende die Ereignisse deines Livespace über Webhooks an deine eigenen Systeme.

Unter Einstellungen › **API-Zugriff** erstellst du persönliche Zugriffstoken, damit ein Skript oder ein MCP-Client Dvina in deinem Namen nutzen kann. Admins können dort auch Webhooks hinzufügen, um die Ereignisse des Livespace an ihre eigenen Systeme zu senden.

Der API-Zugriff ist im Enterprise-Tarif enthalten. Jedes Mitglied kann eigene Token erstellen; nur Eigentümer und Admins sehen **Webhooks**.

## Token erstellen

1. Öffne die Einstellungen und wähle **API-Zugriff**.
2. Wähle unter **Persönliche Zugriffstoken** die Option **Token erstellen**.
3. Gib einen **Namen** ein, damit du später weißt, wofür das Token verwendet wird.
4. Wähle unter **Zugriff** entweder **Nur lesen** oder **Lesen und schreiben**.
5. Wähle unter **Läuft ab**, wann das Token abläuft: **In 30 Tagen**, **In 90 Tagen**, **In 365 Tagen** oder **Läuft nie ab**.
6. Wähle **Token erstellen**.
7. Kopiere das Token unter **Token kopieren** und bewahre es an einem sicheren Ort auf. Es wird nur dieses eine Mal angezeigt.

Ein Token handelt in deinem Namen, in dem Livespace, in dem du es erstellt hast, und mit deiner dort aktuell gültigen Rolle. Ein Token mit **Nur lesen** kann Daten lesen, aber nichts hinzufügen oder ändern.

Wie du ein Token mit einem MCP-Client verwendest, erfährst du unter [Mit einem API-Schlüssel statt OAuth verbinden](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Token prüfen, rotieren oder widerrufen

Deine Token werden unter **Persönliche Zugriffstoken** mit ihren Zugriffsrechten aufgelistet. Wähle ein Token aus, um zu sehen, womit es **Beginnt**, welchen **Zugriff** es hat, wann es **Zuletzt verwendet** wurde und wann es **Abläuft**.

- **Um ein Token zu ersetzen**, wähle **Rotieren…** und dann zur Bestätigung **Rotieren**. Ein neues Token ersetzt das bisherige, und das alte funktioniert sofort nicht mehr. Kopiere das neue Token unter **Token kopieren**.
- **Um ein Token zu deaktivieren**, wähle **Widerrufen…** und dann zur Bestätigung **Widerrufen**. Alles, was dieses Token verwendet, funktioniert sofort nicht mehr.

Das Erstellen, Rotieren und Widerrufen eines Tokens wird im [Audit-Protokoll](/docs/teams/audit-log) erfasst.

## Webhook hinzufügen

Ein Webhook sendet die Ereignisse des Livespace – dieselben Einträge wie im [Audit-Protokoll](/docs/teams/audit-log) – an eine Adresse deiner Wahl.

1. Wähle unter Einstellungen › **API-Zugriff** im Bereich **Webhooks** die Option **Webhook hinzufügen**.
2. Gib einen **Namen** und die **URL** ein. Verwende eine öffentliche HTTPS-URL.
3. Lass das Feld **Ereignisse** leer, um alle Ereignisse zu erhalten, oder gib Aktionen und Bereiche an, etwa `member.added` oder `sharing.*`.
4. Wähle **Hinzufügen**.
5. Kopiere unter **Signaturgeheimnis kopieren** das Geheimnis. Es wird nur dieses eine Mal angezeigt.

Wenn Dvina die Meldung **Diese Adresse ist von Dvina aus nicht erreichbar** anzeigt, verwende eine öffentliche HTTPS-URL.

### Signatur jeder Anfrage prüfen

Dvina sendet Ereignisse gebündelt als JSON und signiert jede Anfrage. Prüfe mit dem Signaturgeheimnis, ob eine Anfrage von Dvina stammt:

- Jede Anfrage enthält einen `X-Dvina-Signature`-Header wie `t=<timestamp>,v1=<signature>`.
- Die Signatur ist ein hexadezimaler HMAC-SHA256-Wert aus dem Zeitstempel, einem Punkt und dem Inhalt der Anfrage, der mit deinem Signaturgeheimnis erzeugt wird.
- Berechne die Signatur selbst und vergleiche sie. Lehne Anfragen ab, deren Signatur nicht übereinstimmt oder deren Zeitstempel zu alt ist.

## Einen Webhook prüfen oder ändern

Deine Webhooks werden unter **Webhooks** mit ihrem Status aufgelistet: **Aktiv**, **Pausiert** oder **Fehlerhaft**. Wähle einen Webhook aus, um seine Details anzusehen.

- **Zum Ändern** bearbeite **Name**, **URL** oder **Ereignisse** und wähle dann **Speichern**.
- **Zum Pausieren** schalte **Ereignisse senden** aus. Schalte die Option wieder ein, um erneut Ereignisse zu senden.
- **Um zu sehen, wie er funktioniert**, prüfe seinen **Status** und die Anzahl der **Gesendeten** Ereignisse. Bei einem fehlerhaften Webhook wird der **Letzte Fehler** angezeigt. Dvina versucht es weiter und protokolliert den Fehler im Audit-Log.
- **Zum Ändern seines Geheimschlüssels** wähle **Neuer Signaturschlüssel…** und bestätige die Änderung. Anfragen werden sofort mit dem neuen Geheimschlüssel signiert. Aktualisiere deshalb den Empfänger umgehend.
- **Zum Entfernen** wähle **Löschen…** und dann zur Bestätigung **Löschen**. Es wird nichts mehr an diesen Webhook gesendet.

## Verwandte Themen

- [Dvina über MCP aus anderen Apps nutzen](/docs/dvina-mcp/overview)
- [Das Audit-Log nutzen](/docs/teams/audit-log)
- [Teams im Überblick](/docs/teams/overview)