Dvina MCP

Brug API-adgang

Opret personlige adgangstokens til scripts og MCP-klienter, og send hændelser fra dit Livespace til dine egne systemer med webhooks.

Vis som Markdown

I Indstillinger › API-adgang opretter du personlige adgangstokens, så et script eller en MCP-klient kan bruge Dvina på dine vegne. Administratorer kan også tilføje webhooks her for at sende hændelser fra Livespace til deres egne systemer.

API-adgang er inkluderet i Enterprise-abonnementet. Alle medlemmer kan oprette deres egne tokens. Kun ejere og administratorer kan se Webhooks.

Opret et token

  1. Åbn Indstillinger, og vælg API-adgang.
  2. Vælg Opret token under Personlige adgangstokens.
  3. Angiv et Navn, så du senere kan se, hvad der bruger det.
  4. Vælg Adgang: Kun læsning eller Læsning og skrivning.
  5. Vælg, hvornår det Udløber: Om 30 dage, Om 90 dage, Om 365 dage eller Udløber aldrig.
  6. Vælg Opret token.
  7. Kopiér tokenet under Kopiér dit token, og opbevar det et sikkert sted. Det vises kun denne ene gang.

Et token handler på dine vegne i det Livespace, hvor du oprettede det, med den rolle, du har dér nu. Et token med Kun læsning kan læse, men kan ikke tilføje eller ændre noget.

Hvis du vil bruge et token med en MCP-klient, kan du se Opret forbindelse med en API-nøgle i stedet for OAuth.

Kontrollér, udskift eller tilbagekald et token

Dine tokens vises under Personlige adgangstokens sammen med deres adgang. Vælg et token for at se, hvad det Begynder med, dets Adgang, hvornår det Sidst blev brugt, og hvornår det Udløber.

  • Hvis du vil udskifte et token, skal du vælge Udskift… og derefter Udskift for at bekræfte. Et nyt token erstatter det, og det gamle holder straks op med at virke. Kopiér det nye token under Kopiér dit token.
  • Hvis du vil deaktivere et token, skal du vælge Tilbagekald… og derefter Tilbagekald for at bekræfte. Alt, der bruger det, holder straks op med at virke.

Oprettelse, udskiftning og tilbagekaldelse af tokens registreres i revisionsloggen.

Tilføj en webhook

En webhook sender hændelser fra Livespace til en adresse, du vælger. Det er de samme registreringer som i revisionsloggen.

  1. Vælg Tilføj webhook under Webhooks i Indstillinger › API-adgang.
  2. Angiv et Navn og en URL. Brug en offentligt tilgængelig HTTPS-URL.
  3. Lad feltet under Hændelser stå tomt for at modtage alle hændelser, eller angiv handlinger og områder, såsom member.added eller sharing.*.
  4. Vælg Tilføj.
  5. Kopiér hemmeligheden under Kopiér signeringshemmeligheden. Den vises kun denne ene gang.

Hvis Dvina viser Denne adresse kan ikke nås fra Dvina, skal du bruge en offentligt tilgængelig HTTPS-URL.

Kontrollér hver anmodnings signatur

Dvina sender hændelser i grupper som JSON og signerer hver anmodning. Brug signeringshemmeligheden til at kontrollere, at en anmodning kommer fra Dvina:

  • Hver anmodning har en X-Dvina-Signature-header med formatet t=<timestamp>,v1=<signature>.
  • Signaturen er en HMAC-SHA256 i hex-format af tidsstemplet, et punktum og anmodningens indhold, beregnet med din signeringshemmelighed.
  • Beregn den selv, og sammenlign. Afvis en anmodning, hvis signaturen ikke stemmer overens, eller tidsstemplet er for gammelt.

Se eller ændr en webhook

Dine webhooks vises under Webhooks med deres status: Aktiv, Sat på pause eller Fejler. Vælg en webhook for at se detaljerne.

  • Hvis du vil ændre den, skal du redigere dens Navn, URL eller Hændelser og derefter vælge Gem.
  • Hvis du vil sætte den på pause, skal du slå Send hændelser fra. Slå det til igen for at genoptage afsendelsen.
  • Hvis du vil se, hvordan den fungerer, skal du tjekke dens Status, og hvor mange hændelser der er Sendt. En webhook, der fejler, viser sin Seneste fejl. Dvina bliver ved med at forsøge og registrerer fejlen i revisionsloggen.
  • Hvis du vil ændre dens hemmelige nøgle, skal du vælge Ny signeringsnøgle… og derefter bekræfte. Anmodninger signeres med den nye nøgle med det samme, så opdater modtageren straks.
  • Hvis du vil fjerne den, skal du vælge Slet… og derefter Slet for at bekræfte. Der sendes ikke mere til den.