Documentation Index
Fetch the complete documentation index at: https://docs.steward.fi/llms.txt
Use this file to discover all available pages before exploring further.
Passkeys (WebAuthn)
Passkeys use the WebAuthn standard for phishing-resistant, passwordless authentication. Users sign in with a fingerprint, Face ID, or hardware security key. No passwords to forget or leak.How It Works
Steward’s passkey flow is smart: it tries login first, and if the user doesn’t have a passkey registered, automatically falls back to registration.SDK Usage
React Usage
The<StewardLogin> component includes passkey support by default:
Peer Dependency
The SDK dynamically imports@simplewebauthn/browser for the WebAuthn ceremony. Install it as a peer dependency:
signInWithPasskey throws a clear error message.
Server Configuration
To enable passkeys on your self-hosted Steward instance, set these environment variables:PASSKEY_RP_ID must match the domain where your app is served. For local development, use localhost and set PASSKEY_ORIGIN=http://localhost:3000.API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/auth/passkey/login/options | POST | Get WebAuthn authentication options for an existing user |
/auth/passkey/login/verify | POST | Verify a WebAuthn authentication response |
/auth/passkey/register/options | POST | Get WebAuthn registration options for a new user |
/auth/passkey/register/verify | POST | Verify a WebAuthn registration response |
{ email, tenantId? } in the request body.
Browser Support
Passkeys are supported in all modern browsers:- Chrome 67+
- Safari 14+
- Firefox 60+
- Edge 18+
Related
- Auth Overview — How auth works in Steward
- Email Magic Link — Alternative for non-WebAuthn environments
- React Components —
<StewardLogin>reference