Intégration de Python à Email Delivery

Utilisez Python pour envoyer des courriels via le service Email Delivery.

Vous pouvez utiliser Python pour envoyer des courriels via Email Delivery. Pour pouvoir envoyer des courriels, vous devez configurer Email Delivery dans Python.

Important

Pour plus de facilité, ces instructions contiennent un exemple de code qui doit être utilisé comme référence. Pour obtenir de l'aide, vous devez contacter Python. Ces étapes ont été testées sur une instance de calcul Oracle Linux Server version 7.9 et sur Python 3.6. Cette procédure suppose que vous êtes connecté à une instance Oracle Linux. D'autres distributions de Linux peuvent impliquer des commandes et des emplacements de fichier différents. Les applications Java (y compris JavaMail) doivent être mises à jour vers la dernière version pour s'assurer que les derniers protocoles, cryptages et patches de sécurité sont en conformité avec les cryptages et stratégies de sécurité pris en charge par Oracle.

Configuration de Python pour l'envoi de courriels via Email Delivery

Pour permettre à Python de tester la configuration d'Email Delivery, procédez comme suit :

Assurez-vous qu'Email Delivery est configuré pour envoyer des courriels. Reportez-vous à Introduction.
Remarque

Les informations d'identification SMTP sont requises afin de configurer Python pour l'utilisation d'Email Delivery. Veillez à noter le nom utilisateur et le mot de passe lorsque vous générez les informations d'identification SMTP.
Vérifiez que Python est installé. Le processus d'installation diffère en fonction du système d'exploitation utilisé. Par exemple, exécutez la commande suivante pour installer Python sur Oracle Linux :
```
sudo yum install python3 -y
```
Dans un éditeur de fichier tel que vi, créez un script Python pour tester Email Delivery.
Exécutez la commande suivante :
```
sudo vi ociemail.py
```

Dans le fichier ociemail.py, remplacez les variables par vos propres valeurs.

Par exemple :

# 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!")

Remarque

Python 2 et les API de messagerie héritées ne doivent pas être utilisées avec Email Delivery.

Dans un éditeur de fichiers tel que vi, créez un fichier contenant le mot de passe SMTP. Exécutez la commande suivante et remplacez le contenu par votre mot de passe SMTP :
```
sudo vi ociemail.config
```
Pour envoyer un courriel de test avec Python, exécutez la commande suivante à partir du répertoire dans lequel se trouve le script :
```
python3 ociemail.py
```

Plus d'informations

Vous trouverez d'autres exemples de script Python sur GitHub.

Documentation Oracle Cloud Infrastructure

Intégration de Python à Email Delivery

Configuration de Python pour l'envoi de courriels via Email Delivery

Plus d'informations