View a markdown version of this page

Envoi d'un e-mail via l'interface SMTP Amazon SES par programmation - Amazon Simple Email Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Envoi d'un e-mail via l'interface SMTP Amazon SES par programmation

Pour envoyer un e-mail à l'aide de l'interface SMTP d'Amazon SES, vous pouvez utiliser SMTP-enabled langage de programmation, serveur de messagerie ou application. Avant de commencer, complétez les tâches dans Configuration d'Amazon Simple Email Service. Vous aurez également besoin d'obtenir les informations supplémentaires suivantes :

Exemples de code

Vous pouvez accéder à l'interface SMTP d'Amazon SES à l'aide d'un SMTP-enabled langage de programmation. Vous fournissez le nom d'hôte et le numéro de port SMTP Amazon SES, ainsi que vos informations d'identification SMTP, puis vous utilisez les fonctions SMTP génériques du langage de programmation pour envoyer l'e-mail.

Amazon Elastic Compute Cloud (Amazon EC2) limite par défaut le trafic des e-mails sur le port 25. Pour éviter les délais d'expiration lors de l'envoi d'e-mails via le point de terminaison SMTP à partir d'Amazon EC2, vous pouvez demander la suppression de ces restrictions. Pour plus d'informations, voir Comment supprimer la restriction sur le port 25 de mon instance Amazon EC2 ou AWS Lambda fonction ? dans le AWS Centre de connaissances.

Les exemples de code de cette section pour Java et PHP utilisent le port 587 pour éviter ce problème.

Note

Dans ces didacticiels, vous vous envoyez un e-mail afin de vérifier si vous l'avez reçu. Pour d'autres essais ou pour des tests de charge, utilisez le simulateur de boîte aux lettres Amazon SES. Les e-mails envoyés au simulateur de boîte aux lettres ne sont pas pris en compte dans votre quota d'envoi et vos taux de retours à l'expéditeur et de réclamations. Pour plus d'informations, consultez Utilisation manuelle du simulateur de boîte aux lettres.

Sélectionnez un langage de programmation pour afficher l'exemple correspondant à cette langue:

Avertissement

Amazon SES ne recommande pas d'utiliser des informations d'identification statiques. Reportez-vous à AWS Secrets Manager pour savoir comment améliorer votre niveau de sécurité en supprimant les informations d'identification codées en dur de votre code source. Ce didacticiel est uniquement destiné à tester l'interface SMTP d'Amazon SES dans un environnement hors production.

Java

Cet exemple utilise IDE Eclipse et le JavaMail API pour envoyer des e-mails via Amazon SES à l'aide de l'interface SMTP.

Avant d'effectuer la procédure suivante, effectuez les tâches dans Configuration d'Amazon Simple Email Service.

Pour envoyer un e-mail à l'aide de l'interface SMTP Amazon SES avec Java
  1. Dans un navigateur Web, accédez à JavaMail GitHub page. En dessous Actifs, choisissez javax.mail.jar pour télécharger la dernière version de JavaMail.

    Important

    Ce tutoriel nécessite JavaMail version 1.5 ou ultérieure. Ces procédures ont été testées à l'aide de JavaMail la version 1.6.1.

  2. Dans un navigateur Web, accédez à Activation de Jakarta GitHub page, et en dessous JavaBeans Version finale de Activation Framework 1.2.1, téléchargez le jakarta.activation.jar

  3. Créez un projet Eclipse en procédant comme suit :

    1. Démarrez Eclipse.

    2. Dans Eclipse, choisissez File (Fichier), New (Nouveau), puis Java Project.

    3. Dans la boîte de dialogue Create a Java Project (Créer un projet Java), saisissez un nom de projet, puis choisissez Next (Suivant).

    4. Dans la boîte de dialogue Java Settings (Paramètres Java), choisissez l'onglet Libraries (Bibliothèques).

    5. Sélectionnez Parcours et ajoutez les deux fichiers jar externes javax.mail.jar et jakarta.activation.jar à l'aide du Ajouter des fichiers JAR externes bouton.

    6. Choisissez Add External JARs (Ajouter des JARs externes).

    7. Accédez au dossier dans lequel vous avez téléchargé JavaMail. Choisissez le fichier javax.mail.jar, puis Open (Ouvrir).

    8. Dans la boîte de dialogue Java Settings (Paramètres Java), choisissez Finish (Terminer).

  4. Dans la fenêtre Package Explorer (Explorateur de paquets) d'Eclipse, développez votre projet.

  5. Sous votre projet, cliquez avec le bouton droit sur le répertoire src, puis choisissez New (Nouveau) et Class (Classe).

  6. Dans la boîte de dialogue New Java Class (Nouvelle classe Java), dans le champ Name (Nom), entrez AmazonSESSample et choisissez Finish (Terminer).

  7. Remplacez la totalité du contenu de AmazonSESSample.java par le code suivant :

    import java.util.Properties; import javax.mail.Message; import javax.mail.Session; import javax.mail.Transport; import javax.mail.internet.InternetAddress; import javax.mail.internet.MimeMessage; public class AmazonSESSample { // Replace sender@example.com with your "From" address. // This address must be verified. static final String FROM = "sender@example.com"; static final String FROMNAME = "Sender Name"; // Replace recipient@example.com with a "To" address. If your account // is still in the sandbox, this address must be verified. static final String TO = "recipient@example.com"; // Replace smtp_username with your Amazon SES SMTP user name. static final String SMTP_USERNAME = "smtp_username"; // The name of the Configuration Set to use for this message. // If you comment out or remove this variable, you will also need to // comment out or remove the header below. static final String CONFIGSET = "ConfigSet"; // Amazon SES SMTP host name. This example uses the US West (Oregon) region. // See https://docs.aws.amazon.com/ses/latest/DeveloperGuide/regions.html#region-endpoints // for more information. static final String HOST = "email-smtp.us-west-2.amazonaws.com"; // The port you will connect to on the Amazon SES SMTP endpoint. static final int PORT = 587; static final String SUBJECT = "Amazon SES test (SMTP interface accessed using Java)"; static final String BODY = String.join( System.getProperty("line.separator"), "<h1>Amazon SES SMTP Email Test</h1>", "<p>This email was sent with Amazon SES using the ", "<a href='https://github.com/javaee/javamail'>Javamail Package</a>", " for <a href='https://www.java.com'>Java</a>." ); public static void main(String[] args) throws Exception { // Create a Properties object to contain connection configuration information. Properties props = System.getProperties(); props.put("mail.transport.protocol", "smtp"); props.put("mail.smtp.port", PORT); props.put("mail.smtp.starttls.enable", "true"); props.put("mail.smtp.auth", "true"); // Create a Session object to represent a mail session with the specified properties. Session session = Session.getDefaultInstance(props); // Create a message with the specified information. MimeMessage msg = new MimeMessage(session); msg.setFrom(new InternetAddress(FROM,FROMNAME)); msg.setRecipient(Message.RecipientType.TO, new InternetAddress(TO)); msg.setSubject(SUBJECT); msg.setContent(BODY,"text/html"); // Add a configuration set header. Comment or delete the // next line if you are not using a configuration set msg.setHeader("X-SES-CONFIGURATION-SET", CONFIGSET); // Create a transport. Transport transport = session.getTransport(); // Get the password String SMTP_PASSWORD = fetchSMTPPasswordFromSecureStorage(); // Send the message. try { System.out.println("Sending..."); // Connect to Amazon SES using the SMTP username and password you specified above. transport.connect(HOST, SMTP_USERNAME, SMTP_PASSWORD); // Send the email. transport.sendMessage(msg, msg.getAllRecipients()); System.out.println("Email sent!"); } catch (Exception ex) { System.out.println("The email was not sent."); System.out.println("Error message: " + ex.getMessage()); } finally { // Close and terminate the connection. transport.close(); } } static String fetchSMTPPasswordFromSecureStorage() { /* IMPLEMENT THIS METHOD */ // For example, you might fetch it from a secure location or AWS Secrets Manager: https://aws.amazon.com/secrets-manager/ } }
  8. Dans AmazonSESSample.java, remplacez les adresses e-mail suivantes par vos propres valeurs :

    Important

    Les adresses e-mail sont sensibles à la casse. Assurez-vous que les adresses sont exactement les mêmes que celles que vous avez vérifiées.

    • sender@example.com — Remplacez-la par votre adresse e-mail « De ». Vous devez vérifier cette adresse avant d'exécuter ce programme. Pour plus d’informations, consultez Identités vérifiées dans Amazon SES.

    • recipient@example.com — Remplacez-la par votre adresse e-mail « À ». Si votre compte est encore dans l'environnement de test (sandbox), vous devez vérifier cette adresse avant de l'utiliser. Pour plus d’informations, consultez Demander un accès à la production (sortie du sandbox Amazon SES).

  9. Dans AmazonSESSample.java remplacez les valeurs suivantes par vos propres valeurs :

    • smtp_username — Remplacez-le par votre identifiant d'utilisateur SMTP. Notez que les informations d'identification de votre nom d'utilisateur SMTP sont une chaîne alphanumérique de 20 caractères, et pas un nom intelligible.

    • smtp_password — Mettre en œuvre `fetchSMTPPasswordFromSecureStorage` pour récupérer le mot de passe.

  10. (Facultatif) Si vous souhaitez utiliser un point de terminaison SMTP Amazon SES dans Région AWS autre que email-smtp.us-west-2.amazonaws.com, modifiez la valeur de la variable HOST au terminal que vous souhaitez utiliser. Pour connaître la liste des régions dans lesquelles Amazon SES est disponible, consultez Amazon Simple Email Service (Amazon SES) dans le document Références générales AWS.

  11. (Facultatif) – Si vous souhaitez utiliser un jeu de configurations lors de l'envoi de cet e-mail, remplacez la valeur de la variable ConfigSet par le nom du jeu de configurations. Pour en savoir plus sur les jeux de configuration, consultez Utilisation des jeux de configuration dans Amazon SES.

  12. Enregistrez AmazonSESSample.java.

  13. Pour créer le projet, choisissez Project (Projet), puis Build Project (Créer un projet). (Si cette option est désactivée, cela peut signifier que la génération automatique est activée.)

  14. Pour démarrer le programme et envoyer l'e-mail, choisissez Run (Exécuter), puis à nouveau Run (Exécuter).

  15. Vérifiez la sortie. Si l'e-mail a été envoyé avec succès, la console affiche « E-mail envoyé ! » Dans le cas contraire, un message d'erreur s'affiche.

  16. Connectez-vous au client de messagerie de l'adresse du destinataire. Vous verrez le message que vous avez envoyé.

PHP

Cet exemple utilise la classe PHPMailer pour envoyer des e-mails via Amazon SES à l'aide de l'interface SMTP.

Avant d'effectuer la procédure suivante, effectuez les tâches dans Configuration d'Amazon Simple Email Service. En plus de configurer Amazon SES, vous devez remplir les conditions préalables suivantes pour envoyer des e-mails avec PHP :

Prérequis :
  • Installez PHP — PHP est disponible sur http://php.net/downloads.php. Après avoir installé PHP, ajoutez le chemin d'accès à PHP dans vos variables d'environnement afin de pouvoir exécuter PHP à partir de n'importe quelle invite de commande.

  • Installez le gestionnaire de dépendances Composer — Après avoir installé le gestionnaire de dépendances Composer, vous pouvez télécharger et installer la classe PHPMailer et ses dépendances. Pour installer Composer, suivez les instructions d'installation sur https://getcomposer.org/download.

  • Installez la classe PHPMailer — Après avoir installé Composer, exécutez la commande suivante pour installer PHPMailer :

    path/to/composer require phpmailer/phpmailer

    Dans la commande précédente, remplacez path/to/ avec le chemin où vous avez installé Composer.

Pour envoyer un e-mail à l'aide de l'interface SMTP Amazon SES avec PHP
  1. Créez un fichier nommé amazon-ses-smtp-sample.php. Ouvrez le fichier dans un éditeur de texte et collez le code suivant :

    <?php // Import PHPMailer classes into the global namespace // These must be at the top of your script, not inside a function use PHPMailer\PHPMailer\PHPMailer; use PHPMailer\PHPMailer\Exception; // If necessary, modify the path in the require statement below to refer to the // location of your Composer autoload.php file. require 'vendor/autoload.php'; // Replace sender@example.com with your "From" address. // This address must be verified with Amazon SES. $sender = 'sender@example.com'; $senderName = 'Sender Name'; // Replace recipient@example.com with a "To" address. If your account // is still in the sandbox, this address must be verified. $recipient = 'recipient@example.com'; // Replace smtp_username with your Amazon SES SMTP user name. $usernameSmtp = 'smtp_username'; // Specify a configuration set. If you do not want to use a configuration // set, comment or remove the next line. $configurationSet = 'ConfigSet'; // If you're using Amazon SES in a region other than US West (Oregon), // replace email-smtp.us-west-2.amazonaws.com with the Amazon SES SMTP // endpoint in the appropriate region. $host = 'email-smtp.us-west-2.amazonaws.com'; $port = 587; // The subject line of the email $subject = 'Amazon SES test (SMTP interface accessed using PHP)'; // The plain-text body of the email $bodyText = "Email Test\r\nThis email was sent through the Amazon SES SMTP interface using the PHPMailer class."; // The HTML-formatted body of the email $bodyHtml = '<h1>Email Test</h1> <p>This email was sent through the <a href="https://aws.amazon.com/ses">Amazon SES</a> SMTP interface using the <a href="https://github.com/PHPMailer/PHPMailer"> PHPMailer</a> class.</p>'; $mail = new PHPMailer(true); try { // Specify the SMTP settings. $mail->isSMTP(); $mail->setFrom($sender, $senderName); $mail->Username = $usernameSmtp; $mail->Password = fetchSMTPPasswordFromSecureStorage(); $mail->Host = $host; $mail->Port = $port; $mail->SMTPAuth = true; $mail->SMTPSecure = 'tls'; $mail->addCustomHeader('X-SES-CONFIGURATION-SET', $configurationSet); // Specify the message recipients. $mail->addAddress($recipient); // You can also add CC, BCC, and additional To recipients here. // Specify the content of the message. $mail->isHTML(true); $mail->Subject = $subject; $mail->Body = $bodyHtml; $mail->AltBody = $bodyText; $mail->Send(); echo "Email sent!" , PHP_EOL; } catch (phpmailerException $e) { echo "An error occurred. {$e->errorMessage()}", PHP_EOL; //Catch errors from PHPMailer. } catch (Exception $e) { echo "Email not sent. {$mail->ErrorInfo}", PHP_EOL; //Catch errors from Amazon SES. } function fetchSMTPPasswordFromSecureStorage() { /* IMPLEMENT THIS METHOD */ // For example, you might fetch it from a secure location or AWS Secrets Manager: https://aws.amazon.com/secrets-manager/ } ?>
  2. Dans amazon-ses-smtp-sample.php, remplacez les valeurs suivantes par vos propres valeurs :

    • sender@example.com — Remplacez-la par une adresse e-mail que vous avez vérifiée auprès d'Amazon SES. Pour plus d’informations, consultez Identités vérifiées. Les adresses e-mail d'Amazon SES sont sensibles à la casse. Assurez-vous que l'adresse que vous saisissez est exactement la même que celle que vous avez vérifiée.

    • recipient@example.com — Remplacez par l'adresse du destinataire. Si votre compte est encore dans l'environnement de test (sandbox), vous devez vérifier cette adresse avant de l'utiliser. Pour plus d'informations, consultez Demander un accès à la production (sortie du sandbox Amazon SES). Assurez-vous que l'adresse que vous saisissez est exactement la même que celle que vous avez vérifiée.

    • smtp_username — Remplacez-le par votre identifiant d'utilisateur SMTP, que vous avez obtenu auprès du Paramètres SMTP page de la console Amazon SES. Ce n'est pas le même que votre ID de clé d'accès AWS . Notez que les informations d'identification de votre nom d'utilisateur SMTP sont une chaîne alphanumérique de 20 caractères, et pas un nom intelligible.

    • smtp_password — Mettre en œuvre `fetchSMTPPasswordFromSecureStorage` pour récupérer le mot de passe.

    • (Facultatif) ConfigSet — Si vous souhaitez utiliser un ensemble de configuration lors de l'envoi de cet e-mail, remplacez cette valeur par le nom du jeu de configuration. Pour en savoir plus sur les jeux de configurations, consultez Utilisation des jeux de configuration dans Amazon SES.

    • (Facultatif) email-smtp.us-west-2.amazonaws.com — Si vous souhaitez utiliser un point de terminaison SMTP Amazon SES dans une région autre que l'ouest des États-Unis (Oregon), remplacez-le par le point de terminaison SMTP Amazon SES de la région que vous souhaitez utiliser. Pour obtenir la liste des URL des points de terminaison SMTP pour Régions AWS où Amazon SES est disponible, consultez Service de messagerie Amazon Simple (Amazon SES) dans le Références générales AWS.

  3. Enregistrer amazon-ses-smtp-sample.php.

  4. Pour exécuter le programme, ouvrez une invite de commande dans le même répertoire que amazon-ses-smtp-sample.php, puis tapez php amazon-ses-smtp-sample.php.

  5. Vérifiez la sortie. Si l'e-mail a été envoyé avec succès, la console affiche « E-mail envoyé ! » Dans le cas contraire, un message d'erreur s'affiche.

  6. Connectez-vous au client de messagerie de l'adresse du destinataire. Vous verrez le message que vous avez envoyé.