# Använd API-åtkomst

> Skapa personliga åtkomsttoken för skript och MCP-klienter och skicka händelser från ditt Livespace till dina egna system med webhooks.

I Inställningar › **API-åtkomst** skapar du personliga åtkomsttoken så att ett skript eller en MCP-klient kan använda Dvina som dig. Administratörer kan också lägga till webhooks där för att skicka händelser från Livespace till sina egna system.

API-åtkomst ingår i Enterprise-planen. Alla medlemmar kan skapa egna token. Endast ägare och administratörer ser **Webhooks**.

## Skapa en token

1. Öppna Inställningar och välj **API-åtkomst**.
2. Under **Personliga åtkomsttoken** väljer du **Skapa token**.
3. Ange ett **Namn** så att du senare vet vad den används till.
4. Välj **Åtkomst**: **Endast läsning** eller **Läsning och skrivning**.
5. Välj när den **Upphör att gälla**: **Om 30 dagar**, **Om 90 dagar**, **Om 365 dagar** eller **Upphör aldrig att gälla**.
6. Välj **Skapa token**.
7. Under **Kopiera din token** kopierar du din token och sparar den på en säker plats. Den visas bara den här gången.

En token används som dig, i det Livespace där du skapade den, med den roll du har där just nu. En token med **Endast läsning** kan läsa men inte lägga till eller ändra något.

Om du vill använda en token med en MCP-klient, se [Anslut med en API-nyckel i stället för OAuth](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-oauth).

## Kontrollera, rotera eller återkalla en token

Dina token visas under **Personliga åtkomsttoken** tillsammans med sin åtkomst. Välj en för att se vad den **Börjar med**, dess **Åtkomst**, när den **Senast användes** och när den **Upphör att gälla**.

- **För att ersätta en token**, välj **Rotera…** och sedan **Rotera** för att bekräfta. En ny token ersätter den och den gamla slutar fungera direkt. Kopiera den nya under **Kopiera din token**.
- **För att stoppa en token**, välj **Återkalla…** och sedan **Återkalla** för att bekräfta. Allt som använder den slutar fungera direkt.

När en token skapas, roteras eller återkallas registreras det i [granskningsloggen](/docs/teams/audit-log).

## Lägg till en webhook

En webhook skickar händelser från Livespace, samma poster som i [granskningsloggen](/docs/teams/audit-log), till en adress du väljer.

1. I Inställningar › **API-åtkomst**, under **Webhooks**, väljer du **Lägg till webhook**.
2. Ange ett **Namn** och en **URL**. Använd en offentlig HTTPS-URL.
3. Under **Händelser** lämnar du fältet tomt för att skicka alla händelser, eller listar åtgärder och områden, till exempel `member.added` eller `sharing.*`.
4. Välj **Lägg till**.
5. Under **Kopiera signeringshemligheten** kopierar du hemligheten. Den visas bara den här gången.

Om Dvina visar **Den här adressen kan inte nås från Dvina**, använd en offentlig HTTPS-URL.

### Kontrollera signaturen för varje begäran

Dvina skickar händelser i batcher som JSON och signerar varje begäran. Använd signeringshemligheten för att kontrollera att en begäran kommer från Dvina:

- Varje begäran har en `X-Dvina-Signature`-header i formatet `t=<timestamp>,v1=<signature>`.
- Signaturen är en HMAC-SHA256 i hexadecimalt format, beräknad på tidsstämpeln, en punkt och begärans kropp med din signeringshemlighet.
- Beräkna den själv och jämför. Avvisa en begäran vars signatur inte stämmer eller vars tidsstämpel är för gammal.

## Kontrollera eller ändra en webhook

Dina webhooks visas under **Webhooks** med statusen **På**, **Pausad** eller **Misslyckas**. Välj en för att se detaljerna.

- **För att ändra den**, redigera **Namn**, **URL** eller **Händelser** och välj sedan **Spara**.
- **För att pausa den**, stäng av **Skicka händelser**. Slå på det igen för att börja skicka på nytt.
- **För att se hur det går**, kontrollera dess **Status** och hur många händelser som har **Skickats**. En webhook som misslyckas visar sitt **Senaste fel**. Dvina fortsätter att försöka och registrerar felet i granskningsloggen.
- **För att ändra dess hemlighet**, välj **Ny signeringshemlighet…** och bekräfta sedan. Förfrågningar signeras med den nya hemligheten direkt, så uppdatera mottagaren på en gång.
- **För att ta bort den**, välj **Radera…** och sedan **Radera** för att bekräfta. Inget mer skickas till den.

## Relaterat

- [Använd Dvina från andra appar med MCP](/docs/dvina-mcp/overview)
- [Använd granskningsloggen](/docs/teams/audit-log)
- [Översikt över team](/docs/teams/overview)