Envoyer des e-mails avec SendGrid

Ce tutoriel explique comment utiliser SendGrid pour envoyer des e-mails depuis une application s'exécutant sur une instance de machine virtuelle (VM) Compute Engine.

Objectifs

• Utiliser SendGrid avec Postfix sur une instance Compute Engine.
• Utiliser SendGrid en code Java exécuté sur une instance Compute Engine.
• Utiliser SendGrid en code Node.js exécuté sur une instance Compute Engine.
• Utiliser SendGrid avec un serveur de transport Microsoft Exchange Edge sur une instance Compute Engine.

Pour en savoir plus sur la configuration de SendGrid, consultez la documentation SendGrid destinée aux développeurs.

Coûts

Dans ce document, vous utilisez les composants facturables de Google Cloudsuivants :

• Compute Engine

Vous pouvez obtenir une estimation des coûts en fonction de votre utilisation prévue à l'aide du simulateur de coût.

Les nouveaux utilisateurs de Google Cloud peuvent bénéficier d'un essai sans frais.

Avant de commencer

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. In the Google Cloud console, go to the Create an instance page.

   Go to Create an instance

2. Set Name to sendgrid-tutorial.
3. In the OS and Storage section, click Change to begin configuring your boot disk.
4. Dans l'onglet Public images, sélectionnez a Debian or CentOS image version.
5. Cliquez sur Sélectionner.
6. Pour créer la VM, cliquez sur Créer.
7. Inscrivez-vous au service de messagerie SendGrid via Google Cloud Marketplace. Notez vos informations d'identification de compte SMTP SendGrid, y compris le nom d'utilisateur, le mot de passe et le nom d'hôte. Votre nom d'utilisateur et votre mot de passe SMTP sont les mêmes que ceux utilisés pour vous inscrire au service. Le nom d'hôte SendGrid est smtp.sendgrid.net.
8. Créez une clé API :
   1. Connectez-vous à Sendgrid et accédez à Paramètres > Clés API.
   2. Créez une clé API.
   3. Sélectionnez les autorisations pour la clé. La clé a besoin au minimum de l'autorisation d'envoi d'e-mails pour envoyer des e-mails.
   4. Cliquez sur Enregistrer pour créer la clé.
   5. SendGrid génère une nouvelle clé. Il s'agit de la seule copie de la clé. Assurez-vous de la copier et de l'enregistrer pour plus tard.

Envoyer des messages depuis votre instance avec Postfix

Pour vous connecter à votre instance sendgrid-tutorial et exécuter SendGrid avec Postfix, procédez comme suit.

Remarque : La documentation de SendGrid fournit un ensemble d'instructions pour l'installation et la configuration de Postfix. Si vous rencontrez des problèmes lors de la configuration de Postfix avec SendGrid, consultez les instructions de SendGrid pour Postfix.

Se connecter à l'instance sendgrid-tutorial à l'aide de SSH

1. In the Google Cloud console, go to the VM instances page.

   Go to VM instances

2. In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

Configurer SendGrid en tant que relais SMTP avec Postfix

Pour utiliser SendGrid en tant que relais SMTP avec Postfix, exécutez les commandes suivantes dans votre terminal SSH.

1. Devenez un superutilisateur :

   sudo su -
   

2. Définissez un "umask" sécurisé :

   umask 077
   

3. Installez l'agent de transfert de messages Postfix :

   Debian

   apt update && apt -y install postfix libsasl2-modules

   CentOS

   yum install postfix cyrus-sasl-plain cyrus-sasl-md5 -y

   À l'invite, sélectionnez la configuration Uniquement en local et acceptez le nom de domaine par défaut.

4. Modifiez les options de configuration de Postfix. Ouvrez /etc/postfix/main.cf pour y apporter des modifications. Par exemple, pour utiliser l'éditeur de texte nano, saisissez la commande suivante :

   nano /etc/postfix/main.cf
   

5. Mettez à jour le fichier :

   1. Passez les lignes suivantes en commentaire :

      # default_transport = error
      # relay_transport = error
      

   2. Ajoutez les lignes suivantes à la fin du fichier :

      relayhost = [smtp.sendgrid.net]:2525
      smtp_tls_security_level = encrypt
      smtp_sasl_auth_enable = yes
      smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
      header_size_limit = 4096000
      smtp_sasl_security_options = noanonymous
      

      Les lignes ci-dessus appliquent la compatibilité des protocoles SSL/TLS et configurent l'authentification SMTP pour ces requêtes. Un module de couche de sécurité et d'authentification simple (SASL, Simple Authentication and Security Layer) gère l'authentification dans la configuration de Postfix.

6. Enregistrez et fermez le fichier.

7. Générez la carte de mot de passe SASL à l'aide de la clé API créée dans la section Avant de commencer. Remplacez your-api-key par la clé API que vous avez générée.

   echo [smtp.sendgrid.net]:2525 apikey:your-api-key >> /etc/postfix/sasl_passwd

8. Avec l'utilitaire postmap, générez un fichier .db :

   postmap /etc/postfix/sasl_passwd
   

9. Vérifiez que vous disposez d'un fichier .db :

   ls -l /etc/postfix/sasl_passwd*
   

   -rw------- 1 root root    ...  /etc/postfix/sasl_passwd
   -rw------- 1 root root    ...  /etc/postfix/sasl_passwd.db
   

10. Supprimez le fichier contenant vos informations d'identification, car il n'est plus nécessaire :

    rm /etc/postfix/sasl_passwd
    

11. Définissez les autorisations sur votre fichier .db et vérifiez que l'autre fichier a été supprimé :

    chmod 600 /etc/postfix/sasl_passwd.db
    ls -la /etc/postfix/sasl_passwd*
    

    -rw------- 1 root root    ...  /etc/postfix/sasl_passwd.db
    

12. Rechargez votre configuration pour charger les paramètres modifiés :

    Debian

    /etc/init.d/postfix restart
    

    CentOS

    postfix reload
    

13. Installez le package mailutils ou mailx :

    Debian

    apt -y install mailutils

    CentOS

    yum install mailx -y
    

14. Envoyez un e-mail test :

    echo 'message' | mail -s subject [e-mail]

    Remplacez l'élément suivant :

    • message : corps de l'e-mail.
    • subject : objet de l'e-mail.
    • [e-mail] : adresse e-mail à laquelle vous souhaitez envoyer un message.

    Dans vos journaux système, recherchez une ligne d'état contenant status et le code de réponse du serveur indiquant le succès de l'opération (250) :

    Debian

    tail -n 5 /var/log/syslog
    

    CentOS

    tail -n 5 /var/log/maillog
    

Envoyer des e-mails avec Java sur votre instance

Se connecter à l'instance sendgrid-tutorial à l'aide de SSH

1. In the Google Cloud console, go to the VM instances page.

   Go to VM instances

2. In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

Créer et envoyer un e-mail

Les instructions suivantes utilisent la bibliothèque cliente Java de SendGrid pour créer et envoyer un e-mail via SendGrid. L'exemple complet est disponible sur GitHub.

Dans votre terminal SSH :

1. Devenez un superutilisateur et définissez un "umask" sécurisé :

   sudo su -
   umask 077
   

2. Installez Java et Maven :

   apt -y update && apt -y install git-core openjdk-11-jdk maven
   

3. Clonez le dépôt GitHub :

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git
   

4. Accédez au code source principal de l'exemple :

   cd /root/java-docs-samples/compute/sendgrid/src/main/java/com/example/compute/sendgrid
   

5. Ouvrez SendEmailServelet.java pour y apporter des modifications.

   • Remplacez your-sendgrid-api-key par la clé API de votre compte SendGrid.

   • Remplacez your-sendgrid-from-email par l'adresse e-mail à partir de laquelle vous souhaitez envoyer l'e-mail.

   • Remplacez destination-email par l'adresse e-mail à laquelle vous souhaitez envoyer des e-mails.

6. Accédez au répertoire racine de l'exemple de code :

   cd /root/java-docs-samples/compute/sendgrid
   

7. Réalisez le package de la classe Java :

   mvn clean package
   

8. Accédez au nouveau répertoire target :

   cd target
   

9. Définissez les autorisations pour exécuter le fichier jar :

   chmod +x compute-sendgrid-1.0-SNAPSHOT-jar-with-dependencies.jar
   

10. Exécutez le sélecteur de version Java alternatif :

    update-alternatives --config java
    

    Cochez l'option java-11-openjdk-amd64.

11. Exécutez le fichier Java :

    java -jar compute-sendgrid-1.0-SNAPSHOT-jar-with-dependencies.jar
    

Envoyer un e-mail avec Node.js sur votre instance

Pour exécuter cet exemple, Node.js doit être installé sur votre instance de VM dans sa version 7.6 ou une version ultérieure.

Se connecter à l'instance sendgrid-tutorial à l'aide de SSH

1. In the Google Cloud console, go to the VM instances page.

   Go to VM instances

2. In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

Créer et envoyer un e-mail

Dans votre terminal SSH :

1. Devenez un superutilisateur et définissez un "umask" sécurisé :

   sudo su -
   umask 077
   

2. Mettez à jour vos dépôts de packages :

   Debian

   apt update
   

   CentOS

   yum update -y
   

3. Installez les dépendances Node.js :

   Debian

   apt -y install git-core curl build-essential openssl libssl-dev
   

   CentOS

   yum install git-core curl openssl openssl-devel -y
   yum groupinstall "Development Tools" -y
   

4. Installez Node.js. Par défaut, npm est également installé :

   Debian

   curl -sL https://deb.nodesource.com/setup_14.x | sudo bash -
   sudo apt -y install nodejs
   

   CentOS

   curl --silent --location https://rpm.nodesource.com/setup_14.x | bash -
   

   Ensuite, installez Node.js :

   yum -y install nodejs
   

5. Installez le client SendGrid Node.js :

   npm install sendgrid
   

6. Clonez l'exemple de dépôt :

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git
   

7. Accédez au répertoire contenant l'exemple SendGrid :

   cd nodejs-docs-samples/compute
   

8. Copiez le fichier sendgrid.js :

   cp sendgrid.js sendmail.js
   

9. Ouvrez sendmail.js pour y apporter des modifications.

   • Remplacez your-sendgrid-api-key par la clé API de votre compte SendGrid.

   • Remplacez [e-mail] par l'adresse e-mail à partir de laquelle vous souhaitez envoyer l'e-mail.

   • Remplacez [e-mail] par l'adresse e-mail à laquelle vous souhaitez envoyer l'e-mail.

   // This sample is based off of:
   // https://github.com/sendgrid/sendgrid-nodejs/tree/master/packages/mail
   const sendgrid = require('@sendgrid/mail');
   sendgrid.setApiKey(process.env.SENDGRID_API_KEY || '<your-sendgrid-api-key>');
   
   async function sendgridExample() {
     await sendgrid.send({
       to: '[e-mail]',
       from: '[e-mail]',
       subject: 'Sendgrid test email from Node.js on Google Cloud Platform',
       text: 'Well hello! This is a Sendgrid test email from Node.js on Google Cloud Platform.',
     });
   }
   sendgridExample();

10. Exécutez le programme pour envoyer un e-mail via SendGrid :

    node sendmail.js
    

Envoyer des e-mails depuis un serveur de transport Edge Exchange

Vous pouvez configurer Microsoft Exchange pour envoyer des e-mails sortants avec SendGrid en configurant un connecteur d'envoi sortant. Pour plus d'informations, consultez Déployer Microsoft Exchange Server 2016 sur Compute Engine.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans ce tutoriel soient facturées sur votre compte Google Cloud, supprimez le projet contenant les ressources, ou conservez le projet et supprimez chaque ressource individuellement.

Supprimer le projet

Le moyen le plus simple d'empêcher la facturation est de supprimer le projet que vous avez créé pour ce tutoriel.

Pour supprimer le projet :

Attention : La suppression d'un projet entraîne les effets décrits ci-dessous :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Supprimer votre instance Compute Engine

Pour supprimer une instance Compute Engine :

1. In the Google Cloud console, go to the VM instances page.

   Go to VM instances

2. Select the checkbox for your sendgrid-tutorial instance.
3. To delete the instance, click More actions, click Delete, and then follow the instructions.

Étapes suivantes

Découvrez des architectures de référence, des schémas et des bonnes pratiques concernant Google Cloud. Consultez notre Cloud Architecture Center.