Dvina MCP

ใช้การเข้าถึง API

สร้างโทเค็นการเข้าถึงส่วนบุคคลสำหรับสคริปต์และไคลเอนต์ MCP และส่งเหตุการณ์ใน Livespace ไปยังระบบของคุณเองด้วยเว็บฮุก

ดูเป็น Markdown

ใน การตั้งค่า › การเข้าถึง API คุณสามารถสร้างโทเค็นการเข้าถึงส่วนบุคคลเพื่อให้สคริปต์หรือไคลเอนต์ MCP ใช้ Dvina ในนามของคุณได้ ผู้ดูแลระบบยังเพิ่มเว็บฮุกได้ที่นี่ เพื่อส่งเหตุการณ์ใน Livespace ไปยังระบบของตนเอง

การเข้าถึง API มีให้ในแผน Enterprise สมาชิกทุกคนสร้างโทเค็นของตนเองได้ ส่วน เว็บฮุก จะมองเห็นได้เฉพาะเจ้าของและผู้ดูแลระบบเท่านั้น

สร้างโทเค็น

  1. เปิดการตั้งค่า แล้วเลือก การเข้าถึง API
  2. ในส่วน โทเค็นการเข้าถึงส่วนบุคคล เลือก สร้างโทเค็น
  3. ป้อน ชื่อ เพื่อให้คุณทราบในภายหลังว่าโทเค็นนี้ใช้กับอะไร
  4. เลือก สิทธิ์การเข้าถึง: อ่านอย่างเดียว หรือ อ่านและเขียน
  5. เลือกเวลาที่โทเค็น หมดอายุ: ใน 30 วัน, ใน 90 วัน, ใน 365 วัน หรือ ไม่มีวันหมดอายุ
  6. เลือก สร้างโทเค็น
  7. ในส่วน คัดลอกโทเค็นของคุณ ให้คัดลอกโทเค็นและเก็บไว้ในที่ปลอดภัย โทเค็นจะแสดงให้เห็นครั้งนี้ครั้งเดียวเท่านั้น

โทเค็นทำงานในนามของคุณใน Livespace ที่คุณสร้างโทเค็นนั้น โดยใช้บทบาทปัจจุบันของคุณใน Livespace นั้น โทเค็นแบบ อ่านอย่างเดียว อ่านข้อมูลได้ แต่เพิ่มหรือเปลี่ยนแปลงอะไรไม่ได้

หากต้องการใช้โทเค็นกับไคลเอนต์ MCP โปรดดู เชื่อมต่อด้วยคีย์ API แทน OAuth

ตรวจสอบ เปลี่ยน หรือเพิกถอนโทเค็น

โทเค็นของคุณจะแสดงอยู่ในส่วน โทเค็นการเข้าถึงส่วนบุคคล พร้อมสิทธิ์การเข้าถึง เลือกโทเค็นเพื่อดูว่า ขึ้นต้นด้วย อะไร มี สิทธิ์การเข้าถึง แบบใด ใช้ล่าสุด เมื่อใด และ หมดอายุ เมื่อใด

  • หากต้องการเปลี่ยนโทเค็น ให้เลือก เปลี่ยนโทเค็น… แล้วเลือก เปลี่ยนโทเค็น เพื่อยืนยัน โทเค็นใหม่จะมาแทนที่โทเค็นเดิม และโทเค็นเดิมจะหยุดทำงานทันที คัดลอกโทเค็นใหม่ในส่วน คัดลอกโทเค็นของคุณ
  • หากต้องการหยุดใช้โทเค็น ให้เลือก เพิกถอน… แล้วเลือก เพิกถอน เพื่อยืนยัน ทุกสิ่งที่ใช้โทเค็นนี้จะหยุดทำงานทันที

การสร้าง เปลี่ยน และเพิกถอนโทเค็นจะถูกบันทึกไว้ใน บันทึกการตรวจสอบ

เพิ่มเว็บฮุก

เว็บฮุกส่งเหตุการณ์ใน Livespace ซึ่งเป็นรายการเดียวกับใน บันทึกการตรวจสอบ ไปยังที่อยู่ที่คุณเลือก

  1. ใน การตั้งค่า › การเข้าถึง API ไปที่ส่วน เว็บฮุก แล้วเลือก เพิ่มเว็บฮุก
  2. ป้อน ชื่อ และ URL โดยใช้ URL แบบ HTTPS ที่เข้าถึงได้จากสาธารณะ
  3. ในส่วน เหตุการณ์ ให้เว้นว่างไว้เพื่อรับทุกเหตุการณ์ หรือระบุการดำเนินการและส่วนงาน เช่น member.added หรือ sharing.*
  4. เลือก เพิ่ม
  5. ในส่วน คัดลอกคีย์ลับสำหรับลงลายเซ็น ให้คัดลอกคีย์ลับ คีย์ลับจะแสดงให้เห็นครั้งนี้ครั้งเดียวเท่านั้น

หาก Dvina แจ้งว่า Dvina ไม่สามารถเข้าถึงที่อยู่นี้ได้ ให้ใช้ URL แบบ HTTPS ที่เข้าถึงได้จากสาธารณะ

ตรวจสอบลายเซ็นของแต่ละคำขอ

Dvina ส่งเหตุการณ์เป็นชุดในรูปแบบ JSON และลงลายเซ็นทุกคำขอ ใช้คีย์ลับสำหรับลงลายเซ็นเพื่อตรวจสอบว่าคำขอมาจาก Dvina:

  • แต่ละคำขอมีส่วนหัว X-Dvina-Signature ในรูปแบบ t=<timestamp>,v1=<signature>
  • ลายเซ็นคือค่า HMAC-SHA256 ในรูปแบบเลขฐานสิบหก ซึ่งสร้างจากเวลาประทับ เครื่องหมายจุด และเนื้อหาคำขอ โดยใช้คีย์ลับสำหรับลงลายเซ็นของคุณ
  • คำนวณค่าด้วยตัวเองแล้วเปรียบเทียบ ปฏิเสธคำขอที่ลายเซ็นไม่ตรงกันหรือมีเวลาประทับเก่าเกินไป

ตรวจสอบหรือเปลี่ยนแปลงเว็บฮุก

เว็บฮุกของคุณจะแสดงอยู่ในส่วน เว็บฮุก พร้อมสถานะ: เปิด, หยุดชั่วคราว หรือ ส่งไม่สำเร็จ เลือกเว็บฮุกเพื่อดูรายละเอียด

  • หากต้องการเปลี่ยนแปลงเว็บฮุก ให้แก้ไข ชื่อ, URL หรือ เหตุการณ์ แล้วเลือก บันทึก
  • หากต้องการหยุดชั่วคราว ให้ปิด ส่งเหตุการณ์ เปิดอีกครั้งเพื่อเริ่มส่งต่อ
  • หากต้องการดูการทำงานของเว็บฮุก ให้ตรวจสอบ สถานะ และจำนวนเหตุการณ์ที่ ส่งแล้ว เว็บฮุกที่ส่งไม่สำเร็จจะแสดง ข้อผิดพลาดล่าสุด Dvina จะพยายามส่งต่อไป และบันทึกการส่งที่ไม่สำเร็จไว้ในบันทึกการตรวจสอบ
  • หากต้องการเปลี่ยนคีย์ลับ ให้เลือก คีย์ลับสำหรับลงลายเซ็นใหม่… แล้วยืนยัน คำขอจะใช้คีย์ลับใหม่ในการลงลายเซ็นทันที คุณจึงต้องอัปเดตฝั่งรับทันที
  • หากต้องการลบเว็บฮุก ให้เลือก ลบ… แล้วเลือก ลบ เพื่อยืนยัน จะไม่มีการส่งข้อมูลไปยังเว็บฮุกนี้อีก