Invio di email con SendGrid

---

Questo tutorial mostra come utilizzare SendGrid per inviare email da un'app in esecuzione su un'istanza di una macchina virtuale (VM) Compute Engine.

Obiettivi

• Utilizza SendGrid con Postfix su un'istanza Compute Engine.
• Utilizza SendGrid nel codice Java in esecuzione su un'istanza Compute Engine.
• Utilizza SendGrid nel codice Node.js in esecuzione su un'istanza Compute Engine.
• Utilizza SendGrid con un server di trasporto perimetrale Microsoft Exchange su un'istanza Compute Engine.

Per altre informazioni sulla configurazione di SendGrid, consulta la documentazione per gli sviluppatori di SendGrid.

Costi

In questo documento utilizzi i seguenti componenti fatturabili di Google Cloud:

• Compute Engine

Per generare una stima dei costi basata sull'utilizzo previsto, utilizza il Calcolatore prezzi. I nuovi utenti di Google Cloud potrebbero essere idonei per una prova gratuita.

Prima di iniziare

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

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

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

   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

5. Make sure that billing is enabled for your Google Cloud project.

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

   Go to Create an instance

7. Set Name to sendgrid-tutorial.
8. In the Boot disk section, click Change to begin configuring your boot disk.
9. Nella scheda Public images, scegli a Debian or CentOS image version,
10. Fai clic su Seleziona.
11. Per creare la VM, fai clic su Crea.
12. Utilizza Google Cloud Marketplace per registrarti al servizio email SendGrid. Prendi nota delle credenziali dell'account SMTP SendGrid, tra cui nome utente, password e nome host. Il nome utente e la password SMTP sono gli stessi che hai utilizzato per registrarti al servizio. Il nome host di SendGrid è smtp.sendgrid.net.
13. Crea una chiave API:
    1. Accedi a SendGrid e vai a Impostazioni > API Keys.
    2. Crea una chiave API.
    3. Seleziona le autorizzazioni per la chiave. Per poter inviare email, la chiave deve disporre almeno delle autorizzazioni Invio email.
    4. Fai clic su Salva per creare la chiave.
    5. SendGrid genera una nuova chiave. Questa è l'unica copia della chiave, quindi assicurati di copiarla e salvarla per utilizzarla in un secondo momento.

Invio di email dall'istanza con Postfix

Completa i passaggi che seguono per connetterti all'istanza sendgrid-tutorial e per eseguire SendGrid con Postfix.

Nota: la documentazione di SendGrid fornisce una serie di istruzioni per l'installazione e la configurazione di Postfix. Se riscontri problemi con la configurazione di Postfix con SendGrid, consulta le istruzioni relative a Postfix di SendGrid.

Connettiti all'istanza sendgrid-tutorial tramite 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.

Configurare SendGrid come inoltro SMTP con Postfix

Esegui i seguenti comandi nel terminale SSH per utilizzare SendGrid come relay SMTP con Postfix.

1. Diventa un superutente:

   sudo su -
   

2. Imposta un'umask sicura:

   umask 077
   

3. Installa l'agente di trasporto della posta Postfix:

   Debian

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

   CentOS

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

   Se richiesto, seleziona la configurazione Solo locale e accetta il nome di dominio predefinito.

4. Modifica le opzioni di configurazione di Postfix. Apri /etc/postfix/main.cf per la modifica. Ad esempio, per utilizzare l'editor di testo nano, inserisci il seguente comando:

   nano /etc/postfix/main.cf
   

5. Aggiorna il file:

   1. Commenta le seguenti righe:

      # default_transport = error
      # relay_transport = error
      

   2. Aggiungi le seguenti righe alla fine del file:

      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
      

      Le righe precedenti applicano il supporto SSL/TLS e configurano l'autenticazione SMTP per queste richieste. Un modulo SASL (Simple Authentication and Security Layer) gestisce l'autenticazione nella configurazione di Postfix.

6. Salva e chiudi il file.

7. Genera la mappa delle password SASL utilizzando la chiave API generata nella sezione Prima di iniziare. Sostituisci your-api-key con la chiave API che hai generato.

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

8. Utilizza l'utilità postmap per generare un file .db:

   postmap /etc/postfix/sasl_passwd
   

9. Verifica di avere un file .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. Rimuovi il file contenente le tue credenziali perché non è più necessario:

    rm /etc/postfix/sasl_passwd
    

11. Imposta le autorizzazioni per il file .db e verifica che l'altro file sia stato rimosso:

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

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

12. Ricarica la configurazione per caricare i parametri modificati:

    Debian

    /etc/init.d/postfix restart
    

    CentOS

    postfix reload
    

13. Installa il pacchetto mailutils o mailx:

    Debian

    apt -y install mailutils

    CentOS

    yum install mailx -y
    

14. Invia un'email di prova:

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

    Sostituisci quanto segue:

    • message: il corpo dell'email.
    • subject: l'oggetto dell'email.
    • [e-mail]: l'indirizzo email a cui vuoi inviare un messaggio.

    Nei log di sistema, cerca una riga di stato contenente status e il codice di risposta del server corretta (250):

    Debian

    tail -n 5 /var/log/syslog
    

    CentOS

    tail -n 5 /var/log/maillog
    

Invio di email con Java sulla tua istanza

Connettiti all'istanza sendgrid-tutorial tramite 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.

Creare e inviare un messaggio email

Le istruzioni riportate di seguito utilizzano la libreria client Java di SendGrid per creare e inviare un messaggio email tramite SendGrid. Puoi visualizzare l'esempio completo su GitHub.

Nel terminale SSH:

1. Diventa un superutente e imposta un'umask sicura:

   sudo su -
   umask 077
   

2. Installa Java e Maven:

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

3. Clona il repository GitHub:

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

4. Vai al codice sorgente principale dell'esempio:

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

5. Apri SendEmailServelet.java per la modifica.

   • Sostituisci your-sendgrid-api-key con la chiave API del tuo account SendGrid.

   • Sostituisci your-sendgrid-from-email con l'indirizzo email da cui vuoi inviare la posta.

   • Sostituisci destination-email con l'indirizzo email a cui vuoi inviare la posta.

6. Vai alla directory principale del codice campione:

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

7. Impacchetta la classe Java:

   mvn clean package
   

8. Vai alla nuova directory target:

   cd target
   

9. Imposta le autorizzazioni che ti consentono di eseguire il file JAR:

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

10. Esegui il selettore della versione Java alternativa:

    update-alternatives --config java
    

    Seleziona l'opzione java-11-openjdk-amd64.

11. Esegui il file Java:

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

Invio di email con Node.js sulla tua istanza

Per eseguire questo esempio, devi aver installato Node.js versione 7.6 o successive sull'istanza VM.

Connettiti all'istanza sendgrid-tutorial tramite 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.

Creare e inviare un messaggio email

Nel terminale SSH:

1. Diventa un superutente e imposta un'umask sicura:

   sudo su -
   umask 077
   

2. Aggiorna i repository dei pacchetti:

   Debian

   apt update
   

   CentOS

   yum update -y
   

3. Installa le dipendenze 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. Installa Node.js. Per impostazione predefinita, l'installazione installa anche npm:

   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 -
   

   Quindi, installa Node.js:

   yum -y install nodejs
   

5. Installa il client Node.js di SendGrid:

   npm install sendgrid
   

6. Clona il repository di esempio:

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

7. Vai alla directory che contiene l'esempio SendGrid:

   cd nodejs-docs-samples/compute
   

8. Copia il file sendgrid.js:

   cp sendgrid.js sendmail.js
   

9. Apri sendmail.js per la modifica.

   • Sostituisci your-sendgrid-api-key con la chiave API del tuo account SendGrid.

   • Sostituisci [e-mail] con l'indirizzo email da cui vuoi inviare la posta.

   • Sostituisci [e-mail] con l'indirizzo email a cui vuoi inviare la posta.

   // 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. Esegui il programma per inviare un messaggio email tramite SendGrid:

    node sendmail.js
    

Invio di email da un server di trasporto perimetrale Exchange

Puoi configurare Microsoft Exchange per inviare email in uscita con SendGrid configurando un connettore di invio in uscita. Per maggiori dettagli, consulta Eseguire il deployment di Microsoft Exchange Server 2016 su Compute Engine.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Elimina il progetto

Il modo più semplice per eliminare la fatturazione è eliminare il progetto che hai creato per il tutorial.

Per eliminare il progetto:

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività descritte in questo documento, quando lo elimini elimini anche tutto il lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un appspot.com URL, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, il riuso dei progetti può aiutarti a non superare i limiti di quota.

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.

Elimina l'istanza Compute Engine

Per eliminare un'istanza di 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.

Passaggi successivi

Esplora architetture di riferimento, diagrammi e best practice su Google Cloud. Consulta il nostro Cloud Architecture Center.