DMARC_HTTPD(1)

NAME
dmarc_httpd - a web server for DMARC validation and report viewing

VERSION
version 1.20160612

SYNOPSIS
A HTTP interface for:

•   local DMARC reports

•   DMARC validator service

Start the HTTP server:

    dmarc_httpd

Connect with a web browser to http://localhost:8080 <http://localhost:8080/>.

DESCRIPTION
The HTTP server handles 4 types of requests:

•   /

    Serves files stored in the perl share directory of the Mail::DMARC module. This presently entails one HTML file and a handful of CSS and JS files for the report viewing feature.

•   /dmarc/json/validate - DMARC validation requests

    Accepts a JSON encoded HTTP POST request. Validates the request, performs a DMARC validation and returns a JSON encoded result object. This is the API for non-perl applications to utilize Mail::DMARC.

    See the dmarc_http_client app for a usage example.

•   /dmarc/json/report

    Accepts AJAX requests from the browser and returns JSON encoded DMARC reports.

•   /dmarc/json/row

    Accepts AJAX requests from the browser and returns JSON encoded DMARC report rows.

An implementation that uses the http validation service is the included <dmarc_http_client> and another is the dmarc plugin in the <Haraka mail server|http://haraka.github.io>.

A Sample Report <http://search.cpan.org/dist/Mail-DMARC/example/report_cgi.png> is available which shows the web interface. It is implemented almost entirely in JavaScript, using jQuery, jQueryUI, and jqGrid.

Web server settings are in the [http] and [https] sections of mail-dmarc.ini.

THANKS
jQuery - http://www.jquery.com/

jqGrid - http://www.trirand.com/blog/

AUTHORS

•   Matt Simerson <msimerson@cpan.org>

•   Davide Migliavacca <shari@cpan.org>

COPYRIGHT AND LICENSE
This software is copyright (c) 2015 by Matt Simerson.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.