Dvina MCP

Az API-hozzáférés használata

Hozz létre személyes hozzáférési tokeneket szkriptekhez és MCP-kliensekhez, és küldd el a Livespace eseményeit a saját rendszereidbe webhookokkal.

A Beállítások › API-hozzáférés alatt személyes hozzáférési tokeneket hozhatsz létre, hogy egy szkript vagy MCP-kliens a nevedben használhassa a Dvina szolgáltatást. Az adminisztrátorok ugyanitt webhookokat is hozzáadhatnak, hogy a Livespace eseményeit a saját rendszereikbe küldjék.

Az API-hozzáférés az Enterprise csomag része. Minden tag létrehozhat saját tokeneket; a Webhookok csak a tulajdonosok és az adminisztrátorok számára láthatók.

Token létrehozása

  1. Nyisd meg a Beállításokat, és válaszd az API-hozzáférés lehetőséget.
  2. A Személyes hozzáférési tokenek alatt válaszd a Token létrehozása lehetőséget.
  3. Adj meg egy Nevet, hogy később is tudd, mi használja a tokent.
  4. Válaszd ki a Hozzáférést: Csak olvasás vagy Olvasás és írás.
  5. Válaszd ki a Lejáratot: 30 nap múlva, 90 nap múlva, 365 nap múlva vagy Soha nem jár le.
  6. Válaszd a Token létrehozása lehetőséget.
  7. A Token másolása alatt másold ki a tokent, és tárold biztonságos helyen. Csak ekkor jelenik meg.

A token a nevedben működik abban a Livespace-ben, ahol létrehoztad, az ottani aktuális szerepkörödnek megfelelően. A Csak olvasás token olvasásra használható, de semmit sem adhat hozzá vagy módosíthat.

Ha MCP-klienssel szeretnéd használni a tokent, lásd: Csatlakozás API-kulccsal OAuth helyett.

Token ellenőrzése, cseréje vagy visszavonása

A tokenjeid a Személyes hozzáférési tokenek alatt jelennek meg a hozzáférésükkel együtt. Válassz ki egyet a Kezdete, a Hozzáférés, az Utolsó használat és a Lejárat megtekintéséhez.

  • Token cseréjéhez válaszd a Csere… lehetőséget, majd erősítsd meg a Csere gombbal. Egy új token váltja fel a régit, amely azonnal leáll. Másold ki az új tokent a Token másolása alatt.
  • Token leállításához válaszd a Visszavonás… lehetőséget, majd erősítsd meg a Visszavonás gombbal. Minden, ami ezt a tokent használja, azonnal leáll.

A token létrehozása, cseréje és visszavonása bekerül az auditnaplóba.

Webhook hozzáadása

A webhook elküldi a Livespace eseményeit – az auditnaplóban szereplő bejegyzésekkel megegyező adatokat – egy általad megadott címre.

  1. A Beállítások › API-hozzáférés oldalon, a Webhookok alatt válaszd a Webhook hozzáadása lehetőséget.
  2. Adj meg egy Nevet és az URL-t. Nyilvános HTTPS URL-t használj.
  3. Az Események mezőt hagyd üresen, ha minden eseményt szeretnél megkapni, vagy sorold fel a műveleteket és területeket, például: member.added vagy sharing.*.
  4. Válaszd a Hozzáadás lehetőséget.
  5. Az Aláírási titok másolása alatt másold ki a titkot. Csak ekkor jelenik meg.

Ha a Dvina a Ez a cím nem érhető el a Dvina szolgáltatásból üzenetet jeleníti meg, használj nyilvános HTTPS URL-t.

Minden kérés aláírásának ellenőrzése

A Dvina kötegekben, JSON formátumban küldi az eseményeket, és minden kérést aláír. Az aláírási titokkal ellenőrizd, hogy a kérés a Dvina szolgáltatásból érkezett-e:

  • Minden kérés tartalmaz egy X-Dvina-Signature fejlécet, amelynek formátuma: t=<timestamp>,v1=<signature>.
  • Az aláírás az időbélyegből, egy pontból és a kérés törzséből, az aláírási titkoddal képzett HMAC-SHA256 érték, hexadecimális formátumban.
  • Számítsd ki te is, és hasonlítsd össze. Utasítsd el a kérést, ha az aláírás nem egyezik, vagy az időbélyeg túl régi.

Webhook ellenőrzése vagy módosítása

A webhookjaid a Webhookok alatt jelennek meg az állapotukkal együtt: Bekapcsolva, Szüneteltetve vagy Hibás. Válassz ki egyet a részletei megtekintéséhez.

  • A módosításhoz szerkeszd a Név, URL vagy Események mezőt, majd válaszd a Mentés lehetőséget.
  • A szüneteltetéshez kapcsold ki az Események küldése beállítást. Az események küldésének folytatásához kapcsold be újra.
  • A működés ellenőrzéséhez nézd meg az Állapot mezőt és az Elküldött események számát. A hibás webhooknál megjelenik a Legutóbbi hiba. A Dvina tovább próbálkozik, és rögzíti a hibát az auditnaplóban.
  • A titkos kulcs módosításához válaszd az Új aláírási titkos kulcs… lehetőséget, majd erősítsd meg. A kéréseket azonnal az új titkos kulccsal írja alá a rendszer, ezért rögtön frissítsd a fogadó oldalt.
  • Az eltávolításhoz válaszd a Törlés…, majd a megerősítéshez a Törlés lehetőséget. Ezután már nem küld semmit erre a webhookra a rendszer.