Installation 

Prerequisites 

  • TYPO3 12.4 LTS, TYPO3 13.4 LTS, or TYPO3 14.3 LTS
  • PHP 8.2, 8.3, 8.4, or 8.5
  • HTTPS is required for WebAuthn (except for 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:

Install via Composer
composer require netresearch/nr-passkeys-be
Copied!

Database schema update 

Run the TYPO3 setup command during deployment, before the first request reaches the updated extension. It installs the credential, consumed-token and rate-limit tables and updates the backend user and group tables.

vendor/bin/typo3 extension:setup
Copied!

Use the Maintenance module's database structure analyzer to verify the result. For a cluster deployment follow Production deployment requirements.

Verify the installation 

After activation:

  1. The TYPO3 backend login page should show a Sign in with a passkey button below the Login button.

    TYPO3 login form with the passkey button visible

    The passkey button appears below the Login button, separated by an "or" divider.

  2. In User Settings, a "Passkeys" section should appear where authenticated users can register their first passkey.