DMARC related tools
Project description
A set of tools to use DMARC through Modoboa.
This plugin is still in BETA stage, for now it only parse XML aggregated reports and generate visual reports (using c3.js) on a per-domain basis.
Installation
Install this extension system-wide or inside a virtual environment by running the following command:
$ pip install modoboa-dmarc
Edit the settings.py file of your modoboa instance and add modoboa_dmarc inside the MODOBOA_APPS variable like this:
MODOBOA_APPS = ( 'modoboa', 'modoboa.core', 'modoboa.lib', 'modoboa.admin', 'modoboa.limits', 'modoboa.relaydomains', # Extensions here 'modoboa_dmarc', )
Run the following commands to setup the database tables:
$ cd <modoboa_instance_dir> $ python manage.py migrate modoboa_dmarc $ python manage.py load_initial_data
Finally, restart the python process running modoboa (uwsgi, gunicorn, apache, whatever).
Integration with Postfix
A management command is provided to automatically parse DMARC aggregated reports (rua) and feed the database. The execution of this command can be automated with the definition of a postfix service and a custom transport table.
First, declare a new service in /etc/postfix/master.cf:
dmarc-rua-parser unix - n n - - pipe flags= user=vmail:vmail argv=<path to python> <path to modoboa instance>/manage.py import_aggregated_report --pipe
Define a new transport table inside /etc/postfix/main.cf:
transport_maps = hash:/etc/postfix/dmarc_transport # other transport maps...
Create a file called /etc/postfix/dmarc_transport with the following content:
<email address your declared in your DNS record> dmarc-rua-parser:
Hash the file using the following command:
$ postmap /etc/postfix/dmarc_transport
Finally, reload postfix:
$ service postfix reload
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.