Store and monitor login access to your Plone site
Project description
Save any login operation done in your Plone site to an external database and provide a Plone interface for query the database.
Introduction
This Plone add-on is based on z3c.saconfig and SQLAlchemy, and can’t provide any new feature to Plone without a propert configuration.
Keep reading for installation and configuration guide.
How to use
After the installation, any login done in your Plone will save to an external database an entry that store:
user id
a timestamp
Then a new configuration panel can bhe found in the site configuration: “Monitor user logins”.
From this view you can query the database previously populated:
You must limit the search inside a rande of dates, and optionally limiting users to members of a group. Results of the table displayed can be export to a CSV file.
Multiple sites
If your buildout hosts multiple Plone sites, all of them will store data in the database keeping same username on different sites separated.
Installation and configuration
You must configure an access to an external DBMS. The name of the engine used must be plone_logins.
Follow an example based on sqlite (not advised for production environment).
Add collective.login_monitor to your buildout, then provide a SQLAlchemy connection string:
[buildout]
...
[instance]
...
eggs=
...
collective.login_monitor
zcml-additional =
...
<configure xmlns="http://namespaces.zope.org/zope"
xmlns:db="http://namespaces.zope.org/db">
<include package="z3c.saconfig" file="meta.zcml" />
<db:engine name="plone_logins"
url="sqlite:///${buildout:directory}/var/filestorage/plone_logins.db"
setup="collective.login_monitor.prepare_model.prepare"
/>
<db:session name="plone_logins" engine="plone_logins" />
</configure>
Credits
Developed with the support of:
All of them supports the PloneGov initiative.
Changelog
0.3.1 (2014-11-06)
Fixed date error in that will be raised in some cases [keul]
React to a wider range of problems when database connection is not working [keul]
0.3 (2014-10-28)
Dropped Plone 3 compatibility
Add Full Name and E-mail columns to the search results and CSV output. [davidjb]
Fix selected Group logic on search form. [davidjb]
Clarify description for group selection field. [davidjb]
Minor grammar update for column headings on search page and export. [davidjb]
Change icon URLs to use PNG format rather than deprecated GIF images. [davidjb]
Add exception handling in the event, if no db is configured [cekk]
0.2 (2013-04-18)
First public release
old code totally refactored (removed sqldict for a pure SQLAlchemy approach) [keul]
i18n support [keul]
0.1 (unreleased)
Initial release
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for collective.login_monitor-0.3.1.zip
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0214275759839315005df13d83bfd3935dd517ae26a8baa9f483f6b1b0ed3e10 |
|
MD5 | 9d33a80bfb895d2cb48d5ebf9b3336a2 |
|
BLAKE2b-256 | bf95a5a32d71513a4a464e555479f39c4b9e40aa9fdabfc9807266169e151f8a |