diff --git a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/add-fido-login-with-visual-editor.png b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/add-fido-login-with-visual-editor.png index 3642aea555..9978649b51 100644 Binary files a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/add-fido-login-with-visual-editor.png and b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/add-fido-login-with-visual-editor.png differ diff --git a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/add-fido-login.png b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/add-fido-login.png index 25a60196ea..e734e7577f 100644 Binary files a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/add-fido-login.png and b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/add-fido-login.png differ diff --git a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/fido-login-step.png b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/fido-login-step.png index 40bbe84c7e..b402bede02 100644 Binary files a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/fido-login-step.png and b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/fido-login-step.png differ diff --git a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/fido2-passkey-login-page.png b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/fido2-passkey-login-page.png new file mode 100644 index 0000000000..60defcbd73 Binary files /dev/null and b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/fido2-passkey-login-page.png differ diff --git a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/sign-in-with-security-key-page.png b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/sign-in-with-security-key-page.png index 93f0ace0c8..2355251c40 100644 Binary files a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/sign-in-with-security-key-page.png and b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/sign-in-with-security-key-page.png differ diff --git a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/sign-in-with-security-key.png b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/sign-in-with-security-key.png index 05b8bf7ccc..ae90fc648f 100644 Binary files a/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/sign-in-with-security-key.png and b/en/identity-server/next/docs/assets/img/guides/passwordless/fido2/sign-in-with-security-key.png differ diff --git a/en/identity-server/next/mkdocs.yml b/en/identity-server/next/mkdocs.yml index 59ddaeec35..4d0eaf9674 100644 --- a/en/identity-server/next/mkdocs.yml +++ b/en/identity-server/next/mkdocs.yml @@ -116,7 +116,7 @@ nav: - Add passwordless login: - Add passwordless login: guides/authentication/passwordless-login/index.md - Add login with Magic link: guides/authentication/passwordless-login/add-passwordless-login-with-magic-link.md - - Add login with FIDO2: guides/authentication/passwordless-login/add-passwordless-login-with-fido.md + - Add login with Passkey: guides/authentication/passwordless-login/add-passwordless-login-with-fido.md - Add login with HYPR: guides/authentication/passwordless-login/add-passwordless-login-with-hypr.md - Add login with Email OTP: guides/authentication/passwordless-login/add-passwordless-login-with-email-otp.md - Enable user attributes: diff --git a/en/includes/guides/authentication/passwordless-login/add-passwordless-login-with-fido.md b/en/includes/guides/authentication/passwordless-login/add-passwordless-login-with-fido.md index 0abc1abb6c..578dd98c7e 100644 --- a/en/includes/guides/authentication/passwordless-login/add-passwordless-login-with-fido.md +++ b/en/includes/guides/authentication/passwordless-login/add-passwordless-login-with-fido.md @@ -1,14 +1,14 @@ -# Add FIDO2 login +# Add Passkey login -FIDO2 adds passwordless login to your applications, which allows users to replace traditional passwords with FIDO2-supported hardware security keys or built-in authenticators on their devices. +Passkey adds passwordless login to your applications, which allows users to replace traditional passwords with FIDO2-supported hardware security keys or built-in authenticators on their devices. There are two types of authenticators that you can use with FIDO2 passwordless authentication in {{ product_name }}. -- **Platform authenticators** (also known as `internal` authenticators): Authenticators like fingerprint scanners, TouchID, FaceID or Windows Hello which are bound to a particular device. +- **Platform authenticators** (also known as `internal` authenticators): Authenticators like fingerprint scanners, TouchID, FaceID, or Windows Hello which are bound to a particular device. - **Roaming authenticators** (also known as `cross-platform` or `external` authenticators): Authenticators like hardware security keys which are external and not bound to any specific device. !!! note "What is FIDO2?" - The FIDO Alliance, whose mission is to reduce the world's reliance on passwords, introduced its latest specifications, collectively called FIDO2. FIDO2 specifications are the World Wide Web Consortium's (W3C) Web Authentication specification (WebAuthn) and FIDO alliance's corresponding Client to Authenticator Protocol (CTAP). + The FIDO Alliance, whose mission is to reduce the world's reliance on passwords, introduced its latest specifications, collectively called FIDO2. FIDO2 specifications are the World Wide Web Consortium's (W3C) Web Authentication specification (WebAuthn) and the FIDO alliance's corresponding Client to Authenticator Protocol (CTAP). ## Prerequisites @@ -22,29 +22,29 @@ Follow the steps given below to enable **passwordless** login for your applicati 1. On the {{ product_name }} Console, go to **Applications**. -2. Select the application to which you wish to add FIDO login. +2. Select the application to which you wish to add Passkey login. -3. Go to the **Sign-in Method** tab of the application and add FIDO login from your preferred editor: +3. Go to the **Sign-in Method** tab of the application and add Passkey login from your preferred editor: --- === "Classic Editor" - - If you haven't already built a login flow for your application, select **FIDO2** to build one. + - If you haven't already built a login flow for your application, select **Add Passkey Login** to build one. ![Configuring fido2 login in {{ product_name }}]({{base_path}}/assets/img/guides/passwordless/fido2/add-fido-login.png){: width="600" style="display: block; margin: 0 auto; border: 0.3px solid lightgrey;"} - - If you have an already built login flow, you can add FIDO2 as an additional authenticator for the first step. + - If you have an already built login flow, you can add Passkey as an additional authenticator for the first step. ![Customize the login flow]({{base_path}}/assets/img/guides/passwordless/fido2/fido-login-step.png){: style="display: block; margin: 0 auto; border: 0.3px solid lightgrey;"} === "Visual Editor" - To add passwordless login with FIDO using the Visual Editor: + To add passwordless login with Passkey using the Visual Editor: 1. Switch to the **Visual Editor** tab and go to **Predefined Flows** > **Basic Flows** > **Add Passwordless login**. - 2. Select `Username & Password + FIDO2`. + 2. Select `Username & Password + Passkey`. - 3. Click **Confirm** to add passwordless login with FIDO to the sign-in flow. + 3. Click **Confirm** to add passwordless login with Passkey to the sign-in flow. ![Configuring fido2 login in Asgardeo using the Visual Editor]({{base_path}}/assets/img/guides/passwordless/fido2/add-fido-login-with-visual-editor.png){: style="display: block; margin: 0 auto; border: 0.3px solid lightgrey;"} @@ -62,7 +62,7 @@ Passkeys resolve this issue by allowing FIDO2 credentials to sync across multipl - If you are an Apple user, your passkeys will be synced across all the devices signed into the same Apple ID and iCloud Keychain. Refer to the [Apple documentation](https://developer.apple.com/passkeys/) for more information. -- If you are an Android user, your passkeys will be synced across all the devices signed into your Google account. Refer to the [Google documentation](https://developers.google.com/identity/passkeys) for more information. +- If you are an Android user, your passkeys will be synced across all the devices signed into your Google account. Refer to the [Google documentation](https://developers.google.com/identity/passkeys) for more information. **If your devices do not sync through the cloud**, you can use your device with passkeys to scan a QR code generated in the device from which you are trying to log in. @@ -73,15 +73,15 @@ Refer to the [passkeys documentation](https://passkeys.dev/device-support/) to s ## Try it out !!! note - - FIDO2 passwordless login with platform authenticators will NOT work on the Firefox browser in macOS Catalina, Big Sur and Monterey due to browser limitations. - - FIDO2 passwordless login with roaming authenticators will NOT work on the Firefox browser as the browser doesn't support CTAP2 (Client to Authenticator Protocol 2) with PIN. + - Passkey login with platform authenticators will NOT work on the Firefox browser in macOS Catalina, Big Sur, and Monterey due to browser limitations. + - Passkey login with roaming authenticators will NOT work on the Firefox browser as the browser doesn't support CTAP2 (Client to Authenticator Protocol 2) with PIN. 1. Access the application URL. 2. Click **Login** to open the {{ product_name }} login page. -3. On the {{ product_name }} login page, click **Sign In With Security Key**. You will be redirected to the FIDO2 login page. +3. On the {{ product_name }} login page, click **Sign In With Passkey**. You will be redirected to the Passkey login page. - ![Sign In With Security Key in {{ product_name }}]({{base_path}}/assets/img/guides/passwordless/fido2/sign-in-with-security-key.png){: width="300" style="border: 0.3px solid lightgrey;"} + ![Sign In With Passkey login in {{ product_name }}]({{base_path}}/assets/img/guides/passwordless/fido2/sign-in-with-security-key.png){: width="300" style="border: 0.3px solid lightgrey;"} 4. Follow the instructions given by your browser or device to login. - ![Sign In With Security Key page in {{ product_name }}]({{base_path}}/assets/img/guides/passwordless/fido2/sign-in-with-security-key-page.png){: width="300" style="border: 0.3px solid lightgrey;"} \ No newline at end of file + ![Sign In With Passkey login page in {{ product_name }}]({{base_path}}/assets/img/guides/passwordless/fido2/fido2-passkey-login-page.png){: width="300" style="border: 0.3px solid lightgrey;"} \ No newline at end of file