Metadata-Version: 1.1
Name: django-dmarc
Version: 0.1.2
Summary: 
Making it easier to manage DMARC reports

Home-page: http://p-o.co.uk/tech-articles/django-dmarc/
Author: Alan Hicks
Author-email: ahicks@p-o.co.uk
License: BSD License
Download-URL: https://pypi.python.org/pypi/django-dmarc
Description: ============
        Django DMARC
        ============
        
        **Making it easier to manage DMARC reports**
        
        Designed to quickly and easily import DMARC reports.
        
        Quick start
        -----------
        
        1. Install the app
        
        2. Add "dmarc" to your INSTALLED_APPS setting like this::
        
            INSTALLED_APPS = (
                ...
                'dmarc',
            )
        
        3. Run 'python manage.py migrate' to create the database models.
        
        Usage
        =====
        python manage.py importdmarcreport
        
        You can choose to import an xml or zip file, alternatively with "-" you can pipe an email with the zipped report and it will do the right thing.
        
        Description
        ===========
        
        This Django DMARC project aims to help with implementation of DMARC "Domain-based Message Authentication, Reporting & Conformance" and ongoing monitoring by importing feedback reports about messages that pass and/or fail DMARC evaluation into a more easily digested format.
        
        Perhaps one of the main reasons DMARC is gaining traction amongst organisations of all sizes is a desire to protect their brand and reputation.  By defining and implementing a DMARC policy, an organization can help combat phishing, protect users and their reputation.
        
        Currently at beta stage, importing and data structure are fairly stable, reporting todo.
        
        Choosing Django was an easy choice as it offers an easily built import mechanism and transformation from xml to database through to presentation.
        
        Although it has options for importing either xml or zip files, the way it's used here at Persistent Objects is taking the email directly from SMTP and piping it through to the import routine.
        
        We use Exim here and the configuration couldn't be easier
        
        Router::
        
            dmarcreports:
                driver = accept
                condition = ${if eq{$local_part}{dmarc_report}}
                transport = trans_dmarcreports
        
        Transport::
        
            trans_dmarcreports:
                driver = pipe
                command = "/usr/local/bin/python2.7 /path/to/manage.py importdmarcreport -"
                freeze_exec_fail = true
                return_fail_output = true
        
        DMARC reporting
        ===============
        
        There is only the one report at dmarc/report/ and requires staff members authorization.
        
        Add the dmarc.urls to your urls::
        
            url(r"^", include("dmarc.urls")),
        
        This is a sample report
        
        .. image:: images/dmarc-report.png
           :alt: Sample DMARC report
        
        Dependencies
        ============
        
        * `Django`_ 1.7
        
        Resources
        =========
        
        * `DMARC`_
        * `Django`_
        * `Google gmail DMARC`_
        * `Download from PyPI`_
        
        Support
        =======
        
        To report a security issue, please send an email privately to
        `ahicks@p-o.co.uk`_. This gives us a chance to fix the issue and
        create an official release prior to the issue being made
        public.
        
        For general questions or comments, please contact  `ahicks@p-o.co.uk`_.
        
        `Project website`_
        
        Communications are expected to conform to the `Django Code of Conduct`_.
        
        .. GENERAL LINKS
        
        .. _`Django`: http://djangoproject.com/
        .. _`Django Code of Conduct`: https://www.djangoproject.com/conduct/
        .. _`Python`: http://python.org/
        .. _`Persistent Objects Ltd`: http://p-o.co.uk/
        .. _`Project website`: http://p-o.co.uk/tech-articles/django-dmarc/
        .. _`DMARC`: http://dmarc.org/
        .. _`Google gmail DMARC`: https://support.google.com/a/answer/2466580
        .. _`Download from PyPI`: https://pypi.python.org/pypi/django-dmarc
        
        .. PEOPLE WITH QUOTES
        
        .. _`Alan Hicks`: https://plus.google.com/103014117568943351106
        .. _`ahicks@p-o.co.uk`: mailto:ahicks@p-o.co.uk?subject=django-dmarc+Security+Issue
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires: django
