Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: add documentation for password change feature #1711

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 13 additions & 6 deletions content/en/building/concepts/access.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,19 @@ Users may log out by going to the options menu available in the top right corner

{{< figure src="login-mobile.png" link="login-mobile.png" class="left col-3 col-lg-3" >}}

{{< figure src="login-desktop.png" link="login-desktop.png" class="left col-9 col-lg-9" >}}
{{< figure src="login-desktop.png" link="login-desktop.png" class="right col-8 col-lg-8" >}}

### Password reset on first login

Added in 4.16.0.
latin-panda marked this conversation as resolved.
Show resolved Hide resolved

To enhance the security of CHT applicationsI, users logging in for the first time are encouraged to change the password provided by the system administrator to their own strong password.
latin-panda marked this conversation as resolved.
Show resolved Hide resolved

{{< figure src="password-change.png" link="password-change.png" class="col-12 col-lg-12" >}}

This feature will be enabled by default because it encourages best practices. However, only new users will be prompted to go through this flow or those users which the system administration has reset their password. Projects can disable this feature by enabling the can_skip_password_change permission.
latin-panda marked this conversation as resolved.
Show resolved Hide resolved

Subsequent logins won’t require a password change – if the app closes before changing the password, the user will be prompted again when they reopen it. If a user is unable to update their password they won’t be able to access the app.
latin-panda marked this conversation as resolved.
Show resolved Hide resolved


## Magic Links for Logging In (Token Login)
Expand All @@ -79,8 +91,3 @@ With token login, the password is never known by the admin or the user because t
{{% alert title="Note" %}}
The magic link workflow will not work for users who want to use multiple devices or for multiple users on one device.
{{% /alert %}}





Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading