Como configurar o SendGrid SMTP no CyberPanel

Atualizado em
3 min de leitura

SendGrid é um serviço SMTP baseado em nuvem que permite a entrega de e-mails sem a necessidade de gerenciar servidores de e-mail.

NB:A porta 25 está fechada para conexão em nossas VMs por padrão. Se você quiser abrir a porta 25, compre o Mail Bridge e configure-o no VPS Manager.

Para configurar o e-mail do SendGrid no WHM, use este guia.

Siga as etapas abaixo para configurar o serviço SendGrid e o sistema de e-mail para o seu nome de domínio no lado do CyberPanel:

1. Cadastre-se no SendGrid:

Depois de preencher todas as informações de contato, clique em “Continue”.

2. Você será redirecionado para uma nova aba no navegador para verificar sua conta de e-mail. Copie o código de verificação enviado para sua conta de e-mail, insira-o no campo “Code” e clique em “Verify”:

3. Verifique seu número de telefone inserindo o código de verificação enviado para ele no campo “Enter certification code” e clique em “Verify”:

4. Em seguida, será fornecido a você o código de recuperação, que é útil em casos de perda do telefone ou de não ter acesso ao seu dispositivo de verificação. Copie o código, salve-o e clique em “Continue”. Também há uma opção para baixar o código como um arquivo:

5. Preencha suas informações de contato na próxima página e clique em “Next”:


6. Na próxima página, abra o seu painel do SendGrid:

7. Quando estiver lá, vá para “Settings” >> o menu “API Keys” para criar uma nova API Key:


8. No menu aberto, insira o nome da API Key, defina as permissões da API Key como a opção “Full Access” e salve a configuração:

9. Configure a Sender Authentication do SendGrid. Há duas maneiras de fazer isso:

Método 1: Single Sender Verification

Single Sender Verification - é um método rápido de verificação que permite adicionar um destinatário autorizado (um único endereço de e-mail ou vários) ao usar uma conta SendGrid. Ele pode ser usado, por exemplo, se você quiser enviar e-mails de john.doe@example.com, que foi adicionado no servidor cPanel, para jane.doe@gmail.com. O endereço de e-mail jane.doe@gmail.com deve ser adicionado ao Single Sender Verification no SendGrid para isso.

NB: Single Sender Verification é recomendado apenas para testes.

NB: Você pode enviar apenas a partir do endereço que verificar, em vez de qualquer endereço em um domínio autenticado.

Para configurar o Single Sender Verification, navegue até “Settings” no seu painel do SendGrid >> o menu “Sender Authentication” >> clique no botão “Verify a Single Sender”:

Na próxima página, crie um remetente preenchendo as informações de contato e clique em “Create” para salvar tudo:

Depois disso, você receberá um e-mail de verificação do SendGrid. Para confirmar a adição do endereço de e-mail, clique no botão “Verify Single Sender” no e-mail:

Método 2: Domain Authentication (recomendado)

Clique em  “Settings” >> navegue até o menu “Sender Authentication” >> no campo “Domain Authentication”, clique em “Authenticate Your Domain”:

Na próxima página, autentique seu nome de domínio respondendo às perguntas da primeira e da segunda etapas e clique em “Next”:

NB: Na captura de tela, escolhemos a resposta “No” para a segunda pergunta. No entanto, essa resposta é opcional.

Depois disso, insira o nome de domínio necessário, defina quaisquer configurações adicionais, se necessário, e clique em “Next”:

Agora, é necessário verificar o nome de domínio configurando os registros DNS CNAME e TXT correspondentes.

Depois que os registros DNS forem criados para o domínio, confirme a adição deles na etapa 2 marcando a caixa “I’ve added these records” e clique em “Verify” abaixo:

NB: A propagação dos registros DNS pode levar até 24-48 horas.

10. A próxima etapa será configurar as definições de SMTP para o servidor CyberPanel.

Infelizmente, o CyberPanel ainda não oferece aos usuários uma interface especial para configurações de SMTP. O SendGrid deve ser configurado via terminal SSH. 

  • Primeiro, faça login no seu servidor como root:

ssh root@SERVER_IP_ADDRESS -p PORT


Onde SERVER_IP_ADDRESS é o endereço IP do seu servidor, e PORT é a porta de conexão SSH (por padrão, é 22022)

  • Abra o arquivo /etc/postfix/main.cf com um editor de texto:

nano /etc/postfix/main.cf
ou
vi /etc/postfix/main.cf

  • Adicione as seguintes linhas ao final do arquivo:

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

  • Agora você precisa especificar suas credenciais (use apikey como nome de usuário e uma API Key como senha) no arquivo separado /etc/postfix/sasl_passwd (provavelmente você precisará criá-lo):

echo “[smtp.sendgrid.net]:587 apikey:YOUR_SENDGRID_API_KEY” > /etc/postfix/sasl_passwd

Onde YOUR_SENDGRID_API_KEY é a chave que você criou na etapa 8.

  • Em seguida, certifique-se de que o arquivo tenha acesso restrito de leitura e gravação apenas para root e use o comando postmap para atualizar as tabelas hash do Postfix para usar esse novo arquivo:

sudo chmod 600 /etc/postfix/sasl_passwd
sudo postmap /etc/postfix/sasl_passwd

  • Por fim, reinicie o Postfix:

systemctl restart postfix

  • Instale o plugin SASL no seu servidor:

apt-get install libsasl2-modules  # para Ubuntu
dnf install cyrus-sasl-plain      # para Almalinux/CloudLinux
yum install cyrus-sasl-plain       # para CentOS

Além disso, algumas instâncias podem exigir um driver MySQL para o Dovecot para configurar o backend MySQL para autenticação:

apt install dovecot-sqlite dovecot-mysql   # para Ubuntu
dnf install dovecot-mysql               # para Almalinux/CloudLinux
yum install dovecot-mysql                # para CentOS

  • Depois disso, reinicie o Dovecot:

systemctl restart dovecot

  • Agora, você pode testar se um e-mail está sendo retransmitido pelo SendGrid:

sendmail -f YOUR_LOCAL_EMAIL -v DESTINATION_EMAIL

Onde YOUR_LOCAL_EMAIL é a conta de e-mail que você criou na sua conta CyberPanel, e DESTINATION_EMAIL é o e-mail do destinatário para o qual um e-mail de teste é enviado.

Em seguida, digite o corpo da sua mensagem e pressione Ctrl+D para enviar.

Como alternativa, use o Webmail na sua conta CyberPanel para enviar um e-mail de teste por lá.

É necessário um e-mail válido