Passkeys & MFA
Sign in without a password, or require a passkey as a second factor after your password or OIDC provider.
A passkey signs you in with your phone, computer, or hardware key. Use it for:
- Passwordless sign-in: select Passkey on the login page and follow your device’s prompt.
- Passkey MFA: sign in with your password or OIDC provider, then confirm with a passkey.
Registering a passkey does not turn on MFA. That’s a separate switch.
Before you start
Section titled “Before you start”- Serve Arcane over HTTPS (or
localhost). Browsers only allow passkeys in a secure context. See TLS or use a reverse proxy that terminates HTTPS. - Set
ARCANE_APP_URLto your public HTTPS URL. See Environment Variables.
Over plain HTTP, Arcane shows “Passkeys require a supported browser and a secure HTTPS connection.” and hides the controls.
Register a passkey
Section titled “Register a passkey”- Open Account from the sidebar user menu, on the Account tab.
- In Passkeys, select Add passkey.
- Name it something recognizable, usually its device.
- Complete your browser or OS prompt.
The list shows each passkey’s name and last use; rename or delete them there.
Passkeys come in two kinds:
- Synced: stored in a password manager or platform account (for example iCloud Keychain or Google Password Manager). It follows you to your other signed-in devices.
- Device-bound: stays on one device, such as a hardware security key. Lose the device and you lose the passkey.
Keep a second way in either way: register a second passkey, keep your password, or save your recovery codes when you turn on MFA. Arcane prefers post-quantum ML-DSA keys when your authenticator supports them, otherwise classical algorithms.
Turn on passkey MFA
Section titled “Turn on passkey MFA”You need at least one registered passkey first.
- In Passkeys, find Passkey MFA and select Enable MFA.
- Save the 10 single-use recovery codes somewhere safe. Arcane shows them once, and they’re your only way in if you lose your passkey.
Password and OIDC sign-ins then stop at an MFA step offering Use passkey or Use recovery code. The panel shows remaining codes; Regenerate codes issues 10 new ones (shown once) and invalidates the old ones.
Disabling MFA deletes remaining recovery codes but keeps your passkeys, so sign-in falls back to password or OIDC alone. Lost both passkeys and codes? An operator with shell access to the container can clear MFA; see Account Recovery.
Confirm your identity before changes
Section titled “Confirm your identity before changes”Changing passkeys, MFA, or recovery codes requires Confirm your identity with a passkey or current password. Confirmation and passkey prompts expire after 5 minutes. OIDC-only accounts need an accessible passkey here; without one, use arcane admin reset-mfa (Account Recovery).
Use the CLI with MFA enabled
Section titled “Use the CLI with MFA enabled”arcane-cli auth login uses a browser device flow that can’t carry an MFA challenge, so it fails with MFA on. Create a personal API key under API keys on the Account page, then run:
arcane-cli config set api-key <key>A personal API key has the same permissions as your account, checked on every request. For a key limited to specific permissions, create a scoped key under System → API Keys and select only what the CLI needs (Scope API keys). See CLI Configuration.
Related
Section titled “Related”- OIDC Single Sign-On: passkey MFA works on top of OIDC sign-in.
- Roles & Permissions: what an account can do once signed in.