Documentação do Oracle Cloud Infrastructure

Integrando o Swaks com o Serviço Email Delivery

Use o Swaks para enviar e-mails por meio do serviço Email Delivery.

O Swaks (Swiss Army Knife SMTP) é uma ferramenta baseada em transação que você pode usar para testar as configurações do SMTP no serviço Email Delivery. Antes de usar o Swaks, você deve configurar o serviço Email Delivery e anotar suas informações de envio SMTP e credenciais SMTP.

Importante

Essas instruções contêm um código de amostra para sua conveniência e devem ser usadas como referência. Para obter suporte ao cliente, entre em contato com o suporte ao cliente do Swaks. Essas etapas foram testadas em uma instância de computação do Oracle Linux Server release 7.9 e Swaks versão 20201014.0.
Observação

Muitas opções e parâmetros podem ser usados para testar vários cenários com o Swaks. Quando o Swaks avalia uma opção (isto é, um flag com parâmetros), ele faz isso em três etapas:

  • Primeiro, ele procura um arquivo de configuração (local padrão ou especificado com --config).
  • Em seguida, ele procura opções em variáveis de ambiente.
  • Finalmente, ele procura as opções da linha de comando. Em cada etapa, as opções definidas anteriormente serão substituídas.

Pressupostos

Os procedimentos a seguir pressupõem o seguinte:

  • O exemplo a seguir fornece opções para o Swaks por meio da linha de comando em formato longo, por exemplo, --server, em vez do formato curto, -s.
  • O exemplo a seguir pressupõe o comportamento padrão para se conectar por meio de soquetes de rede.
  • Não é necessário um certificado local para que uma conexão TLS seja negociada. O exemplo a seguir pressupõe o comportamento padrão em que o Swaks não tenta a verificação do certificado.
  • O Swaks se destina principalmente ao uso em sistemas operacionais semelhantes a UNIX com funcionalidade baseada em padrões conhecidos, de forma que funcione na maioria dos servidores de e-mail modernos.

Configurar o Swaks para Enviar E-mails por meio do Serviço Email Delivery

Para ativar o Swaks para testar a configuração do serviço Email Delivery:

  1. Certifique-se de que o serviço Email Delivery esteja configurado para enviar e-mails. Consulte Conceitos Básicos.

    Observação

    As credenciais SMTP são obrigatórias para configurar o Swaks para usar o serviço Email Delivery. Não esqueça de anotar o nome de usuário e a senha ao gerar as credenciais SMTP.

  2. Certifique-se de que o Swaks esteja instalado. O processo de instalação será diferente, dependendo do sistema operacional que você estiver usando. Por exemplo, execute o seguinte comando para instalar o Swaks no Oracle Linux:

    sudo yum install swaks -y

  3. Para enviar um e-mail de teste com o Swaks, execute o seguinte comando:

    swaks --pipeline -tls --server <smtp.region.oraclecloud.com> --port <587 or 25> --auth-user '<username OCID from SMTP credentials>' --from '<sender email address>' --to '<recipient email address>' --data '<email message>'

    Por exemplo:

    swaks --pipeline -tls --server smtp.us-ashburn-1.oraclecloud.com --port 25 --auth-user 'ocid1.user.oc1..<unique_ID>' --from 'sender@example.com' --to 'recipient@example.com' --data 'From: sender@example.com\nDate: Thu, 13 Sep 2019\nSubject: Test Send\n\nTest email'
    Observação

    Ao enviar e-mails com o Swaks:

    • O parâmetro -tls é obrigatório.
    • Há suporte para que o parâmetro --pipeline use o comando pipelining do SMTP.
    • O parâmetro --port <number> ou a sintaxe :<port number> podem ser usados para especificar a porta.
    • A senha SMTP é solicitada após a execução deste comando