Metadata-Version: 1.1
Name: collective.fingerpointing
Version: 1.0b4
Summary: Keep track of different events and write them down to an audit log.
Home-page: https://github.com/collective/collective.fingerpointing
Author: Héctor Velarde
Author-email: hector.velarde@gmail.com
License: UNKNOWN
Description: .. image:: https://raw.githubusercontent.com/collective/collective.fingerpointing/master/docs/fingerpointing.png
            :align: left
            :alt: Finger Pointing
            :height: 100px
            :width: 100px
        
        ***************
        Finger Pointing
        ***************
        
        .. contents:: Table of Contents
        
        Life, the Universe, and Everything
        ==================================
        
        Keep track of different events and write them down to an audit log.
        
        Mostly Harmless
        ===============
        
        .. image:: http://img.shields.io/pypi/v/collective.fingerpointing.svg
           :target: https://pypi.python.org/pypi/collective.fingerpointing
        
        .. image:: https://img.shields.io/travis/collective/collective.fingerpointing/master.svg
            :target: http://travis-ci.org/collective/collective.fingerpointing
        
        .. image:: https://img.shields.io/coveralls/collective/collective.fingerpointing/master.svg
            :target: https://coveralls.io/r/collective/collective.fingerpointing
        
        Got an idea? Found a bug? Let us know by `opening a support ticket`_.
        
        .. _`opening a support ticket`: https://github.com/collective/collective.fingerpointing/issues
        
        Known Issues
        ------------
        
        Running your site behind a CDN may result in inconsistent IP addresses being logged.
        In CloudFlare, for instance, you can work around this limitation by enabling a feature called ''True-Client-IP Header'',
        but it requires an Enterprise plan.
        
        Don't Panic
        ===========
        
        Installation
        ------------
        
        To enable this package in a buildout-based installation:
        
        #. Edit your buildout.cfg and add add the following to it:
        
        .. code-block:: ini
        
            [buildout]
            ...
            eggs =
                collective.fingerpointing
        
        After updating the configuration you need to run ''bin/buildout'', which will take care of updating your system.
        
        Go to the 'Site Setup' page in a Plone site and click on the 'Add-ons' link.
        
        Check the box next to ``collective.fingerpointing`` and click the 'Activate' button.
        
        Usage
        -----
        
        Go to 'Site Setup' and select 'Finger Pointing' and enable the events you want to keep an eye on.
        
        .. figure:: https://raw.githubusercontent.com/collective/collective.fingerpointing/master/docs/controlpanel.png
            :align: center
            :height: 600px
            :width: 768px
        
            The Finger Pointing control panel configlet.
        
        Finger Pointing will start logging the selected events:
        
        .. code-block:: console
        
            # bin/instance fg
            2016-03-01 17:29:29 INFO ZServer HTTP server started at Tue Mar  1 17:29:29 2016
                    Hostname: 0.0.0.0
                    Port: 8080
            2016-03-01 17:29:31 INFO collective.fingerpointing Start logging audit information to audit.log
            2016-03-01 17:29:34 INFO Plone OpenID system packages not installed, OpenID support not available
            2016-03-01 17:29:37 INFO Zope Ready to handle requests
            2016-03-01 17:31:40 INFO collective.fingerpointing user=admin ip=127.0.0.1 action=logged out
            2016-03-01 17:31:49 INFO collective.fingerpointing user=admin ip=127.0.0.1 action=logged in
        
        These events are also logged in `var/log/audit.log`:
        
        .. code-block:: console
        
            2016-03-01 17:31:40,813 - INFO - user=admin ip=127.0.0.1 action=logged out
            2016-03-01 17:31:49,678 - INFO - user=admin ip=127.0.0.1 action=logged in
        
        An audit log view is available in the user menu to users with the `collective.fingerpointing: View Audit Log` permission:
        
        .. figure:: https://raw.githubusercontent.com/collective/collective.fingerpointing/master/docs/audit-log-view.png
            :align: left
            :alt: Finger Pointing
            :height: 480px
            :width: 768px
        
            The Finger Pointing audit log view.
        
        Audit log files are rotated automatically every day at midnight and up to 30 days are maintained in backup.
        
        Share and Enjoy
        ===============
        
        This package would not have been possible without the contribution of the following people:
        
        - Héctor Velarde
        - René Jochum <rene@webmeisterei.com>
        - Harald Friessnegger (Webmeisterei GmbH)
        - Font Awesome (`icon`_)
        
        You can find an updated list of package contributors on `GitHub`_.
        
        .. _`GitHub`: https://github.com/collective/collective.fingerpointing/contributors
        .. _`icon`: http://fontawesome.io/icon/hand-o-right/
        
        Changelog
        =========
        
        1.0b4 (2016-07-07)
        ------------------
        
        - Avoid UnicodeEncodeError with log messages.
          [jianaijun, rodfersou]
        
        - Support automatic rotation of audit log files at timed intervals;
          a new file is created every day and up to 30 backup files are maintained (closes `#9`_).
          [hvelarde]
        
        - Use object representation to log life cycle events;
          this fixes an issue with Archetypes-based objects being dumped to the log (refs. `#8`_ and fixes `#38`_).
          [hvelarde]
        
        - Package is now compatible with Plone 5.0 and Plone 5.1.
          [hvelarde]
        
        
        1.0b3 (2016-04-19)
        ------------------
        
        - Added Chinese Simplified translation. [jianaijun]
        
        - Package no longer rises `AttributeError` when running interactive console (`bin/instance debug`) (fixes `#30`_).
          [hvelarde]
        
        - Clean up audit log messages.
          [hvelarde]
        
        - Disable rendering of left and right columns in audit log view.
          [hvelarde]
        
        - Audit log entries are now shown in reverse order (newer entries first).
          [hvelarde]
        
        
        1.0b2 (2016-03-18)
        ------------------
        
        - Log to audit.log even if Zope's `event-log-level` is above INFO (fixes `#25`_).
          [fRiSi]
        
        - Add German translations.
          [fRiSi]
        
        - Fix output of the audit log view.
          [pcdummy, hvelarde]
        
        - Add Brazilian Portuguese and Spanish translations.
          [hvelarde]
        
        - The "View Audit log" action appears now before the "Log out" one (fixes `#18`_).
          [pcdummy, hvelarde]
        
        - Use main_template for the audit log view.
          [pcdummy]
        
        - Avoid `TypeError` while running third party tests (fixes `#2`_).
          [hvelarde]
        
        
        1.0b1 (2016-03-09)
        ------------------
        
        - Add a view for the audit.log file `@@fingerpointing-audit-log` and link it to portal_actions.
          [pcdummy, hvelarde]
        
        - Make control panel configlet accesible to Site Administrator role (closes `#15`_).
          [hvelarde]
        
        - Avoid `ComponentLookupError` when removing a Plone site (fixes `#4`_).
          [hvelarde]
        
        - Remove unused plone.directives.form dependency which pulled in Grok packages.
          [vangheem]
        
        - Audit information is now logged into a file named `audit.log` instead of inside the standard `event.log`.
          [pcdummy]
        
        - Package is now compatible with Plone 5.
          [hvelarde]
        
        - Ignore errors caused by subscribers trying to access nonexistent registry records when package is still not installed (fixes `#1`_).
          [hvelarde]
        
        
        1.0a1 (2015-06-08)
        ------------------
        
        - Initial release.
        
        .. _`#1`: https://github.com/collective/collective.fingerpointing/issues/1
        .. _`#2`: https://github.com/collective/collective.fingerpointing/issues/2
        .. _`#4`: https://github.com/collective/collective.fingerpointing/issues/4
        .. _`#8`: https://github.com/collective/collective.fingerpointing/issues/8
        .. _`#9`: https://github.com/collective/collective.fingerpointing/issues/9
        .. _`#15`: https://github.com/collective/collective.fingerpointing/issues/15
        .. _`#18`: https://github.com/collective/collective.fingerpointing/issues/18
        .. _`#25`: https://github.com/collective/collective.fingerpointing/issues/25
        .. _`#30`: https://github.com/collective/collective.fingerpointing/issues/30
        .. _`#38`: https://github.com/collective/collective.fingerpointing/issues/38
        
Keywords: plone events subscribers log audit security
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
Classifier: Framework :: Plone :: 5.0
Classifier: Framework :: Plone
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
