Documentação do Oracle Cloud Infrastructure

Solução de Problemas do Serviço Email Delivery

Use informações de diagnóstico e solução de problemas para identificar e tratar problemas comuns que podem ocorrer durante o serviço Email Delivery.

Este tópico fornece soluções de diagnóstico e solução de problemas que você pode encontrar ao utilizar o serviço Email Delivery.

Erros Comuns Retornados pelo serviço Email Delivery

Erros de API

Para obter uma lista completa de erros comuns de entrega de e-mail de API retornados por todos os serviços do Oracle Cloud Infrastructure, consulte Erros de API.

Erros de SMTP Comuns Retornados pelo serviço Email Delivery

A tabela a seguir lista os erros comuns retornados pelo serviço SMTP do Email Delivery.

Código de Status SMTP Código de Erro Descrição
254 4.7.1 Suppression for user <user ocid> to <recpt> A mensagem foi aceita, mas um código de status foi retornado indicando supressão.

O Código de Status Avançado 4.7.1 indicou uma falha transitória persistente (RFC3463).
421 Timeout waiting for data from client
421 4.4.0 Problem attempting to execute commands. Please try again later
421 Too many connections, try again later
421 Too many auth failures, try again later Acelerador baseado em IP; acionado pelo uso repetitivo de credenciais SMTP inválidas ou remetente não aprovado.
421 4.3.0 Mail system failure, closing transmission channel
451 Server error Ocorreu um erro inesperado durante a conversa do SMTP.
451 Error in Processing Ocorreu um erro inesperado durante a conversa do SMTP.
452 System storage error O servidor não pode fazer a mensagem persistir em sua fila de entrega.
455 Maximum messages sent per minute reached : limit is <limit> A taxa de burst de envio SMTP (de mensagens aceitas por período de minuto) foi excedida.
455 Maximum messages sent per day reached : limit is <limit> A taxa de envio diário SMTP (de mensagens aceitas por período de 24 horas) foi excedida.
501 Invalid command argument, not a valid Base64 string

O segredo AUTH (PLAIN) codificado em base64 é inválido.
501 Invalid command argument, does not contain NUL O segredo AUTH (PLAIN) codificado em base64 não contém separador(es) de campo NUL.
501 Invalid command argument, does not contain the second NUL O segredo AUTH (PLAIN) codificado em base64 não contém segundo(s) separador(es) de campo NUL.
503 Need RCPT command O cliente SMTP tentou iniciar o envio do corpo de uma mensagem de e-mail sem identificar destinatários de e-mail por meio do comando SMTP RCPT (RFC 5321) obrigatório.
504 Method not supported O cliente tentou usar um mecanismo AUTH não suportado com nosso serviço.
504 AUTH mechanism mismatch O cliente enviou um comando AUTH inválido ao nosso serviço.
552 Exceeds byte limit A mensagem excedeu o limite de tamanho imposto pelo serviço (consulte a resposta do servidor a EHLO para restrição de tamanho).
535 Authentication credentials invalid Falha na autenticação do usuário SMTP.
535 Authentication required O cliente enviou comandos que exigem autenticação SMTP bem-sucedida antes que o serviço possa ser processado (ou seja, os comandos estão sendo enviados fora de ordem).
535 Authorization failed: address <address> not authorized

Falha na autorização do endereço (do envelope ou da mensagem) para o usuário SMTP.

O remetente aprovado não existe. A política email-family não especifica o compartimento que contém o remetente aprovado ou o usuário com as credenciais SMTP não está em um grupo com a política use email-family. Consulte Criar Credenciais SMTP para obter mais informações.
553 <address> Invalid email address O Endereço da Internet RFC-822 enviado pelo cliente é inválido.
554 Message parse error A Mensagem da Internet RFC-2822 é inválida (e não pode ser submetida a parsing pelo servidor).

A mensagem sem cabeçalhos ou cabeçalho é maior que 256 KB.

Erros de HTTPS Comuns Retornados pelo serviço Email Delivery

A tabela a seguir lista os erros comuns retornados pelo serviço HTTPS do Email Delivery.

Código de Status HTTPS Designação HTTPS Exemplos de Código de Erro
200 A ação foi bem-sucedida A resposta contém os parâmetros de resposta.
400 InvalidParameter ID da Mensagem não formado de acordo com RFCs.
400 InvalidParameter O Endereço de e-mail não pode ser nulo nem vazio.
400 InvalidParameter Endereço da Internet Inválido: <address>
400 InvalidParameter maxItems: 50, para destinatários nos campos Para:, CC: e CCO:.
400 InvalidParameter A Chave do Cabeçalho não pode ser nula ou vazia
400 InvalidParameter As Chaves de Cabeçalho de E-mail Personalizadas devem ser apenas ASCII <header>
400 InvalidParameter <header> é um cabeçalho de e-mail reservado que não é permitido
400 MissingParameter O remetente do atributo obrigatório compartmentId não pode ficar vazio ou ser nulo.
400 MissingParameter O assunto do atributo obrigatório não pode estar vazio ou ser nulo.
400 MissingParameter O remetente do atributo obrigatório não pode ficar vazio ou ser nulo.
400 MissingParameter Os destinatários de atributo obrigatórios devem conter destinatários to , cc ou bcc.
400 MissingParameter Corpo do atributo obrigatório (html/texto) ausente. A solicitação deve conter bodyText ou bodyHtml
400 LimitExceeded O máximo de mensagens enviadas por minuto atingido: o limite é <>O máximo de mensagens enviadas por dia atingido: o limite é <>
404 NotAuthorizedOrNotFound Falha na autorização: endereço <Endereço de E-mail do Remetente> não autorizado ou não encontrado
413 Entidade de Solicitação Muito Grande A mensagem excede o limite de bytes: o limite é <>
429 Muitas solicitações Muitas solicitações recebidas. Aguarde e tente novamente.
500 Erro interno do servidor Erro Interno do Servidor

Problemas de e-mails não entregues

Identifique e corrija problemas que impeçam que seus e-mails sejam entregues.

Os seguintes problemas podem fazer com que um e-mail não seja entregue:

  • O destinatário está na Lista de Supressão.
  • Houve falha na autenticação ou ocorreu um problema com o formato da mensagem de e-mail. Por exemplo, se o endereço "De" SMTP não for o mesmo que o endereço "De" no corpo do e-mail, o e-mail será rejeitado. Os endereços devem corresponder e o Remetente tem que ser Aprovado. Consulte os logs do aplicativo de envio para analisar os problemas.
  • Não é recomendável usar vários endereços no cabeçalho de e-mail De. Se você usar vários endereços, aumentará a possibilidade de que seu e-mail seja colocado em uma pasta de spam ou descartado (por causa das regras de alinhamento de origem DMARC (Domain-based Message Authentication, Reporting, and Conformance)). O desempenho de seus e-mails é reduzido porque todos os endereços precisam ser autorizados como remetentes aprovados. Uma prática recomendada para o endereço do remetente do envelope SMTP é corresponder ao endereço do remetente do cabeçalho quando você enviar e-mail para o serviço Email Delivery. Se você usar endereços não correspondentes, o desempenho de seus e-mails será reduzido porque ambos os endereços precisam ser autorizados como remetentes aprovados. Certos recursos de plataforma futuros não estarão disponíveis se você usar endereços não correspondentes.
  • Falta de DKIM (Domain Keys Identified Mail).
  • Exiba o "dkimSelector" aplicado ao seu e-mail por meio do recurso Log Público.

O DKIM e o DMARC podem ajudar a autenticar seu e-mail para garantir que seus e-mails sejam entregues nas caixas de entrada dos destinatários. Para obter mais informações, consulte Mais Opções para Aumentar a Capacidade de Entrega.

Consulte Melhores Práticas para saber mais sobre recomendações que podem ajudar a reduzir sua taxa de devolução de e-mail, permanecer fora das listas de bloqueio, reduzir sua taxa de reclamação e melhorar sua reputação de remetente de e-mail.

Se não conseguir resolver o problema, vá para o My Oracle Support e crie uma solicitação de serviço. Consulte Abrir uma solicitação de serviço de suporte para obter mais informações.

Problemas de Conectividade

Observação O serviço Email Delivery não proíbe a conectividade de nenhum intervalo de IPs de origem.

Qualquer IP que tente se conectar com o serviço Email Delivery será aceito.

Consulte Configurando a Conexão SMTP para obter uma lista de pontos finais regionais para estabelecer conexões SMTP para envio.

Problema ao Estabelecer Conexão com as Portas de Rede do Ponto Final

Corrija problemas de conectividade que impeçam a conexão com portas de rede de ponto final.

  1. Certifique-se de que você tenha o nome DNS ou endereço IP do ponto final correto para a região e de que você esteja na lista de permissões para usar o ponto final.
  2. Teste a conectividade com o ponto final usando a porta 25 ou 587. Use um utilitário, como Telnet ou netcat, para tentar estabelecer conexão com a porta manualmente.
    1. Abra um prompt de comando.
    2. Use o comando a seguir para testar a conexão de rede.
      telnet <SMTP endpoint> <port>

      Por exemplo:

      telnet smtp.email.us-ashburn-1.oci.oraclecloud.com 25

      A porta está aberta e o teste será bem-sucedido se você vir uma mensagem "Conectado a". Se não conseguir se conectar às portas usando o telnet, é porque você está tendo um problema de conectividade de rede.

Problema ao Estabelecer Conexão com um MTA (External Mail Transfer Agent)

Corrija problemas de conectividade que impedem você de se conectar ao MTA.

Execute as etapas a seguir para determinar se você pode se comunicar com um serviço externo nas portas obrigatórias 25 ou 587. Se não conseguir se conectar com sucesso, é porque você está tendo um problema de conectividade de rede. Se você conseguir se conectar com um MTA externo, o problema de conectividade de rede está no Oracle Cloud Infrastructure.

  1. Conecte-se a um MTA externo, como servidores de mensagens do Google.
    1. Abra um prompt de comando.
    2. Use o comando a seguir para recuperar um dos registros do servidor MX do Google.
      dig MX google.com
    3. Use o comando a seguir para testar a conectividade com a porta 25 ou 587 do ponto final nos servidores MX do Google.
      telnet <IP address> <port>

      Se você não conseguir estabelecer conexão com os servidores MX do Google, confirme se há problemas de conexão com os servidores de e-mail (porta 25 ou 587). É possível que suas regras de saída estejam filtrando o tráfego na VCN.

      Se você puder se conectar a um MTA externo (ou seja, você consegue se comunicar com um ponto final SMTP público nas portas corretas), mas não puder se conectar com pontos finais SMTP públicos do serviço Email Delivery nessas portas, crie uma solicitação de serviço no My Oracle Support com essas informações.

Erros de TLS ao integrar com o Postfix

Corrija erros de TLS que impedem a integração com o Postfix.

  1. Se você estiver encontrando erros no protocolo TLS ao tentar integrar o Postfix com o serviço Email Delivery, certifique-se de que a seguinte definição foi removida do arquivo main.cf do Postfix, pois ela está obsoleta:
    smtp_use_tls = yes
  2. Use a seguinte definição em vez de ativar o TLS (disponível no Postfix 2.3 e versões posteriores):
    smtp_tls_security_level = may
    Essa definição informa ao Postfix para usar o suporte STARTTLS ao estabelecer conexão com servidores SMTP remotos, como o OCI Email Delivery. Se você quiser impor o uso de TLS para que todo o retransmissão do Postfix de saída use criptografia, use a seguinte definição:
    smtp_tls_security_level = encrypt

Para obter mais informações, consulte Postfix TLS Support.

Chave DKIM Inativa

Corrija a chave DKIM inativa no DNS do seu domínio de e-mail.

Para ativar sua chave DKIM, você deve provisionar um registro CNAME de DNS neste local no DNS do Domínio de E-mail:

<selector>._domainkey.<email-domain>

No entanto, diferentes provedores de DNS têm interfaces de usuário diferentes para especificar a localização de um registro de DNS. Algumas interfaces de usuário aceitam o caminho completo do DNS por padrão e elas funcionarão bem. Algumas interfaces de usuário são relativas à zona por padrão, portanto, se você colar toda a string sem o período final, a interface de usuário provisionará o local errado e deixará sua chave DKIM em um estado "Precisa de Atenção". Evite entradas como esta:

<selector>._domainkey.<email-domain>.<zone-name>

Se o seu Domínio de E-mail for igual ao seu nome de zona de DNS e se o seu provedor aceitar apenas um nome relativo à zona, use este local de CNAME de DNS:

<selector>._domainkey

Se o seu Domínio de E-mail estiver em um subdomínio da sua zona e se o seu provedor aceitar apenas um nome relativo à zona, use este local CNAME de DNS:

<selector>._domainkey.<subdomain>

Privacidade dos Dados

Proteja a privacidade de dados do remetente e do destinatário quando um email for enviado.

Como o OCI Email Delivery protege a privacidade de dados de um remetente e destinatário?

Para proteger a privacidade de dados de um remetente e destinatário quando um email está em trânsito:

  • O TLS 1.2 é necessário ao enviar e-mails do seu aplicativo para o Email Delivery.
  • O TLS criptografa dados quando o Email Delivery retransmite e-mails para o destinatário, desde que ele suporte TLS.
  • O conteúdo do corpo do e-mail é armazenado somente em trânsito.
  • Os dados do cabeçalho do e-mail são registrados internamente por duas semanas.
  • Se o remetente ativar logs, o serviço OCI Logging armazenará os logs de serviço de e-mail. As políticas de retenção de dados de log são definidas pelo usuário.

Quando seus dados de e-mail estão em repouso, as configurações de e-mail, como remetentes aprovados, domínios, DKIM e e-mails suprimidos, são criptografadas para proteger a privacidade de dados de um remetente e destinatário.