Dvina MCP

Sử dụng quyền truy cập API

Tạo token truy cập cá nhân cho tập lệnh và ứng dụng khách MCP, đồng thời gửi các sự kiện của Livespace đến hệ thống của bạn bằng webhook.

Xem dạng Markdown

Trong Cài đặt › Truy cập API, bạn có thể tạo token truy cập cá nhân để tập lệnh hoặc ứng dụng khách MCP sử dụng Dvina thay mặt bạn. Quản trị viên cũng có thể thêm webhook tại đây để gửi các sự kiện của Livespace đến hệ thống của mình.

Quyền truy cập API có trong gói Enterprise. Mọi thành viên đều có thể tạo token riêng; chỉ chủ sở hữu và quản trị viên mới thấy mục Webhook.

Tạo token

  1. Mở Cài đặt và chọn Truy cập API.
  2. Trong Token truy cập cá nhân, chọn Tạo token.
  3. Nhập Tên để sau này bạn biết token được dùng cho việc gì.
  4. Chọn Quyền truy cập: Chỉ đọc hoặc Đọc và ghi.
  5. Chọn thời điểm Hết hạn: Sau 30 ngày, Sau 90 ngày, Sau 365 ngày hoặc Không bao giờ hết hạn.
  6. Chọn Tạo token.
  7. Trong Sao chép token của bạn, sao chép token và lưu ở nơi an toàn. Đây là lần duy nhất token được hiển thị.

Token hoạt động thay mặt bạn trong Livespace nơi bạn tạo token, với vai trò hiện tại của bạn tại đó. Token Chỉ đọc có thể đọc nhưng không thể thêm hoặc thay đổi bất kỳ nội dung nào.

Để dùng token với ứng dụng khách MCP, xem Kết nối bằng khóa API thay vì OAuth.

Kiểm tra, thay mới hoặc thu hồi token

Các token của bạn được liệt kê trong Token truy cập cá nhân cùng với quyền truy cập của từng token. Chọn một token để xem thông tin Bắt đầu bằng, Quyền truy cập, Lần sử dụng gần nhất và thời điểm Hết hạn.

  • Để thay thế token, chọn Thay mới…, rồi chọn Thay mới để xác nhận. Token mới sẽ thay thế token cũ, và token cũ sẽ ngừng hoạt động ngay lập tức. Sao chép token mới trong Sao chép token của bạn.
  • Để vô hiệu hóa token, chọn Thu hồi…, rồi chọn Thu hồi để xác nhận. Mọi thứ sử dụng token đó sẽ ngừng hoạt động ngay lập tức.

Việc tạo, thay mới và thu hồi token được ghi lại trong nhật ký kiểm toán.

Thêm webhook

Webhook gửi các sự kiện của Livespace, cũng là những bản ghi trong nhật ký kiểm toán, đến địa chỉ bạn chọn.

  1. Trong Cài đặt › Truy cập API, tại mục Webhook, chọn Thêm webhook.
  2. Nhập Tên và URL. Sử dụng URL HTTPS công khai.
  3. Trong Sự kiện, để trống để nhận tất cả sự kiện, hoặc liệt kê các hành động và phạm vi, chẳng hạn như member.added hoặc sharing.*.
  4. Chọn Thêm.
  5. Trong Sao chép khóa bí mật dùng để ký, sao chép khóa bí mật. Đây là lần duy nhất khóa này được hiển thị.

Nếu Dvina hiển thị Dvina không thể truy cập địa chỉ này, hãy sử dụng URL HTTPS công khai.

Kiểm tra chữ ký của từng yêu cầu

Dvina gửi sự kiện theo lô ở định dạng JSON và ký mọi yêu cầu. Dùng khóa bí mật dùng để ký để kiểm tra xem yêu cầu có đến từ Dvina hay không:

  • Mỗi yêu cầu có một tiêu đề X-Dvina-Signature dạng t=<timestamp>,v1=<signature>.
  • Chữ ký là giá trị HMAC-SHA256 ở dạng thập lục phân, được tạo bằng khóa bí mật dùng để ký của bạn từ dấu thời gian, một dấu chấm và phần thân yêu cầu.
  • Tự tính giá trị này rồi so sánh. Từ chối yêu cầu nếu chữ ký không khớp hoặc dấu thời gian quá cũ.

Kiểm tra hoặc thay đổi webhook

Các webhook của bạn được liệt kê trong Webhook kèm trạng thái: Đang bật, Đã tạm dừng hoặc Đang lỗi. Chọn một webhook để xem chi tiết.

  • Để thay đổi webhook, chỉnh sửa Tên, URL hoặc Sự kiện, rồi chọn Lưu.
  • Để tạm dừng webhook, tắt Gửi sự kiện. Bật lại để tiếp tục gửi.
  • Để kiểm tra hoạt động của webhook, xem Trạng thái và số sự kiện Đã gửi. Webhook đang lỗi sẽ hiển thị Lỗi gần nhất. Dvina tiếp tục thử lại và ghi nhận lỗi trong nhật ký kiểm toán.
  • Để thay đổi khóa bí mật của webhook, chọn Khóa bí mật ký mới…, rồi xác nhận. Các yêu cầu sẽ được ký bằng khóa bí mật mới ngay lập tức, vì vậy hãy cập nhật bên nhận ngay.
  • Để xóa webhook, chọn Xóa…, rồi chọn Xóa để xác nhận. Sẽ không có gì được gửi đến webhook đó nữa.