dblenkus.postfix-aws
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ž
ansible-galaxy install dblenkus.postfix-aws