Documentation Oracle Cloud Infrastructure

Intégration de Swaks à Email Delivery

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

Swaks (Swiss Army Knife SMTP) est un outil basé sur les transactions que vous pouvez utiliser pour tester les configurations SMTP dans Email Delivery. Avant d'utiliser Swaks, vous devez configurer Email Delivery, et noter vos informations d'envoi SMTP et vos informations d'identification SMTP.

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 le support client Swaks. Ces étapes ont été testées sur une instance de calcul Oracle Linux Server version 7.9 et sur la version 20201014.0 de Swaks.
Remarque

De nombreux paramètres et options peuvent être utilisés pour tester divers scénarios avec Swaks. Lorsque Swaks évalue une option (autrement dit, un indicateur avec des paramètres), il le fait en trois étapes :

  • Il recherche d'abord un fichier de configuration (emplacement par défaut ou spécifié avec --config).
  • Il recherche ensuite les options dans les variables d'environnement.
  • Enfin, il examine les options de ligne de commande. A chaque étape, les options définies précédemment sont remplacées.

Hypothèses

Les procédures ci-après partent des principes suivants :

  • L'exemple suivant fournit des options à Swaks via la ligne de commande au format long, par exemple --server, à la place de la forme abrégée -s.
  • L'exemple suivant suppose que le comportement par défaut est adopté pour la connexion via des sockets de réseau.
  • Aucun certificat local n'est requis pour qu'une connexion TLS soit négociée. L'exemple suivant suppose que le comportement par défaut, où Swaks ne tente pas de vérifier le certificat, est adopté.
  • Swaks est principalement destiné à une utilisation sur des systèmes d'exploitation de type UNIX avec des fonctionnalités basées sur des normes connues afin de pouvoir fonctionner sur la plupart des serveurs de messagerie modernes.

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

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

  1. 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 Swaks 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.

  2. Vérifiez que Swaks 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 Swaks sur Oracle Linux :

    sudo yum install swaks -y

  3. Pour envoyer un courriel de test avec Swaks, exécutez la commande suivante :

    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>'

    Par exemple :

    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'
    Remarque

    Lors de l'envoi d'un courriel avec Swaks :

    • Le paramètre -tls est requis.
    • Le paramètre --pipeline est pris en charge pour l'utilisation de pipelines SMTP.
    • Vous pouvez utiliser le paramètre --port <number> ou la syntaxe :<port number> pour indiquer le port.
    • Le mot de passe SMTP est demandé après l'exécution de cette commande