WebUI access was a single shared password. This adds optional
Authenticator TOTP as a second factor, with one-time recovery codes
and SSH as the last-resort disable path.
Login stays two HTTP posts with no pending token: a correct password
and enabled 2FA without a second factor returns { needsTotp: true };
the client then resubmits { password, totp } or { password, recoveryCode }.
The TOTP secret is wrapped with a password-derived AES-256-GCM key.
Eight XXXX-XXXX recovery codes are stored as SHA-256 hashes and each
code is consumed once. Enabling or disabling 2FA invalidates other
sessions; disabling still requires password plus TOTP or a recovery
code. SNOWLUMA_DEV_MODE hides the feature.
The login page uses a dedicated second-factor screen (Interior OTP
cells for the 6-digit code; the same cell UI for recovery codes,
grouped as XXXX-XXXX). Settings expose enroll/confirm/disable and
one-time recovery-code display.
Fixes #351
13 lines
444 B
TypeScript
13 lines
444 B
TypeScript
import { describe, expect, it } from 'vitest';
|
|
import { parseSecondFactor } from '../src/lib/totp-second-factor';
|
|
|
|
describe('parseSecondFactor', () => {
|
|
it('treats a 6-digit code as TOTP, ignoring spaces', () => {
|
|
expect(parseSecondFactor('287 082')).toEqual({ totp: '287082' });
|
|
});
|
|
|
|
it('treats a recovery code as a recovery code', () => {
|
|
expect(parseSecondFactor('AB3D-K7MQ')).toEqual({ recoveryCode: 'AB3D-K7MQ' });
|
|
});
|
|
});
|