Passkeys
Passkey sign-in and enrolment on the hosted login, and passkeys as a second factor.
Users can sign in with a passkey (WebAuthn discoverable credentials) on the hosted login. A passkey also counts as a second factor.
- Sign-in: the hosted page offers passkeys when the environment enables the
passkeymethod. The browser shows the user’s passkeys for your login host. - Enrolment during sign-in: a user without a second factor can add a passkey instead of an authenticator app when MFA is required; that sign-in then completes with MFA.
- Account page: users add and remove passkeys at the account page. A user who already has a factor adds another only after a sign-in in the last 10 minutes that passed a second factor (
step_up_requiredotherwise), the same as removing one. - Rename: users rename a passkey on the account page (
POST /); your server useslogin/ <environment> / api/ factors/ {factor}/ rename PATCH /with av1/ users/ {user}/ passkeys/ {passkey} nameof 1 to 64 characters. Authenticator apps and other users’ passkeys answerresource_not_found. - Your server:
GET /lists a user’s passkeys and authenticator apps;v1/ users/ {user}/ factors DELETE /removes one.v1/ users/ {user}/ factors/ {factor}
The relying party ID is the sign-in host (signin.ohauthcat.com), shared by every environment; each credential still belongs to one environment’s user.
Native apps
Section titled “Native apps”Native apps can use the hosted login in the system browser, or run the passkey ceremony themselves with the platform’s passkey prompt. For the second, list the app in the environment’s native_app_origins in PUT /:
- Android:
android:, the origin Android sends for your signed app;apk-key-hash: <hash> - iOS:
ios:. iOS apps send the sign-in origin, so the sign-in host must list the app in its web credentials association.<team ID> . <bundle ID>
An origin in any other form answers native_origin_invalid. Your server then calls the headless routes with its secret key:
POST /andv1/ users/ {user}/ passkeys/ registration_options POST /to add a passkey;v1/ users/ {user}/ passkeys POST /andv1/ user_management/ passkeys/ authentication_options POST /to verify one.v1/ user_management/ passkeys/ authenticate
Options expire after 5 minutes. A headless authentication confirms the user. To also start a session, send session: true with client_id (a live publishable key of the environment): the answer then carries access_token, refresh_token, id_token, token_type, expires_in and session_id, issued by the login host for that client. When MFA is required and the passkey was not user-verified, it answers mfa_required.
App-link files
Section titled “App-link files”The sign-in host serves / (webcredentials for every ios: origin in native_app_origins) and / (get_login_creds for every entry of android_apps). Set android_apps in PUT / as a list of {package_name, apk_key_hash}; each hash must also be listed in native_app_origins as android:. Changes reach the files within about five minutes. The iOS and Android SDKs explain how to plug in native passkey prompts.