# 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.

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](/docs/dvina-mcp/overview#connect-with-an-api-key-instead-of-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](/docs/teams/audit-log).

## Aggiungi un webhook

Un webhook invia gli eventi del Livespace, gli stessi record presenti nel [registro di audit](/docs/teams/audit-log), 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.

## Vedi anche

- [Usa Dvina da altre app con MCP](/docs/dvina-mcp/overview)
- [Usa il registro di controllo](/docs/teams/audit-log)
- [Panoramica dei team](/docs/teams/overview)