ldapcherry/README.rst

**************
  LdapCherry 
**************

Nice and simple application to manage users and groups in multiple directory services.

.. image:: https://travis-ci.org/kakwa/ldapcherry.svg?branch=master
    :target: https://travis-ci.org/kakwa/ldapcherry
    
.. image:: https://coveralls.io/repos/kakwa/ldapcherry/badge.svg 
    :target: https://coveralls.io/r/kakwa/ldapcherry

.. image:: https://img.shields.io/pypi/dm/ldapcherry.svg
    :target: https://pypi.python.org/pypi/ldapcherry
    :alt: Number of PyPI downloads
    
.. image:: https://img.shields.io/pypi/v/ldapcherry.svg
    :target: https://pypi.python.org/pypi/ldapcherry
    :alt: PyPI version

----

:Doc:    `ldapcherry documentation on ReadTheDoc <http://ldapcherry.readthedocs.org/en/latest/>`_
:Dev:    `ldapcherry code on GitHub <https://github.com/kakwa/ldapcherry>`_
:PyPI:   `ldapcherry package on Pypi <http://pypi.python.org/pypi/ldapcherry>`_
:License: MIT
:Author:  Pierre-Francois Carpentier - copyright © 2015

----

****************
  Presentation
****************

LdapCherry is CherryPY application to manage users and groups in multiple directory services.

It's main features are:

* manage multiple directories/databases backends in an unified way
* roles management (as in "groups of groups")
* autofill forms
* password policy
* self modification of some selected fields by normal (non administrator) users
* nice bootstrap interface
* modular through pluggable authentication, password policy and backend modules

LdapCherry is not limited to ldap, it can handle virtually any user backend (ex: SQL database, htpasswd file, etc)
through the proper plugin (provided that it is implemented ^^).

LdapCherry also aims to be as simple as possible to deploy: no crazy dependencies, 
few configuration files, extensive debug logs and full documentation.

**************
  Screenshot
**************

.. raw:: html

    <style>
    #images {
      width: 800px;
      height: 600px;
      overflow: hidden;
      position: relative;
      
      margin: 20px auto;
    }
    #images img {
      width: 800px;
      height: 600px;
      
      position: absolute;
      top: 0;
      left: -400px;
      z-index: 1;
      opacity: 0;
      
      transition: all linear 500ms;
      -o-transition: all linear 500ms;
      -moz-transition: all linear 500ms;
      -webkit-transition: all linear 500ms;
    }
    #images img:target {
      left: 0;
      z-index: 9;
      opacity: 1;
    }
    #images img:first-child {
      left: 0;
      opacity: 1;
    }
    #slider {
      text-align: center;
    }
    #slider a {
      text-decoration: none;
      background: #E3F1FA;
      border: 1px solid #C6E4F2;
      padding: 4px 6px;
      color: #222;
      margin: 20px auto;
    }
    #slider a:hover {
        background: #C6E4F2;
    }
    </style>
    <div id="images">
        <img id="image1" src='https://raw.githubusercontent.com/kakwa/ldapcherry/master/docs/assets/sc/2015-07-06-093051_1438x1064_scrot.png' />
        <img id="image2" src='https://raw.githubusercontent.com/kakwa/ldapcherry/master/docs/assets/sc/2015-07-06-093130_1438x1064_scrot.png' />
        <img id="image3" src='https://raw.githubusercontent.com/kakwa/ldapcherry/master/docs/assets/sc/2015-07-06-093147_1438x1064_scrot.png' />
        <img id="image4" src='https://raw.githubusercontent.com/kakwa/ldapcherry/master/docs/assets/sc/2015-07-06-093152_1438x1064_scrot.png' />
        <img id="image5" src='https://raw.githubusercontent.com/kakwa/ldapcherry/master/docs/assets/sc/2015-07-06-093215_1438x1064_scrot.png' />
        <img id="image6" src='https://raw.githubusercontent.com/kakwa/ldapcherry/master/docs/assets/sc/2015-07-06-093234_1438x1064_scrot.png' />
    </div>
    <div id="slider">
        <a href="#image1">1</a>
        <a href="#image2">2</a>
        <a href="#image3">3</a>
        <a href="#image4">4</a>
        <a href="#image5">5</a>
        <a href="#image6">6</a>
    </div>

`Screenshots <http://ldapcherry.readthedocs.org/en/latest/#image1>`_

***********
  License
***********

LdapCherry is published under the MIT Public License.

*******************************
  Discussion / Help / Updates
*******************************

* IRC: `Freenode <http://freenode.net/>`_ ``#ldapcherry`` channel
* Bugtracker: `Github <https://github.com/kakwa/ldapcherry/issues>`_

----

.. image:: docs/assets/python-powered.png
.. image:: docs/assets/cherrypy.png