-
Notifications
You must be signed in to change notification settings - Fork 382
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat: document two-step registration (#1694)
* feat: document two-step registration * fix: add passkey console screenshot
- Loading branch information
Showing
5 changed files
with
44 additions
and
5 deletions.
There are no files selected for viewing
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,33 @@ | ||
--- | ||
id: two-step-registration | ||
title: Two-step registration | ||
sidebar_label: Two-step registration | ||
slug: two-step-registration | ||
--- | ||
|
||
With a one-step registration, when you enable multiple authentication strategies (for example password, code via email, and | ||
passkey), the identity traits will be repeated for each authentication strategy. | ||
|
||
Compare this to a two-step registration: Now, the user is prompted for the identity traits in the first step, and asked to choose | ||
a credential method for authentication next. This results in a more stream-lined user experience. | ||
|
||
:::info | ||
|
||
Identity traits are data associated with an identity that can be modified by the user. The traits are configured through the | ||
identity schema. | ||
|
||
[Learn more about identity traits](../../kratos/manage-identities/managing-users-identities-metadata#traits) | ||
|
||
::: | ||
|
||
![Registration with two-step registration vs one-step registration](./_static/two-step-registration.png) | ||
|
||
To disable the legacy one-step registration, go to https://console.ory.sh/projects/current/authentication and switch off "Enable | ||
legacy one-step registration" or use the Ory CLI: | ||
|
||
```bash | ||
ory list projects # to get the project id | ||
|
||
ory patch project ${project_id} \ | ||
--replace '/services/identity/config/selfservice/flows/registration/enable_legacy_one_step=false' | ||
``` |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -46,14 +46,19 @@ login. Here is a comparison of the two approaches: | |
|
||
### Configuration | ||
|
||
:::info | ||
By default, the passkey strategy is disabled. You can enable it in the Ory Console by going to | ||
[https://console.ory.sh/projects/current/passwordless](https://console.ory.sh/projects/current/passwordless) and toggling the | ||
switch for "Enable Passkey authentication". | ||
|
||
This feature is in preview. Please report any issues to [email protected] or contact us in the | ||
[Ory Community](https://slack.ory.sh/). | ||
```mdx-code-block | ||
<BrowserWindow url="https://console.ory.sh/projects/current/passwordless"> | ||
::: | ||
![Passkey in Console](../_static/passkeys/console.png) | ||
</BrowserWindow> | ||
``` | ||
|
||
By default, the passkey strategy is disabled. To start using the passkey strategy, apply this configuration: | ||
Alternatively, use the Ory CLI to enable the passkey strategy: | ||
|
||
```mdx-code-block | ||
import CodeBlock from '@theme/CodeBlock' | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters