Les autorisations des clés API vous permettent de contrôler précisément ce que chaque clé API peut faire dans votre compte Brevo. Accorder à une intégration uniquement les accès dont elle a besoin permet d'éviter qu'une clé compromise ou partagée puisse être utilisée pour autre chose.
Bon à savoir
- Les clés créées avant la disponibilité des autorisations conservent un accès complet jusqu'à ce que vous les modifiiez.
- Les autorisations s'appliquent uniquement aux clés API. Les identifiants SMTP ne sont pas concernées. Pour en savoir plus, consultez notre article dédié Créer et gérer vos clés SMTP.
Types d'accès
Lorsque vous créez ou modifiez une clé API, vous devez d'abord choisir les accès de la clé à votre compte :
- [Recommandé] Restreinte : vous choisissez exactement les accès de la clé. Chaque ressource commence par Aucune, vous ne sélectionnez donc qu'un niveau d'autorisation pour les ressources dont la clé a besoin.
- Complet : la clé peut accéder à toutes les ressources actuelles et futures.
Niveaux d'autorisation
Pour chaque ressource d'une clé restreinte, vous choisissez l'un des quatre niveaux d'autorisation. Le tableau suivant indique chaque niveau d'autorisation :
| Niveau | Ce que la clé peut faire | Requêtes API autorisées |
|---|---|---|
| Aucun | N'a aucun accès à la ressource. | Aucun |
| Lecture | Peut afficher la ressource, mais ne peut pas la modifier. | GET |
| Lecture/Écriture | Peut afficher, créer et mettre à jour la ressource, mais ne peut pas la supprimer. | GET, POST et PUT |
| Tous | Dispose d'un accès complet à la ressource, y compris la suppression. | Tous les types de requêtes |
Ressources disponibles
Vous pouvez définir des autorisations pour 18 ressources. Toutes les ressources ne proposent pas tous les niveaux. Le tableau suivant indique les niveaux disponibles pour chaque ressource :
| Ressource | Niveaux disponibles |
|---|---|
| Email transactionnel | Aucun, lecture et tout |
| SMS transactionnel | Aucun, Lecture, Lecture/Écriture et Tous |
| WhatsApp transactionnel | Aucun, Lecture, Lecture/Écriture et Tous |
| Campagnes email | Aucun, lecture et tout |
| Campagnes SMS | Aucun, lecture et tout |
| Campagnes WhatsApp | Aucun, lecture et tout |
| Contacts | Aucun, lecture et tout |
| Opportunités | Aucun, lecture et tout |
| Conversations | Aucun, Lecture, Lecture/Écriture et Tous |
| E-commerce | Aucun, Lecture, Lecture/Écriture et Tous |
| Fidélité | Aucun, Lecture, Lecture/Écriture et Tous |
| Événements | Aucun, Lecture, Lecture/Écriture et Tous |
| Objets | Aucun, lecture et tout |
| Compte | Aucun, Lecture, Lecture/Écriture et Tous |
| Webhooks | Aucun, Lecture, Lecture/Écriture et Tous |
| Organisation | Aucun, lecture et tout |
| Wallet | Aucun, Lecture, Lecture/Écriture et Tous |
| Fonctions Brevo | Aucun, Lecture, Lecture/Écriture et Tous |
Définir les autorisations d'une clé API
Pour définir des autorisations sur une nouvelle clé ou modifier les autorisations d'une clé existante, consultez notre article dédié Créer ou gérer vos clés API.
Que se passe-t-il lorsqu'une clé ne dispose pas de l'autorisation requise
Si une intégration effectue un appel que sa clé n'autorise pas, Brevo bloque l'appel et renvoie une erreur Accès refusé à la ressource. Pour résoudre ce problème, consultez notre article dédié Résoudre les problèmes - Problèmes de clés API.
⏭️ Et après ?
- Créer et gérer vos clés API
- Résoudre les problèmes - Problèmes liés aux clés API
- Autoriser et bloquer les adresses IP pour la sécurité des API et SMTP
🤔 Vous avez des questions ?
Pour toute question, n’hésitez pas à contacter notre service client en créant un ticket à partir de votre compte. Si vous n’avez pas encore de compte, vous pouvez nous contacter ici.
Si vous avez besoin d'aide pour un projet impliquant Brevo, nous pouvons vous mettre en relation avec une agence partenaire Brevo.