summaryrefslogtreecommitdiff
path: root/doc/source/configuration/settings.rst
diff options
context:
space:
mode:
authorAdrian Turjak <adriant@catalyst.net.nz>2018-07-11 16:33:31 +1200
committerAkihiro Motoki <amotoki@gmail.com>2018-12-23 09:33:49 +0900
commitdc0ffaf2d80f77a90d6f98e6dcad08e7901f68df (patch)
treee84c6cc6c8a342467821790775697e1f9eda6716 /doc/source/configuration/settings.rst
parent06ab7a5047d0c151830c1c902aea1e80272b71f9 (diff)
downloadhorizon-dc0ffaf2d80f77a90d6f98e6dcad08e7901f68df.tar.gz
Change session timeout to an idle timeout value
Add a new config SESSION_REFRESH (default True) which turns SESSION_TIMEOUT into an idle timeout rather than a hard timeout. The existing hard timeout is awful UX, and while SESSION_TIMEOUT could be set to a higher value, it still makes for a somewhat unpleasant experience. Co-Authored-By: Akihiro Motoki <amotoki@gmail.com> Change-Id: Icc6942e62c4e8d2fac57988b0a2233a8073b1944
Diffstat (limited to 'doc/source/configuration/settings.rst')
-rw-r--r--doc/source/configuration/settings.rst21
1 files changed, 18 insertions, 3 deletions
diff --git a/doc/source/configuration/settings.rst b/doc/source/configuration/settings.rst
index 7e28a7660..253e4f857 100644
--- a/doc/source/configuration/settings.rst
+++ b/doc/source/configuration/settings.rst
@@ -798,6 +798,16 @@ in `AVAILABLE_THEMES`_, but a brander may wish to simply inherit from an
existing theme and not allow that parent theme to be selected by the user.
``SELECTABLE_THEMES`` takes the exact same format as ``AVAILABLE_THEMES``.
+SESSION_REFRESH
+---------------
+
+.. versionadded:: 15.0.0(Stein)
+
+Default: ``True``
+
+Control whether the SESSION_TIMEOUT period is refreshed due to activity. If
+False, SESSION_TIMEOUT acts as a hard limit.
+
SESSION_TIMEOUT
---------------
@@ -805,9 +815,14 @@ SESSION_TIMEOUT
Default: ``"3600"``
-This SESSION_TIMEOUT is a method to supercede the token timeout with a shorter
-horizon session timeout (in seconds). So if your token expires in 60 minutes,
-a value of 1800 will log users out after 30 minutes.
+This SESSION_TIMEOUT is a method to supercede the token timeout with a
+shorter horizon session timeout (in seconds). If SESSION_REFRESH is True (the
+default) SESSION_TIMEOUT acts like an idle timeout rather than being a hard
+limit, but will never exceed the token expiry. If your token expires in 60
+minutes, a value of 1800 will log users out after 30 minutes of inactivity,
+or 60 minutes with activity. Setting SESSION_REFRESH to False will make
+SESSION_TIMEOUT act like a hard limit on session times.
+
MEMOIZED_MAX_SIZE_DEFAULT
-------------------------