Dvina MCP

Používejte přístup přes API

Vytvářejte osobní přístupové tokeny pro skripty a klienty MCP a posílejte události ze svého prostoru Livespace do vlastních systémů pomocí webhooků.

Zobrazit v Markdownu

V Nastavení › Přístup přes API můžete vytvářet osobní přístupové tokeny, aby skript nebo klient MCP mohl používat Dvina vaším jménem. Správci zde také přidávají webhooky, které posílají události z prostoru Livespace do jejich vlastních systémů.

Přístup přes API je součástí tarifu Enterprise. Každý člen může vytvářet vlastní tokeny; Webhooky vidí jen vlastníci a správci.

Vytvořte token

  1. Otevřete Nastavení a vyberte Přístup přes API.
  2. V části Osobní přístupové tokeny vyberte Vytvořit token.
  3. Zadejte Název, abyste později věděli, co token používá.
  4. Vyberte Přístup: Pouze čtení nebo Čtení a zápis.
  5. Vyberte, kdy Vyprší platnost: Za 30 dní, Za 90 dní, Za 365 dní nebo Platnost nikdy nevyprší.
  6. Vyberte Vytvořit token.
  7. V části Zkopírujte si token zkopírujte token a uložte ho na bezpečné místo. Zobrazí se pouze tentokrát.

Token jedná vaším jménem v prostoru Livespace, ve kterém jste ho vytvořili, a používá vaši aktuální roli v tomto prostoru. Token s přístupem Pouze čtení může číst, ale nemůže nic přidávat ani měnit.

Použití tokenu s klientem MCP popisuje část Připojení pomocí klíče API místo OAuth.

Zkontrolujte, obměňte nebo odvolejte token

Vaše tokeny jsou uvedené v části Osobní přístupové tokeny spolu s úrovní přístupu. Vyberte token a podívejte se na údaje Začíná na, Přístup, Poslední použití a Vyprší platnost.

  • Pokud chcete token nahradit, vyberte Obměnit… a potvrďte volbou Obměnit. Nahradí ho nový token a starý okamžitě přestane fungovat. Nový token zkopírujte v části Zkopírujte si token.
  • Pokud chcete token zneplatnit, vyberte Odvolat… a potvrďte volbou Odvolat. Vše, co ho používá, okamžitě přestane fungovat.

Vytvoření, obměna a odvolání tokenu se zaznamenávají do auditního protokolu.

Přidejte webhook

Webhook posílá události z prostoru Livespace, tedy stejné záznamy jako v auditním protokolu, na adresu, kterou zvolíte.

  1. V Nastavení › Přístup přes API v části Webhooky vyberte Přidat webhook.
  2. Zadejte Název a URL. Použijte veřejně dostupnou URL s HTTPS.
  3. Pole Události nechte prázdné, pokud chcete posílat všechny události, nebo uveďte akce a oblasti, například member.added nebo sharing.*.
  4. Vyberte Přidat.
  5. V části Zkopírujte si tajný klíč pro podepisování zkopírujte tajný klíč. Zobrazí se pouze tentokrát.

Pokud Dvina zobrazí zprávu Tato adresa není z Dvina dostupná, použijte veřejně dostupnou URL s HTTPS.

Ověřte podpis každého požadavku

Dvina posílá události v dávkách ve formátu JSON a každý požadavek podepisuje. Pomocí tajného klíče pro podepisování ověřte, že požadavek přišel z Dvina:

  • Každý požadavek má hlavičku X-Dvina-Signature ve tvaru t=<timestamp>,v1=<signature>.
  • Podpis je HMAC-SHA256 v šestnáctkovém zápisu, vypočítaný z časového razítka, tečky a těla požadavku pomocí vašeho tajného klíče pro podepisování.
  • Vypočítejte podpis sami a porovnejte ho. Odmítněte požadavek, jehož podpis se neshoduje nebo jehož časové razítko je příliš staré.

Kontrola nebo změna webhooku

Webhooky najdete v části Webhooky s jejich stavem: Zapnuto, Pozastaveno nebo Selhává. Vyberte webhook a zobrazte jeho podrobnosti.

  • Pokud ho chcete změnit, upravte Název, URL nebo Události a pak vyberte Uložit.
  • Pokud ho chcete pozastavit, vypněte Odesílat události. Opětovným zapnutím odesílání obnovíte.
  • Pokud chcete zjistit, jak funguje, zkontrolujte jeho Stav a počet událostí v poli Odesláno. U selhávajícího webhooku se zobrazuje Poslední chyba. Dvina odesílání dál zkouší a zaznamenává selhání do protokolu auditu.
  • Pokud chcete změnit jeho tajný klíč, vyberte Nový podpisový tajný klíč… a pak změnu potvrďte. Požadavky se okamžitě začnou podepisovat novým tajným klíčem, proto hned aktualizujte příjemce.
  • Pokud ho chcete odstranit, vyberte Smazat… a pak potvrďte výběrem Smazat. Nic dalšího se do něj už neodešle.