Cloudflare Access supports passkeys as a login method. Users can sign in with a passkey instead of entering a password or one-time PIN (OTP).
Passkeys use WebAuthn to authenticate users with a device, security key, or password manager. The authenticator must support discoverable credentials and user verification, such as a fingerprint, face scan, or PIN.
If Passkeys is already listed under Identity providers, select it to review its settings. Otherwise, add it:
-
In the Cloudflare dashboard ↗︎, go to Zero Trust > Integrations > Identity providers.
Go to Identity providers ↗ -
Select Add an identity provider.
-
Select Passkeys.
-
(Optional) Turn on Automatically prompt on the login page to open the browser's passkey prompt for returning users when they open the login page.
-
Select Save.
Send a POST request to the Identity Providers endpoint with type set to passkeys. Use an API token with Access: Organizations, Identity Providers, and Groups Write permission.
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/access/identity_providers" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"name": "Passkeys",
"type": "passkeys",
"config": {
"login_page_auto_prompt": false
}
}'Set config.login_page_auto_prompt to true to turn on automatic browser prompts for returning passkey users.
After adding the provider, allow it in your application's login methods.
-
Go to Access controls > Applications.
Go to Applications ↗ -
Find your application, open its menu, and select Edit.
-
Select Login methods to find the application's authentication settings.
-
If Accept all available identity providers is turned off, add Passkeys under Choose available identity providers for this application. Keep any other login methods that users need.
-
Select Save.
For the App Launcher, allow Passkeys on its Authentication tab.
Passkey enrollment and sign-in do not grant access by themselves. Users must still match an Access policy. Passkey authentication does not retrieve group memberships or custom attributes from another identity provider. Review policies that depend on those attributes before adding passkeys as an alternative login method.
Before enrolling, users need a compatible browser and passkey authenticator.
- Open an application that allows passkey authentication.
- On the Access login page, select Sign in with a passkey, then Don't have a passkey? Set one up.
- Verify your identity using an available login method. If passkeys are the application's only login method, Access sends a verification code to your email address during enrollment.
- Enter a name for the passkey and select Add passkey.
- Follow your browser or operating system's prompts to save the passkey.
- When setup finishes, select Back to sign in.
- Open an application that allows passkey authentication.
- On the Access login page, select Sign in with a passkey.
- Choose a saved passkey and complete your authenticator's verification prompt.
After verifying the passkey, Access evaluates your application's policies. You do not need to enter your email address to sign in with a passkey.
If automatic browser prompts are turned on, Access can start the passkey prompt for returning users. Users can cancel the prompt and choose another allowed login method. Supported browsers can also offer saved passkeys in the email field.
Users can add, rename, or delete their own passkeys.
- On the Access login page, select Manage passkeys.
- Authenticate using an available login method.
- On the management page, select Add passkey, Rename passkey, or Delete passkey. Confirm the change when prompted.
Administrators can remove a passkey if a device is lost or a user needs to enroll again.
-
In the Cloudflare dashboard, go to Zero Trust > Team & Resources > Users.
Go to Users ↗ -
Select the user and open User identity.
-
In Passkeys, open the passkey's menu and select Delete.
-
Confirm that you want to remove the passkey.
You can also delete a user's passkey through the API.
Deleting a registered passkey prevents Access from accepting it for future sign-ins. To end a user's active Access sessions, revoke their sessions.
If a saved passkey does not appear, check that it is available on the device or in the password manager you are using. Follow your browser's prompts to use a passkey from another device, if supported.
If you cannot use a registered passkey, choose another allowed login method or contact your administrator. To replace it, follow Enroll a passkey.