Dvina MCP

Folosește accesul API

Creează tokenuri de acces personal pentru scripturi și clienți MCP și trimite evenimentele din Livespace către propriile sisteme prin webhookuri.

Vezi în Markdown

În Setări › Acces API, creezi tokenuri de acces personal, astfel încât un script sau un client MCP să poată folosi Dvina în numele tău. Administratorii adaugă tot acolo webhookuri pentru a trimite evenimentele din Livespace către propriile sisteme.

Accesul API este inclus în planul Enterprise. Fiecare membru își poate crea propriile tokenuri; doar proprietarii și administratorii văd Webhookuri.

Creează un token

  1. Deschide Setări și alege Acces API.
  2. În Tokenuri de acces personal, alege Creează token.
  3. Introdu un Nume, ca să știi mai târziu ce îl folosește.
  4. Alege tipul de Acces: Doar citire sau Citire și scriere.
  5. Alege când Expiră: În 30 de zile, În 90 de zile, În 365 de zile sau Nu expiră niciodată.
  6. Alege Creează token.
  7. În Copiază tokenul, copiază tokenul și păstrează-l într-un loc sigur. Aceasta este singura dată când este afișat.

Un token acționează în numele tău, în Livespace-ul în care l-ai creat, cu rolul pe care îl ai acolo în prezent. Un token cu acces Doar citire poate citi, dar nu poate adăuga sau modifica nimic.

Pentru a folosi un token cu un client MCP, consultă Conectează-te cu o cheie API în loc de OAuth.

Verifică, rotește sau revocă un token

Tokenurile tale sunt afișate în Tokenuri de acces personal, împreună cu tipul de acces. Alege un token pentru a vedea cu ce Începe, ce tip de Acces are, când a fost Folosit ultima dată și când Expiră.

  • Pentru a înlocui un token, alege Rotește…, apoi Rotește pentru a confirma. Un token nou îl înlocuiește, iar cel vechi nu mai funcționează imediat. Copiază noul token din Copiază tokenul.
  • Pentru a dezactiva un token, alege Revocă…, apoi Revocă pentru a confirma. Orice îl folosește nu mai funcționează imediat.

Crearea, rotirea și revocarea unui token sunt înregistrate în jurnalul de audit.

Adaugă un webhook

Un webhook trimite evenimentele din Livespace, aceleași înregistrări ca în jurnalul de audit, la o adresă pe care o alegi.

  1. În Setări › Acces API, în Webhookuri, alege Adaugă webhook.
  2. Introdu un Nume și URL-ul. Folosește un URL HTTPS public.
  3. În Evenimente, lasă câmpul gol pentru toate evenimentele sau enumeră acțiuni și zone, precum member.added sau sharing.*.
  4. Alege Adaugă.
  5. În Copiază secretul de semnare, copiază secretul. Aceasta este singura dată când este afișat.

Dacă Dvina afișează Această adresă nu poate fi accesată din Dvina, folosește un URL HTTPS public.

Verifică semnătura fiecărei cereri

Dvina trimite evenimentele în loturi, în format JSON, și semnează fiecare cerere. Folosește secretul de semnare pentru a verifica dacă o cerere provine de la Dvina:

  • Fiecare cerere are un antet X-Dvina-Signature de forma t=<timestamp>,v1=<signature>.
  • Semnătura este un HMAC-SHA256, în format hexazecimal, calculat folosind secretul tău de semnare pentru marcajul temporal, un punct și corpul cererii.
  • Calculează semnătura și compar-o cu cea primită. Respinge o cerere dacă semnătura nu corespunde sau dacă marcajul temporal este prea vechi.

Verifică sau modifică un webhook

Webhookurile tale sunt afișate în secțiunea Webhookuri, împreună cu starea lor: Activ, În pauză sau Cu erori. Alege unul pentru a-i vedea detaliile.

  • Pentru a-l modifica, editează Numele, URL-ul sau Evenimentele, apoi alege Salvează.
  • Pentru a-l pune în pauză, dezactivează Trimite evenimente. Reactivează opțiunea pentru a relua trimiterea.
  • Pentru a vedea cum funcționează, verifică Starea și câte evenimente au fost Trimise. Un webhook cu erori afișează Ultima eroare. Dvina continuă să încerce și înregistrează eșecul în jurnalul de audit.
  • Pentru a-i schimba secretul, alege Secret nou de semnare…, apoi confirmă. Solicitările sunt semnate imediat cu noul secret, așa că actualizează imediat receptorul.
  • Pentru a-l elimina, alege Șterge…, apoi Șterge pentru a confirma. Nu i se mai trimite nimic.