alveby / atrium-2fa
Second sign-in factor for Atrium, for the admin and the personal account: authenticator apps (TOTP), passkeys, a code by e-mail or SMS, recovery codes, trusted devices, a sign-in log, and a passwordless e-mail code
dev-main / 0.1.x-dev
2026-11-17 15:12 UTC
Requires
- php: ^8.3
- ext-openssl: *
- alveby/atrium: ^0.1
- bacon/bacon-qr-code: ^3.0
- illuminate/support: ^13.0
- lbuchs/webauthn: ^2.2
Requires (Dev)
- orchestra/testbench: ^11.0
- phpunit/phpunit: ^12.5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
This package is auto-updated.
Last update: 2026-11-19 23:09:16 UTC
README
A second sign-in step for Atrium, for the admin panel and the personal account, and ways in without a password.
- Authenticator apps (TOTP, RFC 6238) with a QR code, passkeys (WebAuthn), a code by e-mail, a code by SMS through a driver of your own.
- Required for everybody, for chosen roles, or optional per person; set per guard in the config and in the panel.
- Recovery codes shown once and stored hashed; "trust this device" for N days.
- Rate limits and lockout; a sign-in log of every guard; an admin can reset a person's factors, and the reset is logged.
- Signing in with a six-digit e-mail code or a passkey alone, without telling whether an address has an account.
- Secrets encrypted at rest. Pages in 15 languages, readable in all five admin themes.
Install
composer require alveby/atrium-2fa php artisan atrium:module:install alveby/atrium-2fa
Then Modules → Two-factor sign-in in the panel. Everything is described in docs/two-factor.md (по-русски).
License
MIT. This package is split from the Atrium monorepo; issues and pull requests go there.