doc/book/en/development/devrepo/sessions.rst
changeset 2539 0f26a76b0348
parent 2112 df86450ca65d
equal deleted inserted replaced
2538:6f8ffaa2a700 2539:0f26a76b0348
     3 Sessions
     3 Sessions
     4 ========
     4 ========
     5 
     5 
     6 There are three kinds of sessions.
     6 There are three kinds of sessions.
     7 
     7 
     8 * user sessions are the most common: they are related to users and
     8 * `user sessions` are the most common: they are related to users and
     9   carry security checks coming with user credentials
     9   carry security checks coming with user credentials
    10 
    10 
    11 * super sessions are children of ordinary user sessions and allow to
    11 * `super sessions` are children of ordinary user sessions and allow to
    12   bypass security checks (they are created by calling unsafe_execute
    12   bypass security checks (they are created by calling unsafe_execute
    13   on a user session); this is often convenient in hooks which may
    13   on a user session); this is often convenient in hooks which may
    14   touch data that is not directly updatable by users
    14   touch data that is not directly updatable by users
    15 
    15 
    16 * internal sessions have all the powers; they are also used in only a
    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
    17   few situations where you don't already have an adequate session at
    18   hand, like: user authentication, data synchronisation in
    18   hand, like: user authentication, data synchronisation in
    19   multi-source contexts
    19   multi-source contexts
    20 
    20 
    21 Do not confuse the session type with their connection mode, for
    21 .. note::
    22 instance : 'in memory' or 'pyro'.
    22   Do not confuse the session type with their connection mode, for
       
    23   instance : 'in memory' or 'pyro'.
    23 
    24 
    24 [WRITE ME]
    25 [WRITE ME]
    25 
    26 
    26 * authentication and management of sessions
    27 * authentication and management of sessions