Passkey

Über

payload-passkey fügt Payload CMS die WebAuthn-Passkey-Authentifizierung hinzu und baut auf Better Auth sowie @delmaredigital/payload-better-auth auf. Das Plugin erweitert die users collection von Payload um die Better Auth collections (accounts, passkeys, sessions) und die dazugehörigen Felder wie emailVerified, image und ein Feld zur Passkey-Verwaltung. Auf der Login-Seite von Payload erscheint zusätzlich ein Passkey-Login-Button. Die Passkey-Verwaltung ist in die Account-Seite integriert und nutzt die UI-Komponenten von Payload, sodass das Design des Admin-Bereichs erhalten bleibt. Die Konfiguration umfasst die WebAuthn-Relying-Party-Einstellungen (rpID, rpName, origin), die Better Auth-Parameter (baseURL, secret), trustedOrigins und eine generateId-Strategie, die bei PostgreSQL mit Standard-IDs auf "serial" gesetzt werden sollte. Die Session-Lebensdauer wird über sessionSeconds gesteuert, ergänzt durch sessionRefreshBufferSeconds als Puffer. Ein Admin-Provider-Component sorgt für die automatische Token-Aktualisierung, bevor die Better Auth-Session abläuft. Mit enableTotpCompatibility lässt sich Passkey-Login parallel zu Payload TOTP betreiben. Das Plugin verwendet dann eine Passkey-als-TOTP-Strategie, bei der ein Passkey den zweiten Faktor ersetzt. Collection-Hooks widerrufen Better Auth-Sessions bei TOTP-Änderung, bei Login und bei Logout; über ein allSessions-Flag werden alle Sessions eines Nutzers gelöscht. Die Standard-Anmeldung per E-Mail und Passwort bleibt vollständig erhalten. Die i18n-Unterstützung umfasst Englisch und Japanisch (beta).

Paketinformationen

Paketname

payload-passkey

Neueste Version

2.1.2

Entpackte Größe

124 kB

Lizenz

MIT

Wöchentliche Downloads

189

Zuletzt veröffentlicht

3. Okt. 2026