Dvina MCP

API orqali kirishdan foydalanish

Skriptlar va MCP mijozlari uchun shaxsiy kirish tokenlarini yarating va webhook yordamida Livespace hodisalarini o‘z tizimlaringizga yuboring.

Markdown’da ko‘rish

Sozlamalar › API orqali kirish bo‘limida shaxsiy kirish tokenlarini yaratasiz. Ular skript yoki MCP mijoziga Dvina’dan sizning nomingizdan foydalanish imkonini beradi. Administratorlar Livespace hodisalarini o‘z tizimlariga yuborish uchun shu yerda webhook ham qo‘shadilar.

API orqali kirish Enterprise tarifiga kiradi. Har bir a’zo o‘z tokenlarini yaratishi mumkin; Webhooklar bo‘limini faqat egalar va administratorlar ko‘radi.

Token yaratish

  1. Sozlamalarni oching va API orqali kirish bo‘limini tanlang.
  2. Shaxsiy kirish tokenlari bo‘limida Token yaratish tugmasini tanlang.
  3. Keyinchalik undan nima foydalanayotganini bilish uchun Nomi maydonini to‘ldiring.
  4. Kirish huquqini tanlang: Faqat o‘qish yoki O‘qish va yozish.
  5. Amal qilish muddatini tanlang: 30 kundan keyin, 90 kundan keyin, 365 kundan keyin yoki Muddatsiz.
  6. Token yaratish tugmasini tanlang.
  7. Tokeningizni nusxalang bo‘limida tokenni nusxalang va xavfsiz joyda saqlang. U faqat shu safar ko‘rsatiladi.

Token siz uni yaratgan Livespace’da sizning nomingizdan va u yerdagi joriy rolingiz bilan ishlaydi. Faqat o‘qish tokeni ma’lumotlarni o‘qiy oladi, lekin hech narsa qo‘sha yoki o‘zgartira olmaydi.

Tokenni MCP mijozi bilan ishlatish uchun OAuth o‘rniga API kaliti bilan ulanish sahifasiga qarang.

Tokenni tekshirish, almashtirish yoki bekor qilish

Tokenlaringiz Shaxsiy kirish tokenlari bo‘limida kirish huquqlari bilan birga ko‘rsatiladi. Tokenning Boshlanishi, Kirish huquqi, Oxirgi foydalanish va Amal qilish muddati haqidagi ma’lumotlarni ko‘rish uchun uni tanlang.

  • Tokenni almashtirish uchun Almashtirish… tugmasini, so‘ng tasdiqlash uchun Almashtirish tugmasini tanlang. Uning o‘rniga yangi token yaratiladi va eski token darhol ishlashdan to‘xtaydi. Tokeningizni nusxalang bo‘limida yangi tokenni nusxalang.
  • Tokenni to‘xtatish uchun Bekor qilish… tugmasini, so‘ng tasdiqlash uchun Bekor qilish tugmasini tanlang. Undan foydalanadigan barcha vositalar darhol ishlashdan to‘xtaydi.

Tokenni yaratish, almashtirish va bekor qilish audit jurnalida qayd etiladi.

Webhook qo‘shish

Webhook Livespace hodisalarini — audit jurnalidagi yozuvlarning o‘zini — siz tanlagan manzilga yuboradi.

  1. Sozlamalar › API orqali kirish sahifasidagi Webhooklar bo‘limida Webhook qo‘shish tugmasini tanlang.
  2. Nomi va URL maydonlarini to‘ldiring. Internetdan ochiq kirish mumkin bo‘lgan HTTPS URL manzilidan foydalaning.
  3. Hodisalar maydonini barcha hodisalarni olish uchun bo‘sh qoldiring yoki member.added yoki sharing.* kabi amallar va sohalarni kiriting.
  4. Qo‘shish tugmasini tanlang.
  5. Imzolash uchun maxfiy kalitni nusxalang bo‘limida maxfiy kalitni nusxalang. U faqat shu safar ko‘rsatiladi.

Agar Dvina Dvina’dan bu manzilga ulanish imkonsiz deb ko‘rsatsa, internetdan ochiq kirish mumkin bo‘lgan HTTPS URL manzilidan foydalaning.

Har bir so‘rov imzosini tekshirish

Dvina hodisalarni JSON formatida guruhlab yuboradi va har bir so‘rovni imzolaydi. So‘rov Dvina’dan kelganini tekshirish uchun imzolash uchun maxfiy kalitdan foydalaning:

  • Har bir so‘rovda t=<timestamp>,v1=<signature> ko‘rinishidagi X-Dvina-Signature sarlavhasi mavjud.
  • Imzo vaqt belgisi, nuqta va so‘rov tanasidan imzolash uchun maxfiy kalitingiz yordamida hisoblangan, o‘n oltilik formatdagi HMAC-SHA256 qiymatidir.
  • Uni o‘zingiz hisoblang va solishtiring. Imzosi mos kelmagan yoki vaqt belgisi juda eski bo‘lgan so‘rovni rad eting.

Webhookni tekshirish yoki o‘zgartirish

Webhooklaringiz Webhooklar bo‘limida holati bilan ko‘rsatiladi: Yoqilgan, To‘xtatilgan yoki Xatolik yuz bermoqda. Tafsilotlarini ko‘rish uchun ulardan birini tanlang.

  • O‘zgartirish uchun, Nomi, URL yoki Hodisalar maydonlarini tahrirlang, so‘ng Saqlashni tanlang.
  • Vaqtincha to‘xtatish uchun, Hodisalarni yuborishni o‘chiring. Yuborishni qayta boshlash uchun uni yana yoqing.
  • Qanday ishlayotganini ko‘rish uchun, Holati va nechta hodisa Yuborilganini tekshiring. Xatolik yuz berayotgan webhookda Oxirgi xato ko‘rsatiladi. Dvina qayta urinishda davom etadi va xatolikni audit jurnaliga yozadi.
  • Maxfiy kalitini o‘zgartirish uchun, **Yangi imzolash kaliti…**ni tanlang, so‘ng tasdiqlang. So‘rovlar darhol yangi kalit bilan imzolanadi, shuning uchun qabul qiluvchi tomonni ham darhol yangilang.
  • O‘chirish uchun, **O‘chirish…**ni tanlang, so‘ng tasdiqlash uchun O‘chirishni tanlang. Unga boshqa hech narsa yuborilmaydi.