Dvina MCP

API-toegang gebruiken

Maak persoonlijke toegangstokens voor scripts en MCP-clients en stuur met webhooks gebeurtenissen uit je Livespace naar je eigen systemen.

Bekijk als Markdown

In Instellingen › API-toegang maak je persoonlijke toegangstokens, zodat een script of een MCP-client Dvina namens jou kan gebruiken. Beheerders kunnen daar ook webhooks toevoegen om gebeurtenissen uit de Livespace naar hun eigen systemen te sturen.

API-toegang is inbegrepen bij het Enterprise-abonnement. Elk lid kan eigen tokens maken; alleen eigenaren en beheerders zien Webhooks.

Een token maken

  1. Open Instellingen en kies API-toegang.
  2. Kies onder Persoonlijke toegangstokens de optie Token maken.
  3. Voer een Naam in, zodat je later weet waarvoor het token wordt gebruikt.
  4. Kies de Toegang: Alleen lezen of Lezen en schrijven.
  5. Kies wanneer het token Verloopt: Over 30 dagen, Over 90 dagen, Over 365 dagen of Verloopt nooit.
  6. Kies Token maken.
  7. Kopieer het token onder Kopieer je token en bewaar het op een veilige plek. Je krijgt het alleen nu te zien.

Een token werkt namens jou, in de Livespace waarin je het hebt gemaakt, met de rol die je daar op dit moment hebt. Een token met Alleen lezen kan gegevens lezen, maar niets toevoegen of wijzigen.

Als je een token met een MCP-client wilt gebruiken, zie Verbinding maken met een API-sleutel in plaats van OAuth.

Een token controleren, roteren of intrekken

Je tokens staan onder Persoonlijke toegangstokens, met hun toegangsniveau. Kies een token om te zien waarmee het Begint, welke Toegang het heeft, wanneer het Laatst gebruikt is en wanneer het Verloopt.

  • Om een token te vervangen, kies je Roteren… en vervolgens Roteren om te bevestigen. Een nieuw token vervangt het oude, dat meteen niet meer werkt. Kopieer het nieuwe token onder Kopieer je token.
  • Om een token buiten gebruik te stellen, kies je Intrekken… en vervolgens Intrekken om te bevestigen. Alles wat het token gebruikt, werkt meteen niet meer.

Het maken, roteren en intrekken van een token wordt vastgelegd in het auditlogboek.

Een webhook toevoegen

Een webhook stuurt gebeurtenissen uit de Livespace naar een adres dat je zelf kiest. Dit zijn dezelfde registraties als in het auditlogboek.

  1. Kies in Instellingen › API-toegang, onder Webhooks, de optie Webhook toevoegen.
  2. Voer een Naam en de URL in. Gebruik een openbaar toegankelijke HTTPS-URL.
  3. Laat Gebeurtenissen leeg om alle gebeurtenissen te ontvangen, of geef acties en onderdelen op, zoals member.added of sharing.*.
  4. Kies Toevoegen.
  5. Kopieer de geheime sleutel onder Kopieer de geheime ondertekeningssleutel. Je krijgt deze alleen nu te zien.

Als Dvina de melding Dit adres is niet bereikbaar vanuit Dvina toont, gebruik dan een openbaar toegankelijke HTTPS-URL.

De handtekening van elk verzoek controleren

Dvina stuurt gebeurtenissen in batches als JSON en ondertekent elk verzoek. Gebruik de geheime ondertekeningssleutel om te controleren of een verzoek van Dvina afkomstig is:

  • Elk verzoek heeft een X-Dvina-Signature-header zoals t=<timestamp>,v1=<signature>.
  • De handtekening is een HMAC-SHA256 in hexadecimale notatie van de tijdstempel, een punt en de hoofdtekst van het verzoek, gemaakt met je geheime ondertekeningssleutel.
  • Bereken de handtekening zelf en vergelijk deze. Weiger een verzoek als de handtekening niet overeenkomt of de tijdstempel te oud is.

Een webhook bekijken of wijzigen

Je webhooks staan onder Webhooks met hun status: Aan, Gepauzeerd of Mislukt. Kies een webhook om de details te bekijken.

  • Om de webhook te wijzigen, pas je de Naam, URL of Gebeurtenissen aan en kies je Bewaar.
  • Om de webhook te pauzeren, schakel je Gebeurtenissen verzenden uit. Schakel dit weer in om opnieuw gebeurtenissen te verzenden.
  • Om te zien hoe de webhook werkt, bekijk je de Status en hoeveel gebeurtenissen zijn Verzonden. Bij een mislukte webhook wordt de Laatste fout weergegeven. Dvina blijft het proberen en legt de fout vast in het auditlogboek.
  • Om het geheim te wijzigen, kies je Nieuw ondertekeningsgeheim… en bevestig je je keuze. Verzoeken worden meteen met het nieuwe geheim ondertekend, dus werk de ontvanger direct bij.
  • Om de webhook te verwijderen, kies je Verwijder… en vervolgens Verwijder om te bevestigen. Er wordt niets meer naar deze webhook verzonden.