Release Notes - v0.1.14
Two-Factor Authentication (2FA) Implementation
Overview
This implementation adds TOTP-based (Time-based One-Time Password) two-factor authentication support to the application, compatible with standard authenticator apps like Google Authenticator, Authy, and others.
Features
- TOTP-based authentication (RFC 6238 compliant)
- QR code setup for easy enrollment
- Backup codes for account recovery
- Rate-limited verification attempts
- Secure secret storage
Database Changes
The following fields have been added to the users
table:
two_factor_secret
: Stores the TOTP secret keytwo_factor_enabled
: Boolean flag indicating if 2FA is enabledbackup_codes
: Stores recovery backup codes
Setup Process
- Navigate to
/profile/2fa/setup
- Scan the displayed QR code with your authenticator app
- Enter the verification code to confirm setup
- Save your backup codes in a secure location
Login Flow
- Enter email and password as usual
- If 2FA is enabled:
- Enter the 6-digit code from your authenticator app
- Alternatively, use a backup code if you can't access your authenticator
Bug Fixes
- Error when trying to save config files due to issue with checkboxes being sent as 'ON'