Add readme and sort defaults

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

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 }}'