1 .. -*- coding: utf-8 -*-

     2 

     3 Sessions

     4 ========

     5 

     6 There are three kinds of sessions.

     7 

     8 * `user sessions` are the most common: they are related to users and

     9   carry security checks coming with user credentials

    10 

    11 * `super sessions` are children of ordinary user sessions and allow to

    12   bypass security checks (they are created by calling unsafe_execute

    13   on a user session); this is often convenient in hooks which may

    14   touch data that is not directly updatable by users

    15 

    16 * `internal sessions` have all the powers; they are also used in only a

    17   few situations where you don't already have an adequate session at

    18   hand, like: user authentication, data synchronisation in

    19   multi-source contexts

    20 

    21 .. note::

    22   Do not confuse the session type with their connection mode, for

    23   instance : 'in memory' or 'pyro'.

    24 

    25 [WRITE ME]

    26 

    27 * authentication and management of sessions