Dvina MCP

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.

Visa som Markdown

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.

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.

Lägg till en webhook

En webhook skickar händelser från Livespace, samma poster som i granskningsloggen, 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.