Documentation sur Oracle Cloud Infrastructure

Intégration de Swaks avec le service de transmission de messages

Utilisez Swaks pour envoyer des courriels au moyen du service de transmission de messages.

Swaks (SMTP Army Knife) est un outil transactionnel que vous pouvez utiliser pour tester les configurations SMTP du service de transmission de messages. Avant d'utiliser Swaks, vous devez configurer le service de transmission de messages et prendre note de vos données d'expédition et d'identification SMTP.

Important

Ces instructions contiennent un exemple de code pour vous faciliter la tâche et doivent être utilisées comme référence. Pour obtenir de l'assistance, vous devez communiquer avec le soutien à la clientèle de Swaks. Ces étapes ont été testées sur une instance de calcul Oracle Linux Server version 7.9 et Swaks version 20201014.0.
Note

Plusieurs options et paramètres peuvent être utilisés afin de tester différents scénarios avec Swaks. Lorsque Swaks évalue une option (c'est-à-dire un indicateur avec des paramètres), le processus s'effectue en trois étapes :

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

Hypothèses

Les procédures suivantes présupposent ce qui suit :

  • Les exemples ci-après fournissent des options pour Swaks à partir de la ligne de commande dans un format long, par exemple --server contrairement au format court, -s.
  • L'exemple suivant présuppose que le comportement par défaut est une connexion au moyen de connecteurs logiciels réseau.
  • Aucun certificat local n'est requis pour la négociation d'une connexion TLS. L'exemple suivant présuppose le comportement par défaut, où Swaks ne tente pas de vérifier le certificat.
  • Swaks est destiné essentiellement à une utilisation sur des systèmes d'exploitation de type UNIX, avec des fonctionnalités basées sur des normes connues, afin de permettre un fonctionnement sur les serveurs de courriel les plus récents.

Configurer Swaks pour l'envoi de courriels au moyen du service de transmission de messages

Pour activer Swaks afin de tester la configuration du service de transmission de messages :

  1. Assurez-vous que le service de transmission de messages est configuré pour l'envoi de courriels. Voir Introduction.

    Note

    Les données d'identification SMTP sont requises pour configurer Swaks afin qu'il puisse utiliser le service de transmission de messages. Veuillez noter le nom d'utilisateur et le mot de passe lorsque vous générez les données d'identification SMTP.

  2. Assurez-vous que Swaks est installé. Le processus d'installation diffère selon le 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'
    Note

    Lorsque vous envoyez un courriel avec Swaks :

    • Le paramètre -tls est requis.
    • Le paramètre --pipeline est pris en charge pour l'exécution SMTP en cascade.
    • Le paramètre --port <number> ou la syntaxe :<port number> peut servir à spécifier le port.
    • Le mot de passe SMTP est demandé après l'exécution de cette commande