Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/modoboa/modoboa-dmarc
A set of tools to use DMARC through Modoboa.
https://github.com/modoboa/modoboa-dmarc
dmarc modoboa postfix
Last synced: about 1 month ago
JSON representation
A set of tools to use DMARC through Modoboa.
- Host: GitHub
- URL: https://github.com/modoboa/modoboa-dmarc
- Owner: modoboa
- License: mit
- Archived: true
- Created: 2015-07-09T08:41:23.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-02-16T15:57:38.000Z (almost 2 years ago)
- Last Synced: 2024-09-28T08:18:41.236Z (3 months ago)
- Topics: dmarc, modoboa, postfix
- Language: Python
- Size: 162 KB
- Stars: 15
- Watchers: 11
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - modoboa/modoboa-dmarc - A set of tools to use DMARC through Modoboa. (others)
README
modoboa-dmarc
=============
|gha| |codecov|
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
$ 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= /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::
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 |
+------------+
.. |gha| image:: https://github.com/modoboa/modoboa-dmarc/actions/workflows/plugin.yml/badge.svg
:target: https://github.com/modoboa/modoboa-dmarc/actions/workflows/plugin.yml
.. |codecov| image:: https://codecov.io/gh/modoboa/modoboa-dmarc/branch/master/graph/badge.svg
:target: https://codecov.io/gh/modoboa/modoboa-dmarc