Skip to content

Add passkey browser auth to CLI#3804

Open
ntner wants to merge 1 commit into
masterfrom
add-passkey-mfa-support
Open

Add passkey browser auth to CLI#3804
ntner wants to merge 1 commit into
masterfrom
add-passkey-mfa-support

Conversation

@ntner

@ntner ntner commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Summary

The CLI's session authentication previously completed the WebAuthn step only by talking to a physical USB security key over HID. Users who authenticate with a passkey (a platform authenticator such as Touch ID or Windows Hello, or a synced passkey) have no such device for the CLI to drive, so every command failed with:

Waiting for security token... ERROR: no valid tokens found

This adds a browser-based path: when the console issues a session token challenge, the CLI opens the browser to the console's existing /login/u2f page, the browser performs the WebAuthn ceremony (which supports passkeys, platform authenticators, and security keys), and the resulting assertion is returned to the CLI over a short-lived local callback. The direct hardware-key path is retained behind an environment toggle.

Configuration

Variable Values Default Effect
CONVOX_WEB_U2F_DISABLE true / unset unset When true, skip the browser flow and authenticate directly against a physical USB security key over HID (the previous behavior).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant