Skip to content
DMARC Report Tool for use with rddmarc or dmarcts-report-parser (formerly imap-dmarcts)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
LICENSE
README.md MORE Screenshots! Jun 1, 2018
default.css
dmarcts-report-viewer-config.php.sample
dmarcts-report-viewer.php

README.md

dmarcts-report-viewer

A PHP viewer for DMARC records that have been parsed by John Levine's rddmarc script or the dmarcts-report-parser.pl

  • Allow to view pass/fail data for the parsed reports
  • Identify potential DMARC related issues through red/orange/green signals

Screenshots

alt text

Larger version of Screenshot 1

alt text

Larger version of Screenshot 2

Installation and Configuration

NOTE: The viewer expects that you have already populated a database with data from John Levine's rddmarc script or the dmarcts-report-parser.pl script.

To install dependencies...

on Debian/Unbuntu:

you need a webserver (apache, nginx, ...) with installed php and additionaly:

apt-get install  php-mysql

Download the required files:

git clone https://github.com/techsneeze/dmarcts-report-viewer.git

Once the PHP files have been downloaded, you will need to copy dmarcts-report-viewer-config.php.sample to dmarcts-report-viewer-config.php.

cp dmarcts-report-viewer-config.php.sample dmarcts-report-viewer-config.php

Configuration

Next, edit these basic configuration options at the top of the dmarcts-report-viewer-config.php file with the appropriate information:

$dbhost="localhost";
$dbname="dmarc";
$dbuser="dmarc";
$dbpass="xxx";
$dbport="3306";
$cssfile="default.css";

$default_lookup = 1;  # 1=on 0=off (on is old behaviour )
$default_sort = 1;  # 1=ASCdening 0=DESCending (ASCending is default behaviour )

Ensure that dmarcts-report-viewer-config.php, dmarcts-report-viewer.php, and default.css are in the same folder.

Usage

Navigate in your browser to the location of the dmarcts-report-viewer.php file.

You should be presented with the basic report view, allowing you to navigate through the reports that have been parsed.

Legend of the Colors

  • Green : DKIM and SPF = pass
  • Red : DKIM and SPF = fail
  • Orange : Either DKIM or SPF (but not both) = fail
  • Yellow : Some other condition, and should be investigated (e.g. DKIM or SPF result were missing, "softfail", "temperror", etc.)

More info can currently be found at : TechSneeze.com

You can’t perform that action at this time.