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
localhostduring development) - A configured TYPO3 encryption key
(
$GLOBALS, minimum 32 characters)['TYPO3_ CONF_ VARS'] ['SYS'] ['encryption Key']
Installation via Composer
This is the recommended way to install the extension:
composer require netresearch/nr-passkeys-be
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
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:
-
The TYPO3 backend login page should show a Sign in with a passkey button below the Login button.
The passkey button appears below the Login button, separated by an "or" divider.
- In User Settings, a "Passkeys" section should appear where authenticated users can register their first passkey.
Note
HTTPS is mandatory for WebAuthn to function. The only exception is
localhost for local development. If you are running TYPO3
behind a reverse proxy, ensure that the TYPO3_ environment
variable or the [SYS] configuration is set
correctly.