Dvina MCP

Usa l'accesso API

Crea token di accesso personali per script e client MCP e invia gli eventi del tuo Livespace ai tuoi sistemi tramite webhook.

Vedi in Markdown

In Impostazioni › Accesso API, puoi creare token di accesso personali per consentire a uno script o a un client MCP di usare Dvina con la tua identità. Da qui, gli amministratori possono anche aggiungere webhook per inviare gli eventi del Livespace ai propri sistemi.

L'accesso API è incluso nel piano Enterprise. Ogni membro può creare i propri token; solo i proprietari e gli amministratori vedono Webhook.

Crea un token

  1. Apri Impostazioni e scegli Accesso API.
  2. In Token di accesso personali, scegli Crea token.
  3. Inserisci un Nome, così potrai riconoscere in seguito cosa lo usa.
  4. Scegli il tipo di Accesso: Sola lettura o Lettura e scrittura.
  5. Scegli la Scadenza: Tra 30 giorni, Tra 90 giorni, Tra 365 giorni o Nessuna scadenza.
  6. Scegli Crea token.
  7. In Copia il tuo token, copia il token e conservalo in un luogo sicuro. Viene mostrato solo in questo momento.

Un token agisce con la tua identità nel Livespace in cui l'hai creato, con il ruolo che hai attualmente al suo interno. Un token di Sola lettura può leggere, ma non può aggiungere o modificare nulla.

Per usare un token con un client MCP, consulta Connettiti con una chiave API anziché con OAuth.

Controlla, ruota o revoca un token

I tuoi token sono elencati in Token di accesso personali, insieme al tipo di accesso. Scegline uno per vedere con quali caratteri Inizia, il tipo di Accesso, l'Ultimo utilizzo e la Scadenza.

  • Per sostituire un token, scegli Ruota…, poi Ruota per confermare. Il token viene sostituito da uno nuovo e quello precedente smette subito di funzionare. Copia il nuovo token in Copia il tuo token.
  • Per disattivare un token, scegli Revoca…, poi Revoca per confermare. Tutto ciò che lo usa smette subito di funzionare.

La creazione, la rotazione e la revoca di un token vengono registrate nel registro di audit.

Aggiungi un webhook

Un webhook invia gli eventi del Livespace, gli stessi record presenti nel registro di audit, a un indirizzo che scegli tu.

  1. In Impostazioni › Accesso API, nella sezione Webhook, scegli Aggiungi webhook.
  2. Inserisci un Nome e l'URL. Usa un URL HTTPS pubblico.
  3. In Eventi, lascia il campo vuoto per ricevere tutti gli eventi oppure elenca azioni e aree, come member.added o sharing.*.
  4. Scegli Aggiungi.
  5. In Copia il segreto di firma, copia il segreto. Viene mostrato solo in questo momento.

Se Dvina mostra Questo indirizzo non è raggiungibile da Dvina, usa un URL HTTPS pubblico.

Verifica la firma di ogni richiesta

Dvina invia gli eventi in batch, in formato JSON, e firma ogni richiesta. Usa il segreto di firma per verificare che una richiesta provenga da Dvina:

  • Ogni richiesta include un'intestazione X-Dvina-Signature nel formato t=<timestamp>,v1=<signature>.
  • La firma è un HMAC-SHA256 in formato esadecimale, calcolato con il tuo segreto di firma sul timestamp, seguito da un punto e dal corpo della richiesta.
  • Calcola la firma e confrontala con quella ricevuta. Rifiuta le richieste la cui firma non corrisponde o il cui timestamp è troppo vecchio.

Controlla o modifica un webhook

I tuoi webhook sono elencati in Webhook con il relativo stato: Attivo, In pausa o Con errori. Selezionane uno per visualizzarne i dettagli.

  • Per modificarlo, modifica Nome, URL o Eventi, poi scegli Salva.
  • Per metterlo in pausa, disattiva Invia eventi. Riattiva l'opzione per riprendere l'invio.
  • Per verificarne il funzionamento, controlla lo Stato e il numero di eventi Inviati. Un webhook con errori mostra il suo Ultimo errore. Dvina continua a tentare l'invio e registra l'errore nel registro di controllo.
  • Per modificarne il segreto, scegli Nuovo segreto di firma…, poi conferma. Le richieste vengono firmate subito con il nuovo segreto, quindi aggiorna immediatamente il sistema che le riceve.
  • Per rimuoverlo, scegli Elimina…, poi Elimina per confermare. Non verrà più inviato nulla a questo webhook.