Dvina MCP

Користите приступ API-ју

Креирајте личне приступне токене за скрипте и MCP клијенте и шаљите догађаје из свог простора Livespace у сопствене системе помоћу веб-хукова.

Прикажи као Markdown

У одељку Подешавања › Приступ API-ју креирате личне приступне токене да би скрипта или MCP клијент могли да користе Dvina у ваше име. Администратори ту додају и веб-хукове за слање догађаја из простора Livespace у сопствене системе.

Приступ API-ју је доступан у оквиру плана Enterprise. Сваки члан може да креира своје токене; само власници и администратори виде Веб-хукове.

Креирајте токен

  1. Отворите Подешавања и изаберите Приступ API-ју.
  2. У одељку Лични приступни токени изаберите Креирај токен.
  3. Унесите Назив да бисте касније знали шта га користи.
  4. Изаберите Приступ: Само читање или Читање и писање.
  5. Изаберите када Истиче: За 30 дана, За 90 дана, За 365 дана или Никада не истиче.
  6. Изаберите Креирај токен.
  7. У одељку Копирајте свој токен копирајте токен и сачувајте га на безбедном месту. Приказује се само овом приликом.

Токен ради у ваше име, у простору Livespace у ком сте га креирали, са вашом тренутном улогом у том простору. Токен са приступом Само читање може да чита, али не може ништа да додаје или мења.

Да бисте користили токен са MCP клијентом, погледајте Повежите се помоћу API кључа уместо OAuth-а.

Проверите, замените или опозовите токен

Ваши токени су наведени у одељку Лични приступни токени, уз ниво приступа. Изаберите токен да бисте видели чиме Почиње, његов Приступ, када је Последњи пут коришћен и када Истиче.

  • Да бисте заменили токен, изаберите Замени…, па Замени да бисте потврдили. Нови токен замењује стари, а стари одмах престаје да ради. Копирајте нови токен у одељку Копирајте свој токен.
  • Да бисте онемогућили токен, изаберите Опозови…, па Опозови да бисте потврдили. Све што га користи одмах престаје да ради.

Креирање, замена и опозив токена бележе се у дневнику ревизије.

Додајте веб-хук

Веб-хук шаље догађаје из простора Livespace, односно исте записе као дневник ревизије, на адресу коју изаберете.

  1. У одељку Подешавања › Приступ API-ју, под Веб-хукови, изаберите Додај веб-хук.
  2. Унесите Назив и URL. Користите јавно доступан HTTPS URL.
  3. Поље Догађаји оставите празно за све догађаје или наведите радње и области, као што су member.added или sharing.*.
  4. Изаберите Додај.
  5. У одељку Копирајте тајни кључ за потписивање копирајте тајни кључ. Приказује се само овом приликом.

Ако Dvina прикаже поруку Овој адреси није могуће приступити из сервиса Dvina, користите јавно доступан HTTPS URL.

Проверите потпис сваког захтева

Dvina шаље догађаје у групама, у JSON формату, и потписује сваки захтев. Користите тајни кључ за потписивање да бисте проверили да ли је захтев стигао из сервиса Dvina:

  • Сваки захтев има заглавље X-Dvina-Signature у облику t=<timestamp>,v1=<signature>.
  • Потпис је HMAC-SHA256 вредност у хексадецималном облику, израчуната на основу временске ознаке, тачке и тела захтева, помоћу вашег тајног кључа за потписивање.
  • Израчунајте га сами и упоредите. Одбијте захтев ако се потпис не подудара или ако је временска ознака престара.

Проверите или измените веб-хук

Ваши веб-хукови су наведени у одељку Веб-хукови, са статусом: Укључен, Паузиран или Неуспешан. Изаберите један да бисте видели његове детаље.

  • Да бисте га изменили, уредите Назив, URL или Догађаје, па изаберите Сачувај.
  • Да бисте га паузирали, искључите Шаљи догађаје. Поново укључите ову опцију да бисте наставили слање.
  • Да бисте проверили како ради, погледајте његов Статус и број догађаја означених као Послато. Веб-хук који не успева да пошаље догађаје приказује Последњу грешку. Dvina наставља да покушава и бележи неуспех у евиденцији ревизије.
  • Да бисте променили његов тајни кључ, изаберите Нови тајни кључ за потписивање…, па потврдите. Захтеви се одмах потписују новим тајним кључем, па одмах ажурирајте и примаоца.
  • Да бисте га уклонили, изаберите Избриши…, па Избриши да бисте потврдили. Ништа му се више не шаље.