Skip to main content

Managing DMARC aggregate and feedback reports

Project description

Managing DMARC aggregate and feedback reports

Designed to quickly and easily manage DMARC aggregate and feedback reports.

Quick start

  1. Install the app

  2. Add “dmarc” to your INSTALLED_APPS setting:

  3. Add dmarc.urls to your urls:

    from dmarc import urls as dmarc_urls
    urlpatterns = [
        url(r"^dmarc/", include(dmarc_urls)),
  4. Run ‘python migrate’ to create the database models.

  5. Import a report with:

    python importdmarcreport --email
  6. See your aggregated feedback reports from the Admin page at admin/dmarc


python importdmarcreport –email

You can choose to import an xml or email file, alternatively with “–email -” you can pipe an email and it will do the right thing.


This Django DMARC project aims to ease implementating DMARC “Domain-based Message Authentication, Reporting & Conformance” and ongoing monitoring by importing aggregate feedback reports about messages that pass and/or fail DMARC evaluation into a more easily digested format.

Perhaps one of the main reasons DMARC is gaining traction amongst organisations of all sizes is a desire to protect their brand and reputation. By defining and implementing a DMARC policy, an organization can help combat phishing, protect users and their reputation.

At beta stage, the application is stable, with most efforts on improving usability and documentation.

Choosing Django was an easy choice as it offers an easily built import mechanism and transformation from xml to database through to presentation.

Although it has options for importing either xml or email files, the way it’s used here at Persistent Objects is fully automated, taking the email directly from SMTP and piping it through to the import routine.


Install the app


Add “dmarc” to your INSTALLED_APPS setting:


Add dmarc.urls to your urls:

from dmarc import urls as dmarc_urls

urlpatterns = [
    url(r"^dmarc/", include(dmarc_urls)),

DMARC reports are namespaced so if you’re using django version 1.8 you will need to add the namespace ‘dmarc’:

urlpatterns = [
    url(r"^dmarc/", include(dmarc_urls, namespace='dmarc')),

Install tables

Run ‘python migrate’ to create the database tables.

Import feedback report

Import an email DMARC aggregate report with:

python importdmarcreport --email

Alternatively the xml report can be imported with:

python importdmarcreport --xml

The process of importing DMARC aggregate reports can be fully automated. At Persistent Objects we use Exim and the configuration couldn’t be easier.


    driver = accept
    condition = ${if eq{$local_part}{dmarc_report}}
    transport = trans_dmarcreports


    driver = pipe
    command = "/usr/local/bin/python2.7 /path/to/ importdmarcreport --email -"
    freeze_exec_fail = true
    return_fail_output = true

Congratulations, you have django-dmarc installed and ready to import DMARC aggregate feedback reports and start implementing DMARC and protecting your emails.

DMARC reporting

Aggregated feedback reports are available from the Admin page at admin/dmarc.

Django Administration showing this DMARC application

From the DMARC dashboard at ‘Site administration/DMARC’ where the intention is to highlight a summary of recent reports, there is one report ‘DMARC feedback reports’ and is available to any user with staff members authorization.

DMARC dashboard

This is an example report, it can also be downloaded as a csv file suitable for importing into your favourite spreadsheet.

Example DMARC aggregate feedback report

The report can be filtered by clicking on the filter and changing any of the reporting period, only showing errors/failures, disposition (quarantine, rejection or any) and by source ip address/reporting organisation.

Example DMARC aggregate feedback report

These reports can help ease the introduction of DMARC making email safer.


Although there is usually no need to remove old records, access to the report table is offered to allow for record deletion.



To report a security issue, please send an email privately to This gives us a chance to fix the issue and create an official release prior to the issue being made public.

For general questions or comments, please contact

Project website

Communications are expected to conform to the Django Code of Conduct.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-dmarc, version 0.5.0
Filename, size File type Python version Upload date Hashes
Filename, size django-dmarc-0.5.0.tar.gz (519.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page