Le autorizzazioni della chiave API ti consentono di controllare esattamente cosa può fare ogni chiave API nel tuo account Brevo. Dare a un'integrazione solo l'accesso di cui ha bisogno significa che una chiave compromessa o condivisa non può essere utilizzata per nient'altro.
Buono a sapersi
- Le chiavi create prima che le autorizzazioni fossero disponibili mantengono l'accesso completo finché non le modifichi.
- Le autorizzazioni si applicano solo alle chiavi API. Le chiavi SMTP non sono interessate. Per ulteriori informazioni, consulta il nostro articolo dedicato Creazione e gestione delle chiavi SMTP.
Tipi di accesso
Quando crei o modifichi una chiave API, devi prima scegliere a cosa può accedere la chiave nel tuo account:
- [Consigliato] Restricted (Limitato): scegli esattamente a cosa può accedere la chiave. Ogni risorsa inizia con None (Nessuna), quindi selezioni solo un livello di autorizzazione per le risorse che servono alla chiave.
- Full (Completo): la chiave può accedere a tutte le risorse attuali e future.
Livelli di autorizzazione
Per ogni risorsa di una chiave Restricted (Limitata), puoi scegliere uno dei quattro livelli di autorizzazione. La tabella seguente mostra cosa consente ogni livello:
| Livello | Cosa può fare la chiave | Richieste API consentite |
|---|---|---|
| Nessuna | Non ha accesso alla risorsa. | Nessuna |
| Lettura | Puoi visualizzare la risorsa ma non puoi modificarla. | OTTIENI |
| Lettura/scrittura | Puoi visualizzare, creare e aggiornare la risorsa ma non puoi eliminarla. | OTTIENI, PUBBLICA e METTI |
| Tutti | Hai accesso completo alla risorsa, inclusa l'eliminazione. | Tutti i tipi di richiesta |
Risorse disponibili
È possibile impostare le autorizzazioni su 18 risorse. Non tutte le risorse offrono tutti i livelli. La tabella seguente mostra i livelli disponibili per ogni risorsa:
| Risorsa | Livelli disponibili |
|---|---|
| Email transazionale | Nessuna, Lettura e Tutte |
| SMS transazionale | Nessuna, Lettura, Lettura/scrittura e Tutte |
| WhatsApp transazionale | Nessuna, Lettura, Lettura/scrittura e Tutte |
| Campagne email | Nessuna, Lettura e Tutte |
| Campagne SMS | Nessuna, Lettura e Tutte |
| Campagna WhatsApp | Nessuna, Lettura e Tutte |
| Contatti | Nessuna, Lettura e Tutte |
| Trattative | Nessuna, Lettura e Tutte |
| Conversazioni | Nessuna, Lettura, Lettura/scrittura e Tutte |
| E-commerce | Nessuna, Lettura, Lettura/scrittura e Tutte |
| Loyalty (Fedeltà) | Nessuna, Lettura, Lettura/scrittura e Tutte |
| Eventi | Nessuna, Lettura, Lettura/scrittura e Tutte |
| Oggetti | Nessuna, Lettura e Tutte |
| Account | Nessuna, Lettura, Lettura/scrittura e Tutte |
| Webhook | Nessuna, Lettura, Lettura/scrittura e Tutte |
| Organizzazione | Nessuna, Lettura e Tutte |
| Wallet | Nessuna, Lettura, Lettura/scrittura e Tutte |
| Funzioni di Brevo | Nessuna, Lettura, Lettura/scrittura e Tutte |
Imposta le autorizzazioni per una chiave API
Per impostare le autorizzazioni su una nuova chiave o modificare quelle di una esistente, consulta il nostro articolo dedicato Creazione e gestione delle chiavi API.
Cosa succede quando una chiave non ha l'autorizzazione richiesta
Se un'integrazione effettua una chiamata che la sua chiave non consente, Brevo blocca la chiamata e restituisce un errore Access denied for resource (Accesso negato alla risorsa). Per risolverlo, consulta il nostro articolo dedicato Risoluzione dei problemi: Problemi con le chiavi API.
⏭️ E adesso?
- Creazione o eliminazione di una chiave API
- Risoluzione dei problemi - Problemi con le chiavi API
- Autorizzazione e blocco degli indirizzi IP per la sicurezza di API e SMTP
🤔 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.