Dvina MCP

Gunakan akses API

Buat token akses pribadi untuk skrip dan klien MCP, lalu kirim peristiwa Livespace Anda ke sistem Anda sendiri dengan webhook.

Di Pengaturan › Akses API, Anda dapat membuat token akses pribadi agar skrip atau klien MCP dapat menggunakan Dvina atas nama Anda. Admin juga dapat menambahkan webhook di sana untuk mengirim peristiwa Livespace ke sistem mereka sendiri.

Akses API tersedia dalam paket Enterprise. Setiap anggota dapat membuat token sendiri; hanya pemilik dan admin yang dapat melihat Webhook.

Buat token

  1. Buka Pengaturan dan pilih Akses API.
  2. Di bagian Token Akses Pribadi, pilih Buat Token.
  3. Masukkan Nama agar nanti Anda tahu apa yang menggunakan token tersebut.
  4. Pilih Akses: Hanya baca atau Baca dan tulis.
  5. Pilih kapan token Kedaluwarsa: Dalam 30 hari, Dalam 90 hari, Dalam 365 hari, atau Tidak pernah kedaluwarsa.
  6. Pilih Buat Token.
  7. Di bagian Salin Token Anda, salin token dan simpan di tempat yang aman. Token hanya ditampilkan sekali ini.

Token bertindak atas nama Anda di Livespace tempat Anda membuatnya, dengan peran Anda saat ini di sana. Token Hanya baca dapat membaca, tetapi tidak dapat menambahkan atau mengubah apa pun.

Untuk menggunakan token dengan klien MCP, lihat Hubungkan dengan kunci API, bukan OAuth.

Periksa, rotasi, atau cabut token

Token Anda tercantum di bagian Token Akses Pribadi beserta aksesnya. Pilih salah satu untuk melihat karakter Diawali Dengan, Akses, kapan token Terakhir Digunakan, dan kapan token Kedaluwarsa.

  • Untuk mengganti token, pilih Rotasi…, lalu Rotasi untuk mengonfirmasi. Token baru menggantikannya, dan token lama langsung berhenti berfungsi. Salin token baru di bagian Salin Token Anda.
  • Untuk menonaktifkan token, pilih Cabut…, lalu Cabut untuk mengonfirmasi. Apa pun yang menggunakan token tersebut langsung berhenti berfungsi.

Pembuatan, rotasi, dan pencabutan token dicatat dalam log audit.

Tambahkan webhook

Webhook mengirim peristiwa Livespace, yaitu catatan yang sama dengan log audit, ke alamat yang Anda pilih.

  1. Di Pengaturan › Akses API, pada bagian Webhook, pilih Tambahkan Webhook.
  2. Masukkan Nama dan URL. Gunakan URL HTTPS publik.
  3. Di bagian Peristiwa, biarkan kosong untuk menerima semua peristiwa, atau cantumkan tindakan dan area, seperti member.added atau sharing.*.
  4. Pilih Tambahkan.
  5. Di bagian Salin Kunci Rahasia Penandatanganan, salin kunci rahasia tersebut. Kunci rahasia hanya ditampilkan sekali ini.

Jika Dvina menampilkan Alamat ini tidak dapat dijangkau dari Dvina, gunakan URL HTTPS publik.

Periksa tanda tangan setiap permintaan

Dvina mengirim peristiwa secara berkelompok dalam format JSON dan menandatangani setiap permintaan. Gunakan kunci rahasia penandatanganan untuk memastikan bahwa permintaan berasal dari Dvina:

  • Setiap permintaan memiliki header X-Dvina-Signature seperti t=<timestamp>,v1=<signature>.
  • Tanda tangan berupa HMAC-SHA256 dalam format heksadesimal, yang dibuat dari stempel waktu, tanda titik, dan isi permintaan menggunakan kunci rahasia penandatanganan Anda.
  • Hitung sendiri tanda tangannya, lalu bandingkan. Tolak permintaan jika tanda tangannya tidak cocok atau stempel waktunya terlalu lama.

Periksa atau ubah webhook

Webhook Anda tercantum di bagian Webhook beserta statusnya: Aktif, Dijeda, atau Gagal. Pilih salah satu untuk melihat detailnya.

  • Untuk mengubahnya, edit Nama, URL, atau Peristiwa, lalu pilih Simpan.
  • Untuk menjedanya, nonaktifkan Kirim Peristiwa. Aktifkan kembali untuk melanjutkan pengiriman.
  • Untuk memantau kinerjanya, periksa Status dan jumlah peristiwa yang Terkirim. Webhook yang gagal menampilkan Kesalahan Terakhir. Dvina terus mencoba dan mencatat kegagalan tersebut di log audit.
  • Untuk mengubah rahasianya, pilih Rahasia Penandatanganan Baru…, lalu konfirmasi. Permintaan langsung ditandatangani dengan rahasia baru, jadi segera perbarui penerimanya.
  • Untuk menghapusnya, pilih Hapus…, lalu Hapus untuk mengonfirmasi. Tidak ada lagi yang dikirim ke webhook tersebut.