ansible-postfix-aws

Rôle Ansible pour installer Postfix et le configurer pour envoyer des e-mails via le service Amazon SES.

Ce rôle suit la documentation officielle d'Amazon pour SES_ avec quelques modifications pour assurer l'idempotence.

.. _documentation officielle d'Amazon pour SES: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/postfix.html

Exigences

Actuellement, le rôle ne prend en charge que les versions de CentOS_ , Red Hat Enterprise Linux (RHEL)_ EL7 et Ubuntu_ 18.04 LTS.

Si vous avez besoin de support pour d'autres distributions, n'hésitez pas à soumettre une demande de tirage_.

Pour utiliser ce rôle, vous devez avoir un compte Amazon AWS_ (pour en créer un, suivez les instructions en ligne) et un utilisateur IAM pour l'authentification SMTP avec SES. Pour le créer, suivez les instructions en ligne sur l'obtention des identifiants SMTP_. Notez que le nom d'utilisateur et le mot de passe SMTP obtenus ne sont pas les mêmes que l'ID de clé d'accès et la clé d'accès secrète de l'utilisateur IAM.

Pour que le rôle fonctionne correctement, l'adresse e-mail "de" doit être vérifiée avec SES. Si votre compte est encore en mode bac à sable, toutes les adresses e-mail "à" doivent également être vérifiées. Pour plus d'informations, consultez les instructions d'Amazon sur la vérification des adresses e-mail_.

.. _CentOS: https://www.centos.org/

.. _Red Hat Enterprise Linux (RHEL): https://www.redhat.com/en/technologies/linux-platforms/enterprise-linux

.. _Ubuntu: https://ubuntu.com/

.. _soumettre une demande de tirage: https://github.com/dblenkus/ansible-postfix/aws/pull/new/master

.. _compte Amazon AWS: https://aws.amazon.com/

.. _l'obtention des identifiants SMTP: https://docs.aws.amazon.com/ses/latest/DeveloperGuide/smtp-credentials.html

.. _les instructions d'Amazon sur la vérification des adresses e-mail: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-email-addresses.html

Variables du Rôle

+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | Nom | Type | Description | Obligatoire | Par défaut | +=======================================+==========+===========================================+===========+=========================================================================+ | postfix_aws_ses_host | chaîne | Nom d'hôte du serveur Amazon SES. | non | email-smtp.eu-west-1.amazonaws.com | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_port | entier | Port du serveur Amazon SES. | non | 25 | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_username | chaîne | Nom d'utilisateur pour l'authentification SMTP avec | oui | | | | | le serveur Amazon SES. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_password | chaîne | Mot de passe pour l'authentification SMTP avec | oui | | | | | le serveur Amazon SES. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_default_from_email | chaîne | Adresse e-mail par défaut de l'expéditeur. | oui | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_sender_canonical_maps | liste | Liste des mappages canoniques pour les adresses d'expéditeur | non | .. code-block:: yaml | | | | des enveloppes et des en-têtes sous la forme: | | | | | | | | motif: "/.+/" | | | | .. code-block:: yaml | | adresse: "{{ postfix_aws_default_from_email }}" | | | | | | commentaire: Mapper toutes les adresses d'expéditeur à l'adresse e-mail par défaut | | | | motif: chaîne | | | | | | adresse: chaîne | | | | | | commentaire: chaîne | | | | | | | | | | | | où motif représente une expression régulière qui | | | | | | correspond à l'adresse d'expéditeur d'origine | | | | | | et adresse représente | | | | | | l'adresse d'expéditeur avec laquelle | | | | | | remplacer l'originale. | | | | | | Pour plus d'informations, voir la page manuelle de Postfix_. | | | | | | Le commentaire représente un texte optionnel à | | | | | | mettre en commentaire dans le fichier | | | | | | /etc/postfix/sender_canonical. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+

.. _page manuelle de Postfix: http://www.postfix.org/postconf.5.html#sender_canonical_maps

Dépendances

Aucune dépendance.

Exemple de Playbook

Pour utiliser ce rôle, ajoutez ceci à votre playbook :

.. code-block:: yaml

- hosts: servers
  become: true
  roles:
     - { role: dblenkus.postfix-aws }

Licence

Sous licence GPLv3. Voir le fichier COPYING pour les détails.

Informations sur l'auteur

| Domen Blenkuš | Tadej Janež