Le chiavi API ti consentono di connettere in modo sicuro il tuo sito web, un'applicazione o un altro strumento al tuo account Brevo, in modo da poter automatizzare attività come l'aggiunta di contatti, l'invio di campagne o l'esportazione di dati. Decidi esattamente a cosa può accedere ciascuna chiave.

Buono a sapersi

• Solo il proprietario dell'account o gli utenti con l'autorizzazione per le chiavi API possono accedere alla pagina API Keys & MCP (Chiavi API e MCP), creare una nuova chiave API o eliminare una chiave API esistente. Per saperne di più su utente autorizzazioni e autorizzazione livelli, consulta il nostro articolo dedicato Aggiungi utenti e assegna autorizzazioni in Brevo.
• Ogni volta che una chiave API viene creata o cancellata dall'account, l'account proprietario riceverà una notifica via email, contenente dettagli come l'indirizzo IP e la posizione.
• Per vedere tutti i comandi che puoi utilizzare con la nostra API pubblica, consulta la documentazione della nostra API pubblica.+

Creazione di una chiave API

Quando configuri un'integrazione con il tuo account Brevo, potresti dover creare una nuova chiave API e decidere a cosa può accedere:

1. In basso a sinistra, clicca su Impostazioni > SMTP e API > Chiavi API e MCP.
2. Clicca su Generate API key (Genera chiave API).
   
3. Inserisci il codice di verifica inviato al tuo dispositivo e clicca su Verify (Verifica). Per saperne di più, consulta il nostro articolo dedicato Verifica della tua identità per le azioni sensibili in Brevo.
4. In Key name (Nome chiave), assegna un nome alla tua chiave API. Assicurati che il nome specifichi quale integrazione la utilizzerà in modo da poterla riconoscere facilmente.

5. In Expiry (Scadenza), seleziona per quanto tempo la chiave rimarrà valida, da 7 giorni a 1 anno, oppure scegli nessuna scadenza.

   

   ❗️ Importante

   Anche se non è impostata alcuna data di scadenza, una chiave viene disattivata se non effettua una chiamata API con successo entro 90 giorni. Riceverai un promemoria via email 7 giorni prima e il giorno stesso in cui ciò accade. Se imposti una data di scadenza, riceverai anche un promemoria 3 giorni prima e il giorno in cui la chiave scade.

6. In Access (Accesso), scegli a quanta parte del tuo account può accedere la chiave API:

   [Consigliato] Restricted (Limitato) Full (Completo)

   Con le autorizzazioni Restricted (Limitate), la chiave può accedere solo alle risorse scelte.

   In Permissions (Autorizzazioni), seleziona None (Nessuna), Read (Lettura), Read/write (Lettura/scrittura) o All (Tutte) per ogni risorsa di cui la chiave ha bisogno. Per ulteriori informazioni, consulta il nostro articolo dedicato Informazioni sulle autorizzazioni delle chiavi API.

   

   Con le autorizzazioni Full (Complete), la chiave può accedere a tutte le risorse attuali e future, quindi non ci sono autorizzazioni da impostare.

   

7. Copia la tua chiave API e conservala in un posto sicuro.
   

   ❗️ Importante

   La chiave API è visibile solo durante questa fase. Dopo aver creato la tua chiave API, non potrai più copiarla e, se la perdi, dovrai crearne una nuova.
8. (Opzionale) Per generare una versione della chiave API che ti consenta di collegare un sistema AI a Brevo tramite il protocollo MCP:
   1. Attiva Create MCP server API key (Crea una chiave API server MCP). La chiave API standard viene disattivata e viene invece generata una versione MCP della chiave API.
   2. Copia la chiave API MCP.
      
      Per ulteriori informazioni, consulta il nostro articolo dedicato Che cos'è il protocollo MCP (Model Context Protocol)?. 
9. Clicca su I've saved my key (Ho salvato la chiave).

La nuova chiave API è stata creata.

Visualizza le tue chiavi API

Per proteggere le tue chiavi API, le chiavi esistenti non sono visibili sul tuo account Brevo. La pagina API Keys & MCP (Chiavi API e MCP) visualizza solo le ultime cifre di ogni chiave, così che possa distinguerle:

La pagina mostra anche le seguenti informazioni per ogni chiave:

• Name (Nome): il nome della chiave e le sue ultime cifre. Le chiavi con una versione MCP mostrano un'etichetta MCP. 

  💡 Buono a sapersi

  Se vedi un'icona di avviso accanto a un tag RSS, significa che la chiave è scaduta.
• Autorizzazioni: 
  • Full access (Accesso completo) significa che la chiave può raggiungere tutte le risorse. 
  • Restricted (Limitata) seguita da un numero di ambiti significa che la chiave può raggiungere solo quel numero di risorse. Passa il mouse sopra le autorizzazioni per vedere quali risorse include la chiave.
• Status (Stato): indica se la chiave è attiva o disattivata.
• Expires on (Scade il): la data di scadenza della chiave, o No fixed date (Nessuna data fissa) se non hai impostato una data di scadenza.
• Last used on (Ultimo utilizzo il): la data dell'ultima chiamata API effettuata con la chiave.

Modifica una chiave API

Se un'integrazione richiede più o meno accessi rispetto a quelli inizialmente concessi, puoi modificare l'accesso della sua chiave API in qualsiasi momento. Puoi anche modificare il nome e la data di scadenza della chiave.

1. In basso a sinistra, clicca su Impostazioni > SMTP e API > Chiavi API e MCP.
2. Accanto alla chiave API che vuoi modificare, clicca sull'icona con i tre puntini e seleziona Edit API key (Modifica chiave API).
   
3. Inserisci il codice di verifica inviato al tuo dispositivo e clicca su Verify (Verifica). Per ulteriori informazioni, consulta il nostro articolo dedicato Verifica della tua identità per le azioni sensibili in Brevo. 

4. Apporta le modifiche necessarie. 

   ❗️ Importante

   Se rimuovi un'autorizzazione di cui un'integrazione ha ancora bisogno, le sue chiamate API falliranno con l'errore Access denied for resource (Accesso negato alla risorsa). Per ulteriori informazioni, consulta il nostro articolo dedicato Risoluzione dei problemi: Problemi con le chiavi API
5. Clicca su Save changes (Salva modifiche). 

La chiave API è stata aggiornata correttamente.

Disattivazione o riattivazione di una chiave API

Se vuoi sospendere temporaneamente l'uso di una chiave API invece di cancellarla completamente, puoi disattivarla e riattivarla in un secondo momento quando ne avrai di nuovo bisogno. Puoi anche riattivare una chiave che era stata disattivata.

1. In basso a sinistra, clicca su Impostazioni > SMTP e API > Chiavi API e MCP.
2. Accanto alla chiave API che desideri disattivare o riattivare, clicca sull'icona con tre puntini e seleziona Deactivate API key (Disattiva chiave API) o Activate API key (Attiva chiave API).
   

Hai disattivato o riattivato con successo la tua chiave API.

Elimina una chiave API

Se il tuo account è stato compromesso o se non utilizzi più un'integrazione che richiede una particolare chiave API, puoi eliminare quella chiave API:

1. In basso a sinistra, clicca su Impostazioni > SMTP e API > Chiavi API e MCP.
2. Accanto alla chiave API che vuoi eliminare, clicca sull'icona con i tre puntini e seleziona Delete API key (Elimina chiave API).
   

La chiave API è stata eliminata correttamente.

Migliori pratiche di gestione delle chiavi API

Proteggi ogni chiave API nello stesso modo di una password. Ecco alcune migliori pratiche da tenere a mente:

• Utilizza una chiave API diversa per ogni integrazione e includi il nome dell'integrazione nel nome della chiave. In questo modo, se una chiave viene compromessa, puoi eliminarla senza influire sulle altre integrazioni.
• Usa Accesso limitato e dai a ogni chiave solo le autorizzazioni necessarie. In questo modo, una chiave compromessa potrà accedere solo alle risorse selezionate.
• Conserva le chiavi API in un ambiente sicuro, non in un documento Word o su un post-it.
• Non mostrare mai pubblicamente la tua chiave API. Nascondi la tua chiave API o, meglio ancora, tagliala completamente negli screenshot o nei video.
• Non inviare mai una chiave API via email, in quanto ciò consente l'accesso al tuo account Brevo se qualcuno viola il tuo account email.
• Elimina sempre le chiavi API che non usi più per limitare i rischi di fuga delle informazioni.
• Attiva il blocco degli indirizzi IP in modo che le chiamate API provenienti da indirizzi IP non riconosciuti vengano bloccate finché non li autorizzi. Per ulteriori informazioni, consulta il nostro articolo dedicato Autorizzazione e blocco degli indirizzi IP per la sicurezza di API e SMTP.

⏭️ E adesso?

• Informazioni sulle autorizzazioni delle chiavi API 
• Risoluzione dei problemi - Problemi con le chiavi API
• Creazione e gestione delle chiavi SMTP
• Autorizzazione e blocco degli indirizzi IP per la sicurezza di API e SMTP
• Il mio account è stato compromesso, cosa devo fare?
• Che cos'è il Model Context Protocol (MCP)?

🤔 Domande?

In caso di domande, non esitare a contattare il team dell’assistenza creando un ticket dal tuo account. Se ancora non hai un account, puoi contattarci qui.

Se stai cercando aiuto per un progetto che prevede l'utilizzo di Brevo, possiamo metterti in contatto con l'agenzia partner di Brevo giusta per te.