Product
O SMTP do Mailgun está mudando para o TLS 1.2: o que você precisa fazer antes da atualização de 1º de março de 2027
Se o aplicativo envia redefinições de senha, recibos, códigos de login ou outros envios de mensagens transacionais com o Mailgun via SMTP usando uma versão antiga do TLS, o Mailgun não poderá aceitá-los a partir de 1º de março de 2027.
Essa mudança se aplica apenas ao envio via SMTP. Veja o que vai mudar e como se atualizar.
O que vai mudar no Mailgun?
A partir de 1º de março de 2027, o SMTP do Mailgun só aceitará conexões usando o TLS 1.2 ou superior. As conexões que usarem o TLS 1.0 ou 1.1 serão rejeitadas e essas mensagens não serão enviadas.
Por que o Mailgun vai descontinuar o TLS 1.0 e 1.1?
O TLS 1.0 foi criado em 1999. Tanto a versão 1.0 quanto a 1.1 têm falhas conhecidas que fizeram com que os principais navegadores abandonassem esses protocolos em 2020, e a IETF os descontinuasse formalmente em 2021 (RFC 8996). O envio por meio desses protocolos coloca as mensagens e credenciais SMTP em risco durante a transmissão.
Exigir o TLS 1.2 ou superior protege todos os remetentes da plataforma, não apenas os que já fizeram a transição.
Essa mudança afeta você?
Remetentes que fazem envios para o Mailgun via SMTP e cujo servidor de e-mail, aplicativo ou biblioteca de e-mail negocia o TLS 1.0 ou 1.1. serão afetados. Os remetentes que fazem envios apenas por meio da API do Mailgun não precisam fazer nenhuma atualização.
O Mailgun monitora o tráfego SMTP em busca de versões antigas do TLS. Se o Mailgun detectar uma versão antiga do TLS na conta, os administradores receberão um e-mail e verão um banner no painel da conta do Mailgun.
Ambientes antigos que costumam afetar o TLS:
- Windows Server 2008 ou 2012, em que o TLS 1.2 não é ativado por padrão
- .NET Framework 4.5 ou anterior
- Versões desatualizadas do OpenSSL, ou aplicativos e plugins legados que fixam uma versão antiga do TLS
Recomendamos que você mude para o TLS 1.2 ou superior o mais rápido possível. Para a maioria dos clientes, isso significa atualizar uma configuração no servidor de e-mail, aplicativo ou biblioteca de e-mail que você usa para se conectar ao Mailgun.
O que acontece se eu não atualizar o TLS?
Após o prazo final de 1º de março, o Mailgun não poderá aceitar conexões SMTP usando TLS 1.0 ou 1.1, o que afetará as mensagens que você tentar enviar. Isso inclui os e-mails com os quais seus clientes contam, como redefinições de senha e recibos.
Como atualizar para o TLS 1.2
Siga as etapas abaixo para se certificar de que tudo está atualizado.
Encontre tudo que faz envios via SMTP
Muitas equipes têm mais de um aplicativo fazendo envios por meio da mesma conta do Mailgun. Verifique todos os aplicativos e instâncias em que as credenciais SMTP do Mailgun ou smtp.mailgun.org aparecem:
- Seus próprios aplicativos e serviços, incluindo ambientes de staging e workers em segundo plano
- Servidores ou relays de e-mail, como o Postfix, que encaminham e-mails para o Mailgun
- Plugins de CMS, plataformas de e-commerce e outras ferramentas configuradas com o login SMTP
- Sistemas de fornecedores ou legados, como CRMs, ERPs, scanners ou ferramentas de monitoramento, que enviam alertas
Verifique o ambiente
No exemplo de curl abaixo, você verá o chat SMTP para verificar qual versão do TLS está usando no momento:
openssl s_client -connect smtp.mailgun.org:587 -starttls smtp -tls1_2
Um handshake bem-sucedido exibe a cadeia de certificados e “Protocol : TLSv1.2” ou superior.
Como sei que o problema foi resolvido?
Use os exemplos de código abaixo para validar se o serviço está rodando o TLS 1.2 ou superior ao se conectar ao Mailgun para enviar mensagens via SMTP.
Python (smtplib)
import smtplib, ssl
context = ssl.create_default_context()
context.minimum_version = ssl.TLSVersion.TLSv1_2
with smtplib.SMTP("smtp.mailgun.org", 587) as server:
server.starttls(context=context)
server.login(SMTP_USER, SMTP_PASSWORD)
Node.js (Nodemailer)
const transporter = nodemailer.createTransport({
host: "smtp.mailgun.org",
port: 587,
auth: { user: SMTP_USER, pass: SMTP_PASSWORD },
tls: { minVersion: "TLSv1.2" },
});
.NET Framework
No .NET 4.5, adicione esta linha antes de se conectar. A versão 4.6 e posteriores usam o TLS 1.2 por padrão.
System.Net.ServicePointManager.SecurityProtocol |= SecurityProtocolType.Tls12;
Relay do Postfix
Se o Postfix faz o relay do e-mail para o Mailgun, defina o protocolo mínimo no main.cf (Postfix 3.6 ou superior) e, em seguida, recarregue o Postfix:
smtp_tls_protocols = >=TLSv1.2
smtp_tls_mandatory_protocols = >=TLSv1.2
Dica de especialista: Quer usar o TLS na outra parte do trajeto também? Adicione o cabeçalho X-Mailgun-Require-TLS e o Mailgun só enviará a mensagem para o servidor do destinatário por meio de uma conexão segura.
Conclusão
Lembre-se de que todas as alterações e atualizações precisam ser concluídas antes de 1º de março de 2027. Nossa equipe de suporte está à disposição para ajudar a garantir que as contas estejam prontas para fazer envios com o TLS 1.2