Installation 

Prerequisites 

  • TYPO3 13.4 LTS or TYPO3 14.x
  • 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:

composer require netresearch/nr-passkeys-be
Copied!

Activate the extension 

After installation, activate the extension in the TYPO3 backend:

  1. Go to Admin Tools > Extensions
  2. Search for "Passkeys Backend Authentication"
  3. Click the activate button

Or use the CLI:

vendor/bin/typo3 extension:activate nr_passkeys_be
Copied!

Database schema update 

The extension adds a tx_nrpasskeysbe_credential table. After activation, run the database schema update:

  1. Go to Admin Tools > Maintenance > Analyze Database Structure
  2. Apply the suggested changes

Or use the CLI:

vendor/bin/typo3 database:updateschema
Copied!

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.