Dvina MCP

Koristite API pristup

Kreirajte lične pristupne tokene za skripte i MCP klijente te šaljite događaje iz svog prostora Livespace u vlastite sisteme putem webhookova.

Prikaži kao Markdown

U Postavke › API pristup kreirate lične pristupne tokene kako bi skripta ili MCP klijent mogli koristiti Dvina u vaše ime. Administratori tu dodaju i webhookove za slanje događaja iz prostora Livespace u vlastite sisteme.

API pristup dostupan je u paketu Enterprise. Svaki član može kreirati vlastite tokene; samo vlasnici i administratori vide Webhookove.

Kreirajte token

  1. Otvorite Postavke i odaberite API pristup.
  2. U odjeljku Lični pristupni tokeni odaberite Kreiraj token.
  3. Unesite Naziv kako biste kasnije znali za šta se token koristi.
  4. Odaberite Pristup: Samo čitanje ili Čitanje i pisanje.
  5. Odaberite kada token Ističe: Za 30 dana, Za 90 dana, Za 365 dana ili Nikada ne ističe.
  6. Odaberite Kreiraj token.
  7. U odjeljku Kopirajte svoj token kopirajte token i sačuvajte ga na sigurnom mjestu. Ovo je jedini put kada se prikazuje.

Token djeluje u vaše ime, u prostoru Livespace u kojem ste ga kreirali, s vašom trenutnom ulogom u tom prostoru. Token s pristupom Samo čitanje može čitati, ali ne može ništa dodavati ni mijenjati.

Za korištenje tokena s MCP klijentom pogledajte Povežite se API ključem umjesto putem OAuth-a.

Provjerite, rotirajte ili opozovite token

Vaši tokeni navedeni su u odjeljku Lični pristupni tokeni, uz prikaz njihovog pristupa. Odaberite token da vidite čime Počinje, njegov Pristup, kada je Posljednji put korišten i kada Ističe.

  • Da zamijenite token, odaberite Rotiraj…, a zatim Rotiraj za potvrdu. Novi token zamjenjuje stari, a stari odmah prestaje raditi. Kopirajte novi token u odjeljku Kopirajte svoj token.
  • Da deaktivirate token, odaberite Opozovi…, a zatim Opozovi za potvrdu. Sve što ga koristi odmah prestaje raditi.

Kreiranje, rotiranje i opozivanje tokena bilježi se u dnevniku revizije.

Dodajte webhook

Webhook šalje događaje iz prostora Livespace, iste zapise kao u dnevniku revizije, na adresu koju odaberete.

  1. U Postavke › API pristup, u odjeljku Webhookovi, odaberite Dodaj webhook.
  2. Unesite Naziv i URL. Koristite javni HTTPS URL.
  3. Polje Događaji ostavite prazno za sve događaje ili navedite radnje i područja, kao što su member.added ili sharing.*.
  4. Odaberite Dodaj.
  5. U odjeljku Kopirajte tajni ključ za potpisivanje kopirajte tajni ključ. Ovo je jedini put kada se prikazuje.

Ako Dvina prikaže poruku Ova adresa nije dostupna iz Dvina, koristite javni HTTPS URL.

Provjerite potpis svakog zahtjeva

Dvina šalje događaje u grupama, u JSON formatu, i potpisuje svaki zahtjev. Koristite tajni ključ za potpisivanje da provjerite je li zahtjev došao iz Dvina:

  • Svaki zahtjev ima zaglavlje X-Dvina-Signature u obliku t=<timestamp>,v1=<signature>.
  • Potpis je HMAC-SHA256 u heksadecimalnom obliku, izračunat nad vremenskom oznakom, tačkom i tijelom zahtjeva, uz korištenje vašeg tajnog ključa za potpisivanje.
  • Izračunajte ga sami i uporedite. Odbijte zahtjev čiji se potpis ne podudara ili čija je vremenska oznaka prestara.

Provjerite ili promijenite webhook

Vaši webhookovi navedeni su pod Webhookovi, uz njihov status: Uključen, Pauziran ili Neuspješan. Odaberite jedan da biste vidjeli njegove detalje.

  • Da biste ga promijenili, uredite Naziv, URL ili Događaje, a zatim odaberite Sačuvaj.
  • Da biste ga pauzirali, isključite Šalji događaje. Ponovo uključite ovu opciju da biste nastavili slanje.
  • Da biste provjerili kako radi, pogledajte njegov Status i broj događaja pod Poslano. Webhook koji ne uspijeva prikazuje Posljednju grešku. Dvina nastavlja pokušavati i bilježi neuspjeh u dnevniku revizije.
  • Da biste promijenili njegovu tajnu za potpisivanje, odaberite Nova tajna za potpisivanje…, a zatim potvrdite. Zahtjevi se odmah potpisuju novom tajnom, pa odmah ažurirajte prijemni sistem.
  • Da biste ga uklonili, odaberite Izbriši…, a zatim Izbriši za potvrdu. Nakon toga mu se više ništa ne šalje.