https://github.com/domainaware/parsedmarc

A Python package and CLI for parsing aggregate and forensic DMARC reports
https://github.com/domainaware/parsedmarc

Last synced: 3 months ago
JSON representation

A Python package and CLI for parsing aggregate and forensic DMARC reports

• Host: GitHub
• URL: https://github.com/domainaware/parsedmarc
• Owner: domainaware
• License: apache-2.0
• Created: 2018-02-05T23:08:59.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2024-04-11T15:53:43.000Z (10 months ago)
• Last Synced: 2024-04-12T00:19:56.293Z (10 months ago)
• Language: Python
• Homepage: https://domainaware.github.io/parsedmarc/
• Size: 31.3 MB
• Stars: 910
• Watchers: 26
• Forks: 200
• Open Issues: 107
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-opensource-email - parsedmarc - A Python package and CLI for parsing aggregate and forensic DMARC reports - `Apache License version 2.0`, `Python` (Security / DMARC)
• jimsghstars - domainaware/parsedmarc - A Python package and CLI for parsing aggregate and forensic DMARC reports (Python)

README

        
# parsedmarc

[![Build

Status](https://github.com/domainaware/parsedmarc/actions/workflows/python-tests.yml/badge.svg)](https://github.com/domainaware/parsedmarc/actions/workflows/python-tests.yml)

[![Code

Coverage](https://codecov.io/gh/domainaware/parsedmarc/branch/master/graph/badge.svg)](https://codecov.io/gh/domainaware/parsedmarc)

[![PyPI

Package](https://img.shields.io/pypi/v/parsedmarc.svg)](https://pypi.org/project/parsedmarc/)

[![PyPI - Downloads](https://img.shields.io/pypi/dm/parsedmarc?color=blue)](https://pypistats.org/packages/parsedmarc)



  



`parsedmarc` is a Python module and CLI utility for parsing DMARC

reports. When used with Elasticsearch and Kibana (or Splunk), it works

as a self-hosted open-source alternative to commercial DMARC report

processing services such as Agari Brand Protection, Dmarcian, OnDMARC,

ProofPoint Email Fraud Defense, and Valimail.

> [!NOTE]

> __Domain-based Message Authentication, Reporting, and Conformance__ (DMARC) is an email authentication protocol.

## Help Wanted

This project is maintained by one developer. Please consider

reviewing the open

[issues](https://github.com/domainaware/parsedmarc/issues) to see how

you can contribute code, documentation, or user support. Assistance on

the pinned issues would be particularly helpful.

Thanks to all

[contributors](https://github.com/domainaware/parsedmarc/graphs/contributors)!

## Features

- Parses draft and 1.0 standard aggregate/rua reports

- Parses forensic/failure/ruf reports

- Can parse reports from an inbox over IMAP, Microsoft Graph, or Gmail

    API

- Transparently handles gzip or zip compressed reports

- Consistent data structures

- Simple JSON and/or CSV output

- Optionally email the results

- Optionally send the results to Elasticsearch and/or Splunk, for use

    with premade dashboards

- Optionally send reports to Apache Kafka