diff --git a/README.md b/README.md index 5c2081e..c2ba03e 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,26 @@ -## ansible-role-XXXX +## ansible-role-opendkim_postfix -Work in progress... +Configure OpenDKIM in your Postfix server and optionally publish your domain(s) public key(s). +DKIM is a way of signing all your emails with your own key, ensuring other servers that the email is coming from a trustwhorthy (or a bit more trustworthy) server. +It relays on publishing the public key in DNS records. # Requirements +An existing installation of Postfix. + # Installation +Add to your requirements.yml file a role entry like: +```yaml + - name: opendkim_postfix + src: ssh://git@repos.susurrando.com:7272/srv/git.repos/ansible-role-opendkim_postfix.git + scm: git +``` + # Usage +Set at least a list of domain names with the variable mail_domains. If you have an OVH account for your DNS domains you can add the variables related (check defaults/main.yml). + # Credits -Antonio J. Delgado 2022 https://gitlab.com/antoniodelgado +Antonio J. Delgado 2023 https://gitlab.com/antoniodelgado diff --git a/defaults/main.yml b/defaults/main.yml index c3650d7..3c29ad6 100644 --- a/defaults/main.yml +++ b/defaults/main.yml @@ -1,6 +1,6 @@ --- +mail_domains: [] create_ovh_dkim_entry: true -dkim_selector: default ovh_application_key: "{{ vault_ovh_api_key }}" ovh_application_secret: "{{ vault_ovh_api_secret }}" ovh_consumer_key: '{{ vault_ovh_consumer_key }}'