Dvina MCP

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.

Als Markdown anzeigen

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.

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 erfasst.

Webhook hinzufügen

Ein Webhook sendet die Ereignisse des Livespace – dieselben Einträge wie im Audit-Protokoll – 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.