# Bruk API-tilgang

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

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](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-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](/docs/teams/audit-log).

## Legg til en webhook

En webhook sender hendelser fra Livespace, de samme oppføringene som i [revisjonsloggen](/docs/teams/audit-log), 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.

## Relatert

- [Bruk Dvina fra andre apper med MCP](/docs/dvina-mcp/overview)
- [Bruk revisjonsloggen](/docs/teams/audit-log)
- [Oversikt over team](/docs/teams/overview)