DMARC related tools for Modoboa
Project description
A set of tools to use DMARC through Modoboa.
This plugin is still in BETA stage, for now it only parses XML aggregated reports and generate visual reports (using c3.js) on a per-domain basis.
Installation
Make sure to install the following additional system package according to your distribution:
Debian / Ubuntu |
---|
libmagic1 |
CentOS |
---|
file-devel |
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', 'modoboa.parameters', # 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 collectstatic $ 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
Specific Upgrade Instructions
1.3.0
modoboa-dmarc now requires an additional system package according to your distribution:
Debian / Ubuntu |
---|
libmagic1 |
CentOS |
---|
file-devel |
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.
Source Distribution
Built Distribution
Hashes for modoboa_dmarc-1.3.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c799b73f198612df8c822754595d73f71f0392d46cbb683eb5b89dcc07ece6cc |
|
MD5 | 91ca7de2c4c85ec887bcb09d0987421d |
|
BLAKE2b-256 | 10ad5402e6d2206bff87cfa2fa6cc887e9f7c12d2cbd6d470e4795aedcebd8a6 |