Demos

Runnable applications to see the library at work

Every demo lives in a dedicated repository: web-auth/webauthn-demos. It hosts seven standalone pure PHP projects and a complete Symfony application, each with its own README.

git clone https://github.com/web-auth/webauthn-demos.git
cd webauthn-demos

Pure PHP demos

They use web-auth/webauthn-lib alone: no framework, no database, no build step. Each one stores its state in a local file and boots with a single command.

Demo	What it shows
basic-demo	Username based registration, sign in and credential management
usernameless-demo	Sign in without a username, with discoverable credentials and Conditional UI
passkey-upgrade-demo	Silent enrollment after a password login, with Conditional Create
signal-api-demo	The three Signal methods that keep the authenticator in sync with the server
extensions-demo	credProps, credProtect, credBlob and minPinLength in a single ceremony
prf-demo	The PRF extension used for client side encryption, including an offline vault
spc-demo	Secure Payment Confirmation, in a same-origin, two-origin and three-tier flavour

Run one of them from its own directory:

cd basic-demo
./same-origin/run.sh

The script installs the dependencies on first run and serves the demo on http://localhost:8000, which the browsers treat as a secure context. Set the PORT variable to serve it elsewhere.

Running them all at once

./run-all.sh

Every demo then gets its own port, from 8101 to 8110, so they can be compared side by side. They share the localhost Relying Party ID, which means a passkey registered in one of them is offered by the others.

Symfony application

symfony-demo is a complete application built on the bundle, with FrankenPHP, AssetMapper and Tailwind. It targets Symfony 8.1 and PHP 8.4, and shows the firewall, the Doctrine entities, a custom options storage and the Metadata Statement services in one place.

The pure PHP demos exercise features that are not released yet, so they require web-auth/webauthn-framework in its 5.4.x-dev version. The Symfony application targets the released ^5.3.