A cloud-based identity and access management service for securing user authentication and resource access
Hey there! It looks like your users are hitting the generic “Passkey not registered” error during self-service setup—which usually means something in the FIDO2 / passkey policy or their client environment isn’t lining up. Here’s a quick playbook you can run through:
- Verify policy configuration • In the Entra admin center under Authentication methods > Policies, make sure “Passkey (FIDO2)” is Enabled and “Allow self-service setup” is set to Yes. • If you’re using the Microsoft Authenticator passkey preview, ensure you’ve enabled that sub-option in the same FIDO2 policy, keep attestation turned Off (preview doesn’t yet support full attestation), and don’t enforce key restrictions unless you’ve explicitly added the Authenticator AAGUIDs.
- Check Conditional Access (CA) / authentication strength scope • CA policies that require phishing-resistant MFA can inadvertently block passkey registration. Confirm you’re not targeting that CA at the registration endpoint—CA should guard sign-in, not the “Add security info” flow. • If you must enforce phishing-resistant auth for registration, test by temporarily disabling “Require attestation” or remove the CA requirement to see if registration succeeds.
- Confirm user flow prerequisites • Users must complete an MFA challenge (or use a Temporary Access Pass) within the same browser session before adding a passkey. • Make sure they’re not in private/incognito mode, have a stable Internet connection, and (for cross-device flows) Bluetooth is on.
- Validate client support • Devices must meet OS/browser requirements: Android 14+, iOS 17+ or Windows 10 1903+. • Browsers need WebAuthn support (Edge, Chrome, Safari latest).
- Clean up orphaned or local-only passkeys • If a registration spun up a local passkey in Authenticator but never made it to the server, users should delete it from the Authenticator app and from My Security Info before retrying.
- Gather logs & error codes • Have the user reproduce the error and capture the browser console or FIDO status. • Review Azure sign-in logs for any FIDO2-related error codes or conditional access insights.
Reference docs:
- Enable passkeys (FIDO2) for your organization: https://learn.microsoft.com/entra/identity/authentication/how-to-enable-passkey-fido2
- Register a passkey (FIDO2): https://learn.microsoft.com/entra/identity/authentication/how-to-register-passkey
- Enable passkeys in Authenticator: https://learn.microsoft.com/entra/identity/authentication/how-to-enable-authenticator-passkey
- Troubleshoot passkey sign-in issues: https://learn.microsoft.com/entra/identity/authentication/how-to-sign-in-passkey
- MFA registration troubleshooting: https://learn.microsoft.com/azure/active-directory/authentication/how-to-authentication-methods-manage