doc/book/en/devrepo/repo/sessions.rst
branchstable
changeset 6298 f4347f796908
parent 5394 105011657405
child 6311 afd6a9e45489
equal deleted inserted replaced
6297:23c1e50ff97b 6298:f4347f796908
     1 .. -*- coding: utf-8 -*-
     1 .. -*- coding: utf-8 -*-
     2 
     2 
     3 Sessions
     3 Sessions
     4 ========
     4 ========
     5 
     5 
     6 There are three kinds of sessions.
     6 There are two 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 
       
    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 
    10 
    16 * `internal sessions` have all the powers; they are also used in only a
    11 * `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
    12   few situations where you don't already have an adequate session at
    18   hand, like: user authentication, data synchronisation in
    13   hand, like: user authentication, data synchronisation in
    19   multi-source contexts
    14   multi-source contexts