Esta página foi traduzida pela API Cloud Translation.

Enviar emails com o SendGrid

Este tutorial mostra como usar o SendGrid para enviar emails a partir de uma app executada numa instância de máquina virtual (VM) do Compute Engine.

Enviar correio a partir da sua instância com o Postfix

Conclua os passos seguintes para estabelecer ligação à sua instância do sendgrid-tutorial e executar o SendGrid com o Postfix.

Ligue-se à sua instância sendgrid-tutorial através de SSH

In the Google Cloud console, go to the VM instances page.
Go to VM instances
In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

Configurar o SendGrid como uma transmissão SMTP com o Postfix

Execute os seguintes comandos no seu terminal SSH para usar o SendGrid como um retransmissor SMTP com o Postfix.

Torne-se um superutilizador:
```
sudo su -
```
Defina uma umask segura:
```
umask 077
```
Instale o agente de transporte de correio Postfix:
Debian
```
apt update && apt -y install postfix libsasl2-modules
```
CentOS
```
yum install postfix cyrus-sasl-plain cyrus-sasl-md5 -y
```
Se lhe for pedido, selecione a configuração Apenas local e aceite o nome do domínio predefinido.
Modifique as opções de configuração do Postfix. Abra o perfil /etc/postfix/main.cf para edição. Por exemplo, para usar o editor de texto nano, introduza o seguinte comando:
```
nano /etc/postfix/main.cf
```
Atualize o ficheiro:
1. Comente as seguintes linhas:
```
# default_transport = error
# relay_transport = error
```
2. Adicione as seguintes linhas ao final do ficheiro:
```
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
```
  As linhas acima aplicam o suporte de SSL/TLS e configuram a autenticação SMTP para estes pedidos. Um módulo de camada de segurança e acesso simples (SASL) processa a autenticação na configuração do Postfix.
Guarde e feche o ficheiro.
Gere o mapa de palavras-passe SASL com a chave da API que gerou na secção Antes de começar. Substitua your-api-key pela chave da API que gerou.
```
echo [smtp.sendgrid.net]:2525 apikey:your-api-key >> /etc/postfix/sasl_passwd
```
Use o utilitário postmap para gerar um ficheiro .db:
```
postmap /etc/postfix/sasl_passwd
```

Verifique se tem um ficheiro .db:

ls -l /etc/postfix/sasl_passwd*

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

Remova o ficheiro que contém as suas credenciais, uma vez que já não é necessário:
```
rm /etc/postfix/sasl_passwd
```

Defina as autorizações no ficheiro .db e verifique se o outro ficheiro foi removido:

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

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

Atualize a configuração para carregar os parâmetros modificados:
Debian
```
/etc/init.d/postfix restart
```
CentOS
```
postfix reload
```

Instale o pacote mailutils ou mailx:

Debian

apt -y install mailutils

CentOS

yum install mailx -y

Envie um email de teste:
```
echo 'message' | mail -s subject email@example.com
```
Substitua o seguinte:
- message: o corpo do email.
- subject: o assunto do email.
- email@example.com: o endereço de email para o qual quer enviar uma mensagem.
Procure nos registos do sistema uma linha de estado que contenha status e o código de resposta do servidor (250):
Debian
```
tail -n 5 /var/log/syslog
```
CentOS
```
tail -n 5 /var/log/maillog
```

Enviar correio com Java na sua instância

Ligue-se à sua instância sendgrid-tutorial através de SSH

In the Google Cloud console, go to the VM instances page.
Go to VM instances
In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

Construa e envie uma mensagem de email

As instruções seguintes usam a biblioteca cliente Java do SendGrid para criar e enviar uma mensagem de email através do SendGrid. Pode ver o exemplo completo no GitHub.

No terminal SSH:

Torne-se superutilizador e defina uma umask segura:
```
sudo su -
umask 077
```

Instale o Java e o Maven:

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

Clone o repositório do GitHub:

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

Aceda ao código-fonte principal do exemplo:

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

Abra SendEmailServelet.java para edição.
- Substitua your-sendgrid-api-key pela chave API da sua conta do SendGrid.
- Substitua your-sendgrid-from-email pelo endereço de email a partir do qual quer enviar correio.
- Substitua destination-email pelo endereço de email para o qual quer enviar correio.
Aceda ao diretório raiz do exemplo de código:
```
cd /root/java-docs-samples/compute/sendgrid
```
Empacote a classe Java:
```
mvn clean package
```
Aceda ao novo diretório target:
```
cd target
```

Defina autorizações que lhe permitam executar o ficheiro JAR:

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

Execute o seletor de versão Java alternativo:
```
update-alternatives --config java
```
Selecione a opção java-11-openjdk-amd64.

Execute o ficheiro Java:

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

Enviar correio com o Node.js na sua instância

Para executar este exemplo, tem de ter a versão 7.6 ou posterior do Node.js instalada na instância de VM.

Ligue-se à sua instância sendgrid-tutorial através de SSH

In the Google Cloud console, go to the VM instances page.
Go to VM instances
In the list of virtual machine instances, click SSH in the row of the instance that you want to connect to.

Construa e envie uma mensagem de email

No terminal SSH:

Torne-se superutilizador e defina uma umask segura:
```
sudo su -
umask 077
```
Atualize os repositórios de pacotes:
Debian
```
apt update
```
CentOS
```
yum update -y
```

Instale as dependências do 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

Instale o Node.js. Por predefinição, a instalação também instala o 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 -

Em seguida, instale o Node.js:

yum -y install nodejs

Instale o cliente Node.js do SendGrid:
```
npm install sendgrid
```

Clone o repositório de exemplo:

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

Aceda ao diretório que contém o exemplo do SendGrid:
```
cd nodejs-docs-samples/compute
```
Copie o ficheiro sendgrid.js:
```
cp sendgrid.js sendmail.js
```

Abra sendmail.js para edição.

Substitua your-sendgrid-api-key pela chave API da sua conta do SendGrid.
Substitua from-email@example.com pelo endereço de email a partir do qual quer enviar correio.
Substitua to-email@example.com pelo endereço de email para o qual quer enviar correio.

// 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: 'to_email@example.com',
    from: 'from_email@example.com',
    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();

Execute o programa para enviar uma mensagem de email através do SendGrid:
```
node sendmail.js
```

Enviar correio a partir de um servidor de transporte de extremidade do Exchange

Pode configurar o Microsoft Exchange para enviar emails de saída com o SendGrid configurando um conector de envio de saída. Para obter detalhes, consulte o artigo Implementar o Microsoft Exchange Server 2016 no Compute Engine.