Skip to content

Quick'n'Dirty tool to get a human readable DMARC report

License

Notifications You must be signed in to change notification settings

cjeanneret/dmarc-report

Repository files navigation

DMARC reporting tool

Simple scripts providing an easy way to get a human readable reporting for DMARC

Dependencies

  • offlineimap
  • (python3) progressbar2
  • (python3) dns
  • (python3) jinja2
  • (python3) mimetypes
  • (python3) socket
  • (python3) sqlite3
  • (python3) zipfile
  • (python3) xml

Content

extract.py

Extracts attachments (zip, gzip) and save them in "reports" directory.

dmarc.py

Magical script that will read DMARC reports, and inject new records into an sqlite3 DB

template.j2

Template used to generate the report (report.html). Nothing fancy.

offlineimaprc.sample

Sample for offlineimap configuration file. You should ensure its mode is set to 0400. Name must be offlineimaprc

script.sh

The script you want to launch on a regular basis. Will call the other ones in order to provide you an easy to read report.

Milligram

Lightweight CSS framework, under MIT license.

IPs

The report will highlight when your IPs are listed (red if failed, else green). There are two ways to provide them:

  • either create a "my_ips" file, based on the provided sample
  • or let the script detect your MX.

Please note: the script won't check your SPF record, meaning it won't fetch specific IPs (at least for now). If you have other IPs than your MX, you must provide the full list using the MY_IPS environment variable.

License

Shipped under MIT license.

About

Quick'n'Dirty tool to get a human readable DMARC report

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published