ansible-postfix-aws

Ansible-Rolle zur Installation von Postfix und zur Konfiguration, damit E-Mails über den Amazon SES-Dienst gesendet werden.

Diese Rolle orientiert sich an der offiziellen Amazon-Dokumentation für SES_ mit einigen Anpassungen, um Idempotenz zu gewährleisten.

.. _Amazon-Dokumentation für SES: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/postfix.html

Anforderungen

Derzeit unterstützt die Rolle nur die Distributionen CentOS, Red Hat Enterprise Linux (RHEL) EL7 und Ubuntu_ 18.04 LTS.

Wenn Sie Unterstützung für andere Distributionen benötigen, können Sie gerne einen Pull-Request_ einreichen.

Um diese Rolle zu verwenden, benötigen Sie ein Amazon AWS-Konto_ (befolgen Sie die Online-Anweisungen zur Erstellung) und einen IAM-Benutzer zur SMTP-Authentifizierung mit SES. Um dies zu erstellen, folgen Sie den Online-Anweisungen zum Erhalten von SMTP-Anmeldeinformationen_. Beachten Sie, dass der erhaltene SMTP-Benutzername und das Passwort nicht mit der Zugangsschlüssel-ID und der geheimen Zugangsschlüssel des IAM-Benutzers identisch sind.

Damit die Rolle richtig funktioniert, muss die "Von"-E-Mail-Adresse mit SES verifiziert werden. Wenn sich Ihr Konto noch in der Sandbox befindet, müssen auch alle "An"-E-Mail-Adressen verifiziert werden. Für weitere Informationen siehe die Anweisungen von Amazon zur Verifizierung von E-Mail-Adressen_.

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

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

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

.. _Pull-Request einreichen: https://github.com/dblenkus/ansible-postfix/aws/pull/new/master

.. _Amazon AWS-Konto: https://aws.amazon.com/

.. _Erhalten von SMTP-Anmeldeinformationen: https://docs.aws.amazon.com/ses/latest/DeveloperGuide/smtp-credentials.html

.. _Anweisungen von Amazon zur Verifizierung von E-Mail-Adressen: http://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-email-addresses.html

Rollenvariablen

+---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | Name | Typ | Beschreibung | Obligatorisch | Standard | +=======================================+==========+===========================================+===========+=========================================================================+ | postfix_aws_ses_host | string | Hostname des Amazon SES-Servers. | nein | email-smtp.eu-west-1.amazonaws.com | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_port | integer | Port des Amazon SES-Servers. | nein | 25 | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_username | string | Benutzername für die SMTP-Authentifizierung mit | ja | | | | | dem Amazon SES-Server. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_ses_password | string | Passwort für die SMTP-Authentifizierung mit | ja | | | | | dem Amazon SES-Server. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_default_from_email | string | Standard-Absender-E-Mail-Adresse. | ja | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+ | postfix_aws_sender_canonical_maps | list | Liste von kanonischen Zuordnungen für die | nein | .. code-block:: yaml | | | | Absenderadressen von Umschlägen und Header: | | | | | | | | muster: "/.+/" | | | | .. code-block:: yaml | | adresse: "{{ postfix_aws_default_from_email }}" | | | | | | kommentar: Alle Absenderadressen auf die Standard-Absender-E-Mail-Adresse mappen | | | | muster: string | | | | | | adresse: string | | | | | | kommentar: string | | | | | | | | | | | | wobei muster einen regulären | | | | | | Ausdruck bezeichnet, der zur ursprünglichen| | | | | | Absenderadresse passt und adresse | | | | | | die Absenderadresse ist, durch die ersetzt| | | | | | werden soll. | | | | | | Für weitere Informationen siehe Postfix's | | | | | | postconf.5 Handbuchseite_. | | | | | | Der kommentar ist optional und | | | | | | dient als Kommentar in der | | | | | | /etc/postfix/sender_canonical-Datei. | | | +---------------------------------------+----------+-------------------------------------------+-----------+-------------------------------------------------------------------------+

.. _Postfix's postconf.5 Handbuchseite: http://www.postfix.org/postconf.5.html#sender_canonical_maps

Abhängigkeiten

Keine Abhängigkeiten.

Beispiel-Playbook

Um diese Rolle zu verwenden, fügen Sie Folgendes zu Ihrem Playbook hinzu:

.. code-block:: yaml

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

Lizenz

Lizensiert unter der GPLv3-Lizenz. Siehe die Datei COPYING für Details.

Autoreninformationen

| Domen Blenkuš | Tadej Janež