ansible-postfix-aws

Rol de Ansible para instalar Postfix y configurarlo para enviar correos electrónicos a través del servicio Amazon SES.

Esta rol sigue la documentación oficial de Amazon para SES_ con algunas modificaciones para asegurar la idempotencia.

.. _documentación oficial de Amazon para SES: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/postfix.html

Requisitos

Actualmente, el rol solo soporta las distribuciones CentOS, Red Hat Enterprise Linux (RHEL) EL7 y Ubuntu_ 18.04 LTS.

Si necesitas soporte para otras distribuciones, siéntete libre de enviar una solicitud de extracción_.

Para usar este rol, debes tener una cuenta de Amazon AWS_ (para crearla sigue las instrucciones en línea) y un usuario de IAM para autenticación SMTP con SES. Para crearlo, sigue las instrucciones en línea sobre Obteniendo credenciales SMTP_. Ten en cuenta que el nombre de usuario y la contraseña SMTP obtenidos no son los mismos que el ID de clave de acceso y la clave de acceso secreta del usuario de IAM.

Para que el rol funcione correctamente, la dirección de correo electrónico "de" debe estar verificada con SES. Si tu cuenta aún está en modo sandbox, todos los correos electrónicos "a" también deben estar verificados. Para más información, consulta las instrucciones de Amazon sobre la verificación de direcciones de correo electrónico_.

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

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

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

.. _enviar una solicitud de extracción: https://github.com/dblenkus/ansible-postfix/aws/pull/new/master

.. _cuenta de Amazon AWS: https://aws.amazon.com/

.. _Obteniendo credenciales SMTP: https://docs.aws.amazon.com/ses/latest/DeveloperGuide/smtp-credentials.html

.. _instrucciones de Amazon sobre la verificación de direcciones de correo electrónico: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-email-addresses.html

Variables del Rol

+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | Nombre | Tipo | Descripción | Obligatorio| Por defecto | +=======================================+==========+===========================================+===========+=========================================================================+ | postfix_aws_ses_host | cadena | Nombre del servidor Amazon SES. | no | email-smtp.eu-west-1.amazonaws.com | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_port | entero | Puerto del servidor Amazon SES. | no | 25 | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_username | cadena | Nombre de usuario para autenticación SMTP | sí | | | | | con el servidor Amazon SES. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_password | cadena | Contraseña para autenticación SMTP | sí | | | | | con el servidor Amazon SES. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_default_from_email | cadena | Dirección de correo electrónico "De" | sí | | | | | por defecto. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_sender_canonical_maps | lista | Lista de mapeos canónicos para direcciones| no | .. code-block:: yaml | | | | de remitente en sobre y cabecera: | | | | | | | | patrón: "/.+/" | | | | .. code-block:: yaml | | dirección: "{{ postfix_aws_default_from_email }}" | | | | | | comentario: Mapear todas las direcciones de remitente a la | | | | dirección de correo por defecto | | | | | | patrón: cadena | | | | | | dirección: cadena | | | | | | comentario: cadena | | | | | | | | | | | | donde patrón representa una expresión | | | | | | regular que coincide con la dirección | | | | | | de remitente original y dirección | | | | | | representa la dirección de remitente con | | | | | | la que reemplazar la original. | | | | | | Para más información, consulta la página | | | | | | manual postconf.5 de Postfix_. | | | | | | El comentario representa un texto | | | | | | opcional para poner como comentario en | | | | | | el archivo /etc/postfix/sender_canonical. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+

.. _página manual postconf.5 de Postfix: http://www.postfix.org/postconf.5.html#sender_canonical_maps

Dependencias

No hay dependencias.

Ejemplo de Playbook

Para usar este rol, agrégalo a tu playbook:

.. code-block:: yaml

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

Licencia

Licenciado bajo la Licencia GPLv3. Consulta el archivo COPYING para más detalles.

Información del Autor

| Domen Blenkuš | Tadej Janež