website/docs: add additional docs

Signed-off-by: Jens Langhammer <jens.langhammer@beryju.org>

web/src/locales/en.po

@@ -21,10 +21,13 @@ msgstr ""
 #: src/pages/providers/oauth2/OAuth2ProviderForm.ts
 #: src/pages/providers/proxy/ProxyProviderForm.ts
 #: src/pages/providers/saml/SAMLProviderForm.ts
-#: src/pages/stages/user_login/UserLoginStageForm.ts
 msgid "(Format: hours=-1;minutes=-2;seconds=-3)."
 msgstr "(Format: hours=-1;minutes=-2;seconds=-3)."
 
+#: src/pages/stages/user_login/UserLoginStageForm.ts
+msgid "(Format: hours=1;minutes=2;seconds=3)."
+msgstr "(Format: hours=1;minutes=2;seconds=3)."
+
 #: src/elements/events/ObjectChangelog.ts
 #: src/elements/events/UserEvents.ts
 #: src/elements/user/SessionList.ts

web/src/locales/fr_FR.po

@@ -27,10 +27,13 @@ msgstr ""
 #: src/pages/providers/oauth2/OAuth2ProviderForm.ts
 #: src/pages/providers/proxy/ProxyProviderForm.ts
 #: src/pages/providers/saml/SAMLProviderForm.ts
-#: src/pages/stages/user_login/UserLoginStageForm.ts
 msgid "(Format: hours=-1;minutes=-2;seconds=-3)."
 msgstr "(Format : heures=-1;minutes=-2;seconds=-3)"
 
+#: src/pages/stages/user_login/UserLoginStageForm.ts
+msgid "(Format: hours=1;minutes=2;seconds=3)."
+msgstr ""
+
 #: src/elements/events/ObjectChangelog.ts
 #: src/elements/events/UserEvents.ts
 #: src/elements/user/SessionList.ts

web/src/locales/pseudo-LOCALE.po

@@ -21,10 +21,13 @@ msgstr ""
 #: src/pages/providers/oauth2/OAuth2ProviderForm.ts
 #: src/pages/providers/proxy/ProxyProviderForm.ts
 #: src/pages/providers/saml/SAMLProviderForm.ts
-#: src/pages/stages/user_login/UserLoginStageForm.ts
 msgid "(Format: hours=-1;minutes=-2;seconds=-3)."
 msgstr ""
 
+#: src/pages/stages/user_login/UserLoginStageForm.ts
+msgid "(Format: hours=1;minutes=2;seconds=3)."
+msgstr ""
+
 #: src/elements/events/ObjectChangelog.ts
 #: src/elements/events/UserEvents.ts
 #: src/elements/user/SessionList.ts

web/src/pages/stages/user_login/UserLoginStageForm.ts

@@ -69,7 +69,7 @@ export class UserLoginStageForm extends ModelForm<UserLoginStage, string> {
                             ${t`Determines how long a session lasts. Default of 0 seconds means that the sessions lasts until the browser is closed.`}
                         </p>
                         <p class="pf-c-form__helper-text">
-                            ${t`(Format: hours=-1;minutes=-2;seconds=-3).`}
+                            ${t`(Format: hours=1;minutes=2;seconds=3).`}
                         </p>
                     </ak-form-element-horizontal>
                 </div>

website/docs/flow/stages/user_login.md

@@ -5,3 +5,19 @@ title: User login stage
 This stage attaches a currently pending user to the current session.
 
 It can be used after `user_write` during an enrollment flow, or after a `password` stage during an authentication flow.
+
+## Session duration
+
+By default, the authentik session expires when you close your browser (*seconds=0*).
+
+You can set the session to expire after any duration using the syntax of `hours=1,minutes=2,seconds=3`. The following keys are allowed:
+
+- Microseconds
+- Milliseconds
+- Seconds
+- Minutes
+- Hours
+- Days
+- Weeks
+
+All values accept floating-point values.

website/docs/flow/stages/user_write.md

@@ -3,3 +3,5 @@ title: User write stage
 ---
 
 This stages writes data from the current context to the current pending user. If no user is pending, a new one is created.
+
+Newly created users can be created as inactive and can be assigned to a selected group.