NAME

dmarc_httpd: a web server for DMARC validation and report viewing

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>
• Marc Bradshaw <marc@marcbradshaw.net>