Integrando o Python com o Serviço Email Delivery

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

Você pode usar o Python para enviar e-mails por meio do Serviço Email Delivery. Antes de enviar um e-mail, você deve configurar o serviço Email Delivery no Python.

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 a Python. Essas etapas foram testadas em uma instância de computação do Oracle Linux Server release 7.9 e Python 3.6. Essas etapas consideram que você esteja conectado a uma instância do Oracle Linux. Outras distribuições do Linux podem ter comandos e localizações de arquivos distintos. Os aplicativos Java (incluindo o JavaMail) deverão ser atualizados para a versão mais recente para garantir que os protocolos, as cifragens e os patches de segurança mais recentes estejam de acordo com as políticas de segurança e cifragens suportadas pela Oracle.

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

Para permitir que o Python teste a configuração do Serviço Email Delivery:

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 a fim de configurar o Python 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.
Verifique se o Python está 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 Python no Oracle Linux:
```
sudo yum install python3 -y
```
Em um editor de arquivos, como vi, crie um script python para testar o serviço Email Delivery.
Execute o seguinte comando:
```
sudo vi ociemail.py
```

No arquivo ociemail.py, substitua as variáveis pelos seus próprios valores.

Por exemplo:

# python script for sending SMTP configuration with Oracle Cloud Infrastructure Email Delivery
import smtplib 
import email.utils
from email.message import EmailMessage
import ssl

# Replace sender@example.com with your "From" address.
# This address must be verified.
# this is the approved sender email
SENDER = 'sender@example.com'
SENDERNAME = 'Sender Name'
 
# Replace recipient@example.com with a "To" address. If your account
# is still in the sandbox, this address must be verified.
RECIPIENT = 'recipient@example.com'
 
# Replace the USERNAME_SMTP value with your Email Delivery SMTP username.
USERNAME_SMTP = 'ocid1.user.oc1..<unique_ID>@ocid1.tenancy.oc1..<unique_ID>.vf.com'
 
# Put the PASSWORD value from your Email Delivery SMTP password into the following file.
PASSWORD_SMTP_FILE = 'ociemail.config'
 
# If you're using Email Delivery in a different region, replace the HOST value with an appropriate SMTP endpoint.
# Use port 25 or 587 to connect to the SMTP endpoint.
HOST = "smtp.us-ashburn-1.oraclecloud.com"
PORT = 587
 
# The subject line of the email.
SUBJECT = 'Email Delivery Test (Python smtplib)'
 
# The email body for recipients with non-HTML email clients.
BODY_TEXT = ("Email Delivery Test\r\n"
             "This email was sent through the Email Delivery SMTP "
             "Interface using the Python smtplib package."
            )
 
# The HTML body of the email.
BODY_HTML = """<html>
<head></head>
<body>
  <h1>Email Delivery SMTP Email Test</h1>
  <p>This email was sent with Email Delivery using the
    <a href='https://www.python.org/'>Python</a>
    <a href='https://docs.python.org/3/library/smtplib.html'>
    smtplib</a> library.</p>
</body>
</html>"""

# get the password from a named config file ociemail.config
with open(PASSWORD_SMTP_FILE) as f:
    password_smtp = f.readline().strip()

# create message container
msg = EmailMessage()
msg['Subject'] = SUBJECT
msg['From'] = email.utils.formataddr((SENDERNAME, SENDER))
msg['To'] = RECIPIENT

# make the message multi-part alternative, making the content the first part
msg.add_alternative(BODY_TEXT, subtype='text')
# this adds the additional part to the message
# According to RFC 2046, the last part of a multipart message, in this case
# the HTML message, is best and preferred.
msg.add_alternative(BODY_HTML, subtype='html')

# Try to send the message.
try: 
    server = smtplib.SMTP(HOST, PORT)
    server.ehlo()
    # most python runtimes default to a set of trusted public CAs that will include the CA used by OCI Email Delivery.
    # However, on platforms lacking that default (or with an outdated set of CAs), customers may need to provide a capath that includes our public CA.
    server.starttls(context=ssl.create_default_context(purpose=ssl.Purpose.SERVER_AUTH, cafile=None, capath=None))
    # smtplib docs recommend calling ehlo() before & after starttls()
    server.ehlo()
    server.login(USERNAME_SMTP, password_smtp)
    # our requirement is that SENDER is the same as From address set previously
    server.sendmail(SENDER, RECIPIENT, msg.as_string())
    server.close()
# Display an error message if something goes wrong.
except Exception as e:
    print(f"Error: {e}")
else:
    print("Email successfully sent!")

Observação

O Python 2 e as APIs de e-mail legadas não devem ser usadas com o serviço Email Delivery.

Em um editor de arquivos como vi, crie um arquivo que contenha a senha SMTP. Execute o seguinte comando e substitua o conteúdo pela sua senha SMTP:
```
sudo vi ociemail.config
```
Para enviar um e-mail de teste com o Python, execute o seguinte comando no diretório em que o script está localizado:
```
python3 ociemail.py
```

Mais Informações

Mais exemplos de script Python podem ser encontrados no GitHub.

Documentação do Oracle Cloud Infrastructure

Integrando o Python com o Serviço Email Delivery

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

Mais Informações