Installation 

Prerequisites 

  • TYPO3 13.4 LTS or TYPO3 14.3 LTS
  • PHP 8.2, 8.3, 8.4, or 8.5
  • netresearch/nr-passkeys-be ^1.0 (installed automatically)
  • HTTPS is required for WebAuthn (except localhost during development)
  • A configured TYPO3 encryption key ($GLOBALS['TYPO3_CONF_VARS']['SYS']['encryptionKey'], minimum 32 characters)

Installation via Composer 

This is the recommended way to install the extension:

composer require netresearch/nr-passkeys-fe
Copied!

This also installs netresearch/nr-passkeys-be as a dependency.

Database schema update 

The extension adds four tables and extends two core tables:

  • tx_nrpasskeysfe_credential -- Frontend passkey credentials
  • tx_nrpasskeysfe_recovery_code -- Bcrypt-hashed recovery codes
  • tx_nrpasskeysfe_consumed_token -- Single-use login and challenge claims
  • tx_nrpasskeysfe_recovery_capacity -- Recovery verification budget shared by all workers
  • fe_users -- Adds passkey_grace_period_start and passkey_nudge_until columns for enforcement tracking
  • fe_groups -- Adds passkey_enforcement and passkey_grace_period_days columns for per-group enforcement

Set up both installed extensions before routing traffic to the updated workers. Verify the tables in the Maintenance module's database structure analyzer on the connections used by the application.

vendor/bin/typo3 extension:setup
Copied!

Include TypoScript 

Include the extension's TypoScript in your site configuration:

  1. Go to Site Management > TypoScript
  2. Edit your root TypoScript record
  3. Add the static template Passkeys Frontend Authentication (nr_passkeys_fe)

Or add it manually:

@import 'EXT:nr_passkeys_fe/Configuration/TypoScript/setup.typoscript'
@import 'EXT:nr_passkeys_fe/Configuration/TypoScript/constants.typoscript'
Copied!

Add the plugins 

Three frontend plugins are available. Add them to your pages as content elements:

NrPasskeysFe:Login
The passkey login form. Place on your login page. Supports both discoverable (usernameless) and username-first login.
NrPasskeysFe:Management
Self-service credential management. Place on a page accessible only to logged-in users.
NrPasskeysFe:Enrollment
Enrollment form used as the interstitial target. Required when enforcement is active.

See Quick Start for a step-by-step walkthrough.

Verify the installation 

After activation:

  1. Visit the login page with the NrPasskeysFe:Login plugin. You should see a Sign in with a passkey button.
  2. The backend module Admin Tools > Passkey Management FE should appear.