# Brug API-adgang

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

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

## 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](/docs/teams/audit-log).

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.

## Relateret

- [Brug Dvina fra andre apps med MCP](/docs/dvina-mcp/overview)
- [Brug revisionsloggen](/docs/teams/audit-log)
- [Oversigt over teams](/docs/teams/overview)