Dvina MCP

Gunakan akses API

Cipta token akses peribadi untuk skrip dan klien MCP, dan hantar peristiwa Livespace anda ke sistem anda sendiri melalui webhook.

Dalam Tetapan › Akses API, anda boleh mencipta token akses peribadi supaya skrip atau klien MCP boleh menggunakan Dvina sebagai anda. Pentadbir juga boleh menambah webhook di situ untuk menghantar peristiwa Livespace ke sistem mereka sendiri.

Akses API disertakan dalam pelan Enterprise. Setiap ahli boleh mencipta token sendiri; hanya pemilik dan pentadbir dapat melihat Webhook.

Cipta token

  1. Buka Tetapan dan pilih Akses API.
  2. Di bawah Token Akses Peribadi, pilih Cipta Token.
  3. Masukkan Nama supaya anda tahu kegunaannya nanti.
  4. Pilih Akses: Baca sahaja atau Baca dan tulis.
  5. Pilih masa token Tamat Tempoh: Dalam 30 hari, Dalam 90 hari, Dalam 365 hari atau Tidak pernah tamat tempoh.
  6. Pilih Cipta Token.
  7. Di bawah Salin Token Anda, salin token dan simpan di tempat yang selamat. Token hanya dipaparkan pada kali ini.

Token bertindak sebagai anda dalam Livespace tempat anda menciptanya, dengan peranan semasa anda di situ. Token Baca sahaja boleh membaca tetapi tidak boleh menambah atau mengubah apa-apa.

Untuk menggunakan token dengan klien MCP, lihat Sambung dengan kunci API dan bukannya OAuth.

Semak, putar atau batalkan token

Token anda disenaraikan di bawah Token Akses Peribadi berserta aksesnya. Pilih satu untuk melihat aksara awalnya di Bermula Dengan, Aksesnya, masa ia Terakhir Digunakan dan masa ia Tamat Tempoh.

  • Untuk menggantikan token, pilih Putar…, kemudian Putar untuk mengesahkan. Token baharu menggantikannya, dan token lama berhenti berfungsi serta-merta. Salin token baharu di bawah Salin Token Anda.
  • Untuk menghentikan token, pilih Batalkan…, kemudian Batalkan untuk mengesahkan. Apa-apa yang menggunakannya berhenti berfungsi serta-merta.

Penciptaan, pemutaran dan pembatalan token direkodkan dalam log audit.

Tambah webhook

Webhook menghantar peristiwa Livespace, iaitu rekod yang sama seperti dalam log audit, ke alamat yang anda pilih.

  1. Dalam Tetapan › Akses API, di bawah Webhook, pilih Tambah Webhook.
  2. Masukkan Nama dan URL. Gunakan URL HTTPS awam.
  3. Di bawah Peristiwa, biarkan kosong untuk menerima semua peristiwa, atau senaraikan tindakan dan bahagian, seperti member.added atau sharing.*.
  4. Pilih Tambah.
  5. Di bawah Salin Rahsia Penandatanganan, salin rahsia tersebut. Rahsia ini hanya dipaparkan pada kali ini.

Jika Dvina menyatakan Alamat ini tidak dapat dicapai dari Dvina, gunakan URL HTTPS awam.

Semak tandatangan setiap permintaan

Dvina menghantar peristiwa secara berkelompok dalam format JSON dan menandatangani setiap permintaan. Gunakan rahsia penandatanganan untuk menyemak bahawa permintaan datang daripada Dvina:

  • Setiap permintaan mempunyai pengepala X-Dvina-Signature seperti t=<timestamp>,v1=<signature>.
  • Tandatangan ialah HMAC-SHA256 dalam format heksadesimal bagi cap masa, tanda noktah dan badan permintaan, yang dijana menggunakan rahsia penandatanganan anda.
  • Kira sendiri dan bandingkan. Tolak permintaan jika tandatangannya tidak sepadan atau cap masanya terlalu lama.

Semak atau ubah webhook

Webhook anda disenaraikan di bawah Webhook bersama statusnya: Aktif, Dijeda atau Gagal. Pilih satu untuk melihat butirannya.

  • Untuk mengubahnya, edit Nama, URL atau Peristiwa, kemudian pilih Simpan.
  • Untuk menjedakannya, matikan Hantar Peristiwa. Hidupkan semula untuk meneruskan penghantaran.
  • Untuk menyemak keadaannya, semak Status dan bilangan peristiwa yang Dihantar. Webhook yang gagal memaparkan Ralat Terakhir. Dvina terus mencuba dan merekodkan kegagalan dalam log audit.
  • Untuk menukar rahsianya, pilih Rahsia Penandatanganan Baharu…, kemudian sahkan. Permintaan ditandatangani dengan rahsia baharu serta-merta, jadi kemas kini penerima dengan segera.
  • Untuk membuangnya, pilih Padam…, kemudian Padam untuk mengesahkan. Tiada apa-apa lagi dihantar kepadanya.