Dvina MCP

Përdorni aksesin në API

Krijoni tokenë personalë aksesi për skripte dhe klientë MCP dhe dërgoni ngjarjet e Livespace tuaj në sistemet tuaja përmes webhook-ëve.

Te Cilësimet › Aksesi në API, krijoni tokenë personalë aksesi që një skript ose klient MCP të mund ta përdorë Dvina në emrin tuaj. Administratorët shtojnë aty edhe webhook-e për të dërguar ngjarjet e Livespace në sistemet e tyre.

Aksesi në API përfshihet në planin Enterprise. Çdo anëtar mund të krijojë tokenët e vet; vetëm pronarët dhe administratorët e shohin seksionin Webhook-et.

Krijoni një token

  1. Hapni Cilësimet dhe zgjidhni Aksesi në API.
  2. Te Tokenët personalë të aksesit, zgjidhni Krijo token.
  3. Vendosni një Emër, që më vonë të dini se çfarë e përdor.
  4. Zgjidhni Aksesin: Vetëm lexim ose Lexim dhe shkrim.
  5. Zgjidhni kur Skadon: Pas 30 ditësh, Pas 90 ditësh, Pas 365 ditësh ose Nuk skadon kurrë.
  6. Zgjidhni Krijo token.
  7. Te Kopjoni tokenin tuaj, kopjoni tokenin dhe ruajeni në një vend të sigurt. Ai shfaqet vetëm këtë herë.

Një token vepron në emrin tuaj, në Livespace ku e krijuat, me rolin që keni aktualisht aty. Një token me akses Vetëm lexim mund të lexojë, por nuk mund të shtojë ose ndryshojë asgjë.

Për të përdorur një token me një klient MCP, shihni Lidhuni me një çelës API në vend të OAuth.

Kontrolloni, rinovoni ose revokoni një token

Tokenët tuaj renditen te Tokenët personalë të aksesit, së bashku me aksesin e tyre. Zgjidhni një token për të parë me çfarë Fillon, Aksesin e tij, kur është Përdorur për herë të fundit dhe kur Skadon.

  • Për të zëvendësuar një token, zgjidhni Rinovo…, pastaj Rinovo për të konfirmuar. Një token i ri e zëvendëson dhe i vjetri ndalon së funksionuari menjëherë. Kopjoni tokenin e ri te Kopjoni tokenin tuaj.
  • Për të çaktivizuar një token, zgjidhni Revoko…, pastaj Revoko për të konfirmuar. Çdo gjë që e përdor ndalon së funksionuari menjëherë.

Krijimi, rinovimi dhe revokimi i një tokeni regjistrohen në regjistrin e auditimit.

Shtoni një webhook

Një webhook i dërgon ngjarjet e Livespace, të njëjtat të dhëna si në regjistrin e auditimit, në një adresë që zgjidhni ju.

  1. Te Cilësimet › Aksesi në API, në seksionin Webhook-et, zgjidhni Shto webhook.
  2. Vendosni një Emër dhe URL-në. Përdorni një URL publike HTTPS.
  3. Te Ngjarjet, lëreni fushën bosh për të marrë çdo ngjarje, ose renditni veprime dhe fusha, si member.added ose sharing.*.
  4. Zgjidhni Shto.
  5. Te Kopjoni sekretin e nënshkrimit, kopjoni sekretin. Ai shfaqet vetëm këtë herë.

Nëse Dvina shfaq Kjo adresë nuk është e arritshme nga Dvina, përdorni një URL publike HTTPS.

Kontrolloni nënshkrimin e çdo kërkese

Dvina i dërgon ngjarjet në grupe, në formatin JSON, dhe nënshkruan çdo kërkesë. Përdorni sekretin e nënshkrimit për të kontrolluar që një kërkesë ka ardhur nga Dvina:

  • Çdo kërkesë ka një header X-Dvina-Signature të formës t=<timestamp>,v1=<signature>.
  • Nënshkrimi është një HMAC-SHA256, në format heksadecimal, i vulës kohore, një pike dhe trupit të kërkesës, i krijuar me sekretin tuaj të nënshkrimit.
  • Llogariteni vetë dhe krahasojeni. Refuzoni një kërkesë nëse nënshkrimi i saj nuk përputhet ose nëse vula kohore është tepër e vjetër.

Kontrolloni ose ndryshoni një webhook

Webhook-ët tuaj renditen te Webhook-ët me statusin e tyre: Aktiv, Në pauzë ose Me gabime. Zgjidhni një për të parë hollësitë e tij.

  • Për ta ndryshuar, ndryshoni Emrin, URL-në ose Ngjarjet, pastaj zgjidhni Ruaj.
  • Për ta pezulluar, çaktivizoni Dërgo ngjarje. Aktivizojeni sërish për të rifilluar dërgimin.
  • Për të parë si po funksionon, kontrolloni Statusin dhe sa ngjarje janë Dërguar. Një webhook me gabime shfaq Gabimin e fundit. Dvina vazhdon të provojë dhe e regjistron dështimin në regjistrin e auditimit.
  • Për të ndryshuar sekretin e tij, zgjidhni Sekret i ri nënshkrimi…, pastaj konfirmoni. Kërkesat nënshkruhen menjëherë me sekretin e ri, ndaj përditësoni menjëherë marrësin.
  • Për ta hequr, zgjidhni Fshi…, pastaj Fshi për të konfirmuar. Nuk i dërgohet më asgjë.