Créer et gérer vos clés SMTP

Les clés SMTP vous permettent de connecter en toute sécurité votre site web, votre application ou un autre outil au relais SMTP de Brevo, afin d’envoyer des emails transactionnels directement depuis vos propres systèmes. 

Bon à savoir

  • Seuls les utilisateurs ou le propriétaire du compte disposant de l’autorisation SMTP peuvent accéder à la page SMTP et API, créer une nouvelle clé SMTP ou supprimer une clé SMTP existante. Pour en savoir plus sur les autorisations utilisateurs et les niveaux d'autorisation, consultez notre article dédié Ajouter des utilisateurs et attribuer des autorisations dans Brevo.
  • Chaque fois qu’une clé SMTP est créée ou supprimée du compte, le propriétaire du compte recevra une notification par email, comprenant des détails tels que l’adresse IP et la localisation.

Qu'est-ce qu'une clé SMTP ?

Pour envoyer des emails transactionnels depuis votre site web ou votre application, vous devez configurer vos paramètres SMTP pour qu’ils pointent vers Brevo SMTP, en utilisant les identifiants suivants :

  • Nom d'utilisateur SMTP : une adresse email unique qui sert de nom d’utilisateur.
  • Clé SMTP : une clé secrète qui sert de mot de passe.

Où puis-je trouver mes clés SMTP ?

Pour assurer la sécurité de vos clés SMTP, les clés nouvellement créées ne sont pas entièrement visibles dans votre compte Brevo. Sur la page SMTP et API, seuls les derniers chiffres de chaque clé sont affichés afin que vous puissiez les identifier si nécessaire.

keys.jpg

Pour cette raison, nous vous recommandons vivement de stocker votre clé SMTP dans un emplacement sécurisé dès que vous la créez. Si vous perdez votre clé, vous devrez en générer une nouvelle, la stocker en toute sécurité et remplacer la clé précédente dans votre configuration.

❗️Important
Si le blocage des adresses IP inconnues est activé sur votre compte et Brevo détecte un appel API ou SMTP provenant d’une adresse IP que vous n’avez jamais utilisée, vous recevrez un email de sécurité vous demandant de confirmer ou de refuser l’activité. Pour en savoir plus, consultez notre article dédié Autoriser et bloquer des adresses IP pour la sécurité de l’API et du SMTP.

Créer une nouvelle clé SMTP

Pour créer une nouvelle clé SMTP dans votre compte Brevo :

  1. Cliquez sur le menu déroulant du compte et sélectionnez Paramètres > SMTP et API.
  2. Sous l’onglet SMTP, cliquez sur Générer une nouvelle clé SMTP.
  3. Saisissez le code de vérification à 6 chiffres envoyé à l’adresse email de votre compte, puis cliquez sur Vérifier.
    💡 Bon à savoir
    Si vous ne recevez pas le code, vous pouvez le renvoyer par email ou SMS au bout d'une minute.
  4. Saisissez un nom pour votre clé SMTP. Incluez le nom de l’intégration dans le nom de la clé pour l’identifier facilement.
  5. Sélectionnez la variante de clé SMTP que vous souhaitez générer :
    • [Recommandé] Standard : clé SMTP sécurisée par défaut de 64 caractères.
    • Courte : clé plus courte de 15 caractères.
      ❗️Important
      La variante de la clé SMTP courte n’est recommandée que si votre client SMTP ne prend pas en charge les mots de passe longs. Sachez que certains clients SMTP peuvent tronquer silencieusement le champ du mot de passe et échouer à l’authentification sans message d’erreur clair. Si vous constatez un échec d’authentification que vous ne pouvez pas expliquer autrement, essayez plutôt de générer une clé courte.
  6. Définissez une date d’expiration de 7 jours à 1 an ou choisissez aucune expiration pour la clé SMTP.
    ❗️Important

    Choisir Aucune expiration signifie simplement que la clé n'a pas de date d'expiration fixe. Cela ne l'exempte pas de la politique d'inactivité distincte de Brevo :

    • Date d’expiration atteinte : vous recevrez un email de rappel 3 jours avant et le jour de l’expiration de la clé.
    • 90 jours d’inactivité : même si aucune date d’expiration n’est définie, la clé est désactivée si elle n’a pas envoyé d’email avec succès pendant 90 jours. Vous recevrez un email de rappel 7 jours avant et le jour où cela se produira.
  7. Cliquez sur Générer. La clé SMTP complète s’affiche.
    smtp_key_generate_en-us.png
  8. Copiez la clé complète et enregistrez-la dans un emplacement sécurisé, tel qu’une application de gestion de mots de passe ou un système de stockage interne.
    💡 Bon à savoir
    La clé complète est affichée une seule fois. Assurez-vous d’en créer une copie sécurisée. Cette clé est confidentielle et ne doit jamais être partagée ou publiée en ligne.
  9. Cliquez sur OK.
    smtp_key_copy_en-us.png

Vous avez créé avec succès une nouvelle clé SMTP.

Désactiver une clé SMTP

Si vous souhaitez arrêter temporairement l’utilisation d’une clé SMTP, vous pouvez la désactiver :

  1. Cliquez sur le menu déroulant du compte et sélectionnez Paramètres > SMTP & API.
  2. Sous l’onglet SMTP, sélectionnez la clé SMTP à supprimer.
  3. Cliquez sur Désactiver la clé SMTP.
    deactivate.jpg
  4. Cliquez sur Désactiver pour confirmer.

Votre clé SMTP est maintenant désactivée.

Réactiver une clé SMTP

Pour réactiver une clé SMTP précédemment désactivée :

  1. Cliquez sur le menu déroulant du compte et sélectionnez Paramètres > SMTP & API.
  2. Sous l’onglet SMTP, sélectionnez la clé SMTP à réactiver.
  3. Cliquez sur Activer la clé SMTP.
    activate.jpg
  4. Cliquez sur Activer pour confirmer.

Votre clé SMTP est à nouveau active.

Supprimer une clé SMTP

❗️Important
La suppression d’une clé SMTP est irréversible. Avant de supprimer une clé, assurez-vous qu’elle n’est plus utilisée ou que vous l’avez remplacé par une nouvelle.
Si vous supprimez une clé encore utilisée, vos emails transactionnels cesseront d’être envoyés.

Si votre compte a été compromis ou si vous n’utilisez plus une intégration spécifique, vous pouvez supprimer sa clé SMTP :

  1. Cliquez sur le menu déroulant du compte et sélectionnez Paramètres > SMTP & API.
  2. Sous l’onglet SMTP, sélectionnez la clé SMTP à supprimer.
  3. Cliquez sur Supprimer la clé SMTP.
    delete.jpg
  4. Cliquez sur Supprimer pour confirmer.

Vous avez bien supprimé votre clé SMTP.

Bonnes pratiques pour la gestion des clés SMTP

Traitez vos clés SMTP avec le même niveau de sécurité qu’un mot de passe. Voici quelques bonnes pratiques :

  • Utilisez une clé SMTP différente pour chaque intégration. Incluez le nom de l’intégration dans le nom de la clé pour l’identifier facilement. Cela facilite la révocation d’une seule clé si elle est compromise.
  • Stockez vos clés en toute sécurité, et non dans des documents, des emails ou des notes.
  • N’exposez jamais votre clé SMTP publiquement. Masquez-la ou recadrez-la dans les captures d’écran et les vidéos.
  • Évitez de partager des clés par email, au cas où votre boîte email serait compromise.
  • Supprimez régulièrement les clés inutilisées pour minimiser les risques de sécurité.
  • Gardez vos clés actives utilisées en envoyant au moins un email par l’intermédiaire de la clé tous les 90 jours, même en l’absence de date d’expiration définie, afin d’éviter une désactivation inattendue. 
  • Blocage d’adresses IP activé de sorte que les appels SMTP et API provenant d’adresses IP non reconnues soient bloqués jusqu’à ce que vous les autorisiez. Pour en savoir plus, consultez notre article dédié Autoriser et bloquer des adresses IP pour la sécurité de l’API et du SMTP.

Résoudre les problèmes liés à vos clés SMTP

Si vous rencontrez des problèmes avec vos clés SMTP, consultez les conseils pour résoudre les problèmes suivants avant de contacter notre équipe d'assistance.

Ma clé SMTP indique « Expiration : jamais », mais j’ai reçu un avertissement d’inactivité

Vous n’avez sélectionné aucune date d’expiration lors de la création de votre clé SMTP, mais vous avez quand même reçu un email d’avertissement indiquant que la clé sera désactivée pour cause d'inactivité.

Causes et solutions courantes

La date d’expiration et la règle d’inactivité sont deux paramètres distincts

Choisir Aucune expiration signifie simplement que la clé n'a pas de date d'expiration fixe. Cela n’exempte pas la clé de la politique d’inactivité de Brevo : toute clé SMTP n’ayant pas envoyé d’email avec succès pendant 90 jours peut toujours être désactivée, indépendamment de son paramètre d’expiration.

Solution : confirme que votre intégration utilise bien cette clé spécifique (elle utilise peut-être une autre clé de votre compte) et qu’elle envoie au moins un email avec succès avant la fin de la période de 90 jours. Si la clé a déjà été désactivée, vous pouvez la réactiver.

Vérifier la correction

Envoyez un email de test en utilisant la clé, puis vérifiez sur la page SMTP & API que son statut apparaît comme étant actif.

Si le problème persiste, contactez notre équipe d’assistance et incluez les derniers chiffres de la clé et le message d’avertissement exact que vous avez reçu.

J’ai reçu un email de sécurité « Vérifier une nouvelle adresse IP »

Vous avez reçu un email de Brevo vous demandant de confirmer ou de refuser un appel API ou SMTP effectué à partir d’une adresse IP non reconnue, et vous ne savez pas s’il est légitime ni que faire ensuite.

Causes et solutions courantes

Un appel SMTP ou API a été effectué à partir d’une adresse IP non utilisée auparavant sur votre compte

Si le blocage des adresses IP inconnues est activé sur votre compte, cet email est envoyé chaque fois qu’un appel est détecté depuis une adresse IP n’ayant jamais été utilisée. Cela ne signifie pas nécessairement qu’il y a un problème : cela peut être déclenché par une intégration légitime (par exemple, un nouveau serveur ou un outil tiers) qui se connecte pour la première fois.

Solution : si vous reconnaissez l’activité, autorisez la nouvelle adresse IP depuis l’email ou depuis la page d'adresses IP autorisées. Si vous ne la reconnaissez pas, refusez-la et changez immédiatement la clé SMTP concernée. Pour en savoir plus, consultez notre article dédié Autoriser et bloquer des adresses IP pour la sécurité de l’API et du SMTP.

Vérifier la correction

Accédez à la page Adresses IP autorisées et vérifiez que l’adresse IP affiche le statut attendu (autorisé ou supprimé).

Si vous continuez de recevoir des alertes pour des adresses IP que vous ne reconnaissez pas après avoir modifié votre clé SMTP, contactez notre équipe d’assistance.

⏭️ Et ensuite ?

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

💬 Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 23 sur 58