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

docs: add explanation for sign-in methods #586

Merged
merged 1 commit into from
Jan 3, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
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
49 changes: 49 additions & 0 deletions docs/application/signin-methods.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
---
title: Signin Methods
description: Configure the login method and the display order of the login methods
keywords: [signin, method]
authors: [HGZ-20]
---

On the Application Configuration page, we can configure the sign-in item table. We can add and remove sign-in items from the table.

![Signin Methods](/img/application/signin-methods/signin-methods.png)

For a detailed explanation of each sign-in item, please refer to the table below. Currently, only `Password`, `verification code` and `WebAuthn` login methods are available.

| Column Name | Selectable Value | Description |
|:-----------:|:----------------:|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Name | - | The name of the sign-in method. |
| DisplayName | - | The name which the sign-in method displays to the public. |
| Rule | `Rule Items` | Select a rule to customize this sign-in method. Detailed rules are described in the table below. |
| Action | - | Users can perform actions such as moving this sign-in method up, moving it down, or deleting it. |

Currently, only the `Verification code` sign-in method supports configuration rules.

| Sign-in Method Name | Selectable Rules | Description |
|:-------------------:|:------------------------------------------:|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Verification code | `All(default)`/ `Email only` / `Phone only` | Select the sign-in methods available to the user. Choosing `All` , then both email and phone numbers can be verified for sign-in. Choosing `Email only` , then only eamil login is allowed. Choosing `Phone only`, then only the phone number is allowed to authenticate the login. |

:::note

For example, we want users to prioritize logging in with their email, and then consider logging in with a password if they can't use their email.

:::

First, we configure two login options, `Verification Code` and `Password`, and `Verification Code` is the first login option. Then we change the `verification code` rule to `Email only`, so that the user can only receive the login verification code by email.

![Signin Methods](/img/application/signin-methods/signin-methods-demo-config.png)

To make it easier for users to understand, we can change the display name of the `Verification code` login method so that users can easily understand that it is an email login.

![Signin Methods](/img/application/signin-methods/signin-methods-demo-page.png)

:::tip

All sign-in methods will be added by default, it is required that at least one sign-in method be added.

:::

Here is a video of how the sign-in method works:

<video src="/video/application/signin-methods-demo.mp4" controls="controls" width="100%"></video>
1 change: 1 addition & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -122,6 +122,7 @@ module.exports = {
"application/overview",
"application/terminology",
"application/config",
"application/signin-methods",
"application/signup-items-table",
"application/ui-customization",
"application/specify-login-organization",
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/video/application/signin-methods-demo.mp4
Binary file not shown.
Loading