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 [email protected] or [email protected] 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.txtto install required packages. - Create a local Postgres database.
- Run
python manage.py migrateto run migrations.
To test using automated tests, run:
coverage run -m pytest
- Run
python manage.py runserverto run the project and openhttp://127.0.0.1:8000/. - Upload a DMARC file and yay you're all set!