Dvina MCP

Bruk API-tilgang

Opprett personlige tilgangstokener for skript og MCP-klienter, og send hendelser fra Livespace til dine egne systemer med webhooks.

Vis som Markdown

I Innstillinger › API-tilgang oppretter du personlige tilgangstokener, slik at et skript eller en MCP-klient kan bruke Dvina på dine vegne. Administratorer legger også til webhooks der for å sende hendelser fra Livespace til sine egne systemer.

API-tilgang er inkludert i Enterprise-abonnementet. Alle medlemmer kan opprette sine egne tokener. Bare eiere og administratorer ser Webhooks.

Opprett et token

  1. Åpne Innstillinger og velg API-tilgang.
  2. Under Personlige tilgangstokener velger du Opprett token.
  3. Skriv inn et Navn, slik at du senere vet hva som bruker det.
  4. Velg Tilgang: Kun lesing eller Lesing og skriving.
  5. Velg når det Utløper: Om 30 dager, Om 90 dager, Om 365 dager eller Utløper aldri.
  6. Velg Opprett token.
  7. Under Kopier tokenet ditt kopierer du tokenet og oppbevarer det på et trygt sted. Dette er den eneste gangen det vises.

Et token handler på dine vegne i det Livespace du opprettet det i, med rollen du har der nå. Et token med Kun lesing kan lese, men kan ikke legge til eller endre noe.

Hvis du vil bruke et token med en MCP-klient, kan du se Koble til med en API-nøkkel i stedet for OAuth.

Kontroller, roter eller tilbakekall et token

Tokenene dine er oppført under Personlige tilgangstokener, sammen med tilgangen de har. Velg et token for å se hva det Starter med, hvilken Tilgang det har, når det Sist ble brukt, og når det Utløper.

  • For å erstatte et token velger du Roter… og deretter Roter for å bekrefte. Et nytt token erstatter det, og det gamle slutter å virke med en gang. Kopier det nye tokenet under Kopier tokenet ditt.
  • For å stoppe et token velger du Tilbakekall… og deretter Tilbakekall for å bekrefte. Alt som bruker det, slutter å virke med en gang.

Oppretting, rotasjon og tilbakekalling av tokener registreres i revisjonsloggen.

Legg til en webhook

En webhook sender hendelser fra Livespace, de samme oppføringene som i revisjonsloggen, til en adresse du velger.

  1. I Innstillinger › API-tilgang, under Webhooks, velger du Legg til webhook.
  2. Skriv inn et Navn og en URL. Bruk en offentlig HTTPS-URL.
  3. Under Hendelser lar du feltet stå tomt for å få alle hendelser, eller angir handlinger og områder, for eksempel member.added eller sharing.*.
  4. Velg Legg til.
  5. Under Kopier signeringshemmeligheten kopierer du hemmeligheten. Dette er den eneste gangen den vises.

Hvis Dvina sier Denne adressen kan ikke nås fra Dvina, bruker du en offentlig HTTPS-URL.

Kontroller signaturen til hver forespørsel

Dvina sender hendelser i grupper, som JSON, og signerer hver forespørsel. Bruk signeringshemmeligheten til å kontrollere at en forespørsel kom fra Dvina:

  • Hver forespørsel har en X-Dvina-Signature-header på formen t=<timestamp>,v1=<signature>.
  • Signaturen er en HMAC-SHA256 i heksadesimal form, beregnet fra tidsstempelet, et punktum og forespørselskroppen med signeringshemmeligheten din.
  • Beregn den selv og sammenlign. Avvis forespørsler der signaturen ikke stemmer, eller tidsstempelet er for gammelt.

Se eller endre en webhook

Webhookene dine vises under Webhooks med statusen På, Satt på pause eller Feiler. Velg en webhook for å se detaljene.

  • For å endre den, rediger Navn, URL eller Hendelser, og velg deretter Lagre.
  • For å sette den på pause, slå av Send hendelser. Slå det på igjen for å begynne å sende igjen.
  • For å se hvordan den fungerer, sjekk Status og hvor mange hendelser som er Sendt. En webhook som feiler, viser Siste feil. Dvina fortsetter å prøve og registrerer feilen i revisjonsloggen.
  • For å endre hemmeligheten, velg Ny signeringshemmelighet…, og bekreft deretter. Forespørsler signeres med den nye hemmeligheten med en gang, så oppdater mottakeren umiddelbart.
  • For å fjerne den, velg Slett…, og deretter Slett for å bekrefte. Det sendes ikke noe mer til den.