Sécurité de votre intégration
Une clé identifie une organisation
Section intitulée « Une clé identifie une organisation »Consultez l’authentification pour le format des appels et les clés API pour leur création et leurs permissions. Cette page couvre leur protection et la réaction à une exposition dans une intégration SMS v2.
V2 accepte exclusivement les clés organisationnelles bf_sms_. L’authentification Bearer détermine l’organisation ; elle ne dépend pas d’un en-tête de sélection envoyé par le client.
Les ressources consultées doivent appartenir à cette organisation. Une clé technique peut rester valable après le départ de son créateur, jusqu’à sa révocation explicite. Incluez donc les clés dans votre procédure de départ et de revue des accès.
Accorder les permissions nécessaires
Section intitulée « Accorder les permissions nécessaires »Défilement horizontal si nécessaire. Au clavier : Tab, puis les flèches gauche et droite.
| Permission | Usage |
|---|---|
sms.send | Envoyer un message immédiatement |
sms.schedule | Programmer un message ou un lot |
delivery.read | Lire les messages, lots et statuts |
balance.read | Consulter le solde |
contacts.manage | Créer ou mettre à jour un contact |
Créez des clés distinctes pour des intégrations distinctes. N’accordez que les permissions utilisées.
Stocker le secret
Section intitulée « Stocker le secret »Le secret complet est présenté une seule fois lors de sa création dans Cloud. Placez-le dans le gestionnaire de secrets ou les variables protégées de votre service. Ne l’insérez pas dans un dépôt, une URL, un frontend distribué, une capture ou une collection partagée.
Le portail ne stocke pas vos clés et ne propose pas de requêtes de production dans le navigateur. Ne collez aucune clé dans la recherche de documentation.
Rotation et révocation
Section intitulée « Rotation et révocation »- Créez une nouvelle clé avec les permissions nécessaires.
- Mettez à jour la configuration protégée de votre application.
- Vérifiez les appels normaux autorisés.
- Révoquez l’ancienne clé dans Cloud.
La révocation bloque les appels futurs utilisant la clé. Elle n’annule pas les messages déjà acceptés ni les programmations existantes. Conservez vos clés d’idempotence pendant la rotation.
En cas d’exposition
Section intitulée « En cas d’exposition »Révoquez la clé concernée, remplacez-la et examinez vos journaux d’intégration. Contactez l’assistance sans transmettre le secret exposé. Fournissez l’identifiant de clé ou son préfixe public lorsque disponible.
Les engagements contractuels de disponibilité, conservation et conformité doivent être confirmés avec BEFIANA ; cette documentation technique ne les remplace pas.