Skip to content

✉️ SMTP Email Relay - Configuração de Retransmissão de E-mails

O SMTP Email Relay é o serviço responsável por receber as mensagens de e-mail originadas na rede local ou pelo próprio sistema e retransmiti-las de forma segura através de um servidor de e-mail externo (SmartHost).

📝 Visão Geral

Por padrão, servidores de firewall e sistemas locais podem ter dificuldades para entregar notificações de e-mail diretamente ao destinatário final devido a bloqueios de portas (como a porta 25) por provedores de internet e políticas rígidas de Antispam (SPF, DKIM e DMARC).

Para garantir a entrega confiável de alertas de sistema, relatórios periódicos e comunicações de serviços internos, o recurso de Email Relay atua como um proxy/intermediador SMTP. Ele centraliza as mensagens e realiza a autenticação necessária perante provedores corporativos (como Office 365, Google Workspace, SendGrid, entre outros).

O gerenciamento deste recurso pode ser feito de forma simples através da Interface Web, ou em modo avançado via Linha de Comando (CLI).

📥 1. Instalação do Addon

🌐 Método Padrão: Via Interface Web

A maneira mais rápida e recomendada para instalar o módulo de retransmissão de e-mail é utilizando a loja de módulos integrada:

  • ⏱️ Acesse the menu superior e navegue até System > Addons and Packages.
  • 🔍 Localize o addon emailrelay na lista de módulos disponíveis. Se não estiver visível, clique em Update Repo.
  • 🚀 Clique em instalar e aguarde o processo automatizado ser concluído pelo painel.

💻 Método Avançado: Via Linha de Comando (CLI / SSH)

Caso prefira realizar a auditoria da instalação em tempo real pelo terminal, conecte-se via SSH com o usuário root e execute:

  • 📥 Atualiza a lista de pacotes do repositório 

    smart update

  • 📦 Instala o pacote do EmailRelay 

    smart install emailrelay -y

Confirmação

Após o término da instalação por qualquer um dos métodos, um novo menu de gerenciamento será liberado em: PROXY > SMTP.

🖥️ 2. Configuração na Interface Web (GUI)

Acesse o menu PROXY > SMTP, marque a opção Enable Service e preencha os parâmetros de conexão de acordo com a tabela estrutural abaixo:

Configurações de Serviço do Email Relay (Local)

Campo Exemplo de Preenchimento / Descrição
Enable Service [X] (Marque para ativar a inicialização automática do serviço)
Server EmailRelay Port 25 (Porta local em que o firewall escutará as requisições de e-mail dos clientes da rede. Nota: A porta informada deve ser liberada no firewall e no Tráfego de Sistema se acaso houver conexões remotas de outras máquinas na rede)
Localhost Only [X] (Se ativado, apenas o próprio OpenFW poderá enviar e-mails. Desmarque se outras máquinas da rede precisarem usar o Relay)
Enable Authentication [X] (Ative para exigir usuário e senha dos dispositivos internos que tentarem enviar e-mail através do firewall)
Auth Users (Use o botão + Add User para cadastrar as credenciais de usuários locais. Se você ativar este recurso, a aplicação que vai mandar e-mail deve usar essa conta para se autenticar no Emailrelay Server)
Verbose Mode [X] (Ative para gerar logs detalhados, ideal para a fase de testes e homologação)

Configurações do Provedor Externo (SmartHost)

Campo Exemplo de Preenchimento / Descrição
SmartHost smtp.sendgrid.net ou smtp.office365.com (Endereço do servidor SMTP externo que enviará as mensagens)
SmartHost Port 587 ou 465 (Porta de saída exigida pelo seu provedor de e-mail externo)
Account [email protected] (Conta de e-mail ou usuário de autenticação no provedor externo)
Senha ******** (Senha da conta ou token/chave de API gerada no provedor)
Enable TLS [X] (Marque para criptografar a comunicação entre o OpenFW e o SmartHost externo)
Auth Mechanism PLAIN (Mecanismo de autenticação SMTP suportado. Opções comuns: PLAIN, LOGIN)

🔍 3. Diagnóstico e Homologação

Após preencher as configurações, clique no botão Salvar. Você pode monitorar o tráfego de e-mails e validar se a autenticação com o SmartHost foi bem-sucedida em tempo real.

Monitorando os Logs de Envio

Para acompanhar a fila de e-mails e verificar se as mensagens estão sendo retransmitidas sem erros, execute o seguinte comando no terminal SSH:

tail -f /var/log/emailrelay/emailrelay.log

Análise de Resultados:

  • ✅ Sucesso: Mensagens mostrando status como emailrelay: info: message forwarded indicam que o firewall se autenticou corretamente no SmartHost e a mensagem foi transmitida.
  • ❌ Erro de Autenticação: Logs contendo erros como Authentication rejected ou 535 Authentication Failed indicam que o usuário ou senha configurados no bloco do SmartHost estão incorretos ou que o provedor exige uma senha de aplicativo específica.
  • ❌ Falha de Conexão (Timeout): Caso o log exiba Connection timed out ao tentar falar com o SmartHost, verifique se a porta de saída (Ex: 587) não está bloqueada nas regras de firewall de saída (Outbound) ou pelo seu provedor de internet.