This is an app for converting DMARC XML files to JSON that is presented on HTML file for readability. We have recently added DMARC policy to the djangogirls.org domain to prevent spammers from using our domain to send phishing emails via Sendgrid that appear to be coming from hello@djangogirls.org or fundraising@djangogirls.org email addresses.
DMARC reports are being sent to our dmarc
email address. Analyzing these emails hasn't been easy as they only contain XML
files which are not human-readable. Since the DMARC rules have kind of broken some of our email functionality on the website, I needed a way to decode the DMARC reports attachments so we can adjust our DMARC rules - and this is how this app came to be.
- Python 3.9 +
- Django 4.0 +
- Postgres 12
- Clone this repo.
- Create a virtual envinronment on your machine.
- Run
pip install -r requirements.txt
to install required packages. - Create a local Postgres database.
- Run
python manage.py migrate
to run migrations.
To test using automated tests, run:
coverage run -m pytest
- Run
python manage.py runserver
to run the project and openhttp://127.0.0.1:8000/
. - Upload a DMARC file and yay you're all set!