feat(admin-ui): TOTP MFA enrollment + two-step login; remove stub 2FA toggle

Frontend for #738.
- mfa.service.ts + MfaSettingsCard (Settings → General → Admin Account):
  per-user setup (QR + manual secret + verify), recovery codes shown once
  (copy/download/confirm), status, regenerate, disable. Renders for
  super_admin (closes #735).
- Two-step login in AdminLoginPage: on {mfaRequired,mfaToken} swap to a
  code step (TOTP or recovery), call /auth/admin/login/mfa; handle
  MFA_INVALID / MFA_SESSION_EXPIRED / 423 lockout.
- Removed the non-functional global enable_2fa checkbox from SecurityTab
  (and its persistence) — replaced with a note pointing to per-user setup.
- en + de i18n.

Verified live in-browser: enroll (QR→code→recovery codes), logout, and
the two-step challenge into the dashboard as super_admin.
This commit is contained in:
Paul Nothaft
2026-07-03 11:44:07 +02:00
parent cdbfb514bd
commit 96e3c68b9d
10 changed files with 679 additions and 24 deletions
@@ -0,0 +1,320 @@
import React, { useState } from 'react';
import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
import { useTranslation } from 'react-i18next';
import { toast } from 'react-toastify';
import { ShieldCheck, ShieldOff, Copy, Download, Check, KeyRound, AlertTriangle } from 'lucide-react';
import { Button, Card, Input, Loading, useConfirm } from '../../../components/common';
import { mfaService } from '../../../services/mfa.service';
// Per-user admin TOTP MFA management (issue #738). Lives on the admin's own
// account surface (Settings → General → Admin Account). Self-service: acts on
// the currently authenticated admin only.
interface RecoveryCodesPanelProps {
codes: string[];
onConfirm: () => void;
}
const RecoveryCodesPanel: React.FC<RecoveryCodesPanelProps> = ({ codes, onConfirm }) => {
const { t } = useTranslation();
const [copied, setCopied] = useState(false);
const [acknowledged, setAcknowledged] = useState(false);
const asText = codes.join('\n');
const handleCopy = async () => {
try {
await navigator.clipboard.writeText(asText);
setCopied(true);
setTimeout(() => setCopied(false), 2000);
} catch {
toast.error(t('settings.mfa.copyFailed'));
}
};
const handleDownload = () => {
const blob = new Blob([`${asText}\n`], { type: 'text/plain' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = 'picpeak-recovery-codes.txt';
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
URL.revokeObjectURL(url);
};
return (
<div className="space-y-4">
<div className="p-4 rounded-lg bg-amber-50 dark:bg-amber-900/30 border border-amber-200 dark:border-amber-800 flex items-start gap-3">
<AlertTriangle className="w-5 h-5 text-amber-600 dark:text-amber-400 flex-shrink-0 mt-0.5" />
<p className="text-sm text-amber-800 dark:text-amber-200">{t('settings.mfa.recoveryCodesWarning')}</p>
</div>
<div className="grid grid-cols-2 gap-2 p-4 rounded-lg bg-neutral-50 dark:bg-neutral-800 border border-neutral-200 dark:border-neutral-700 font-mono text-sm text-neutral-900 dark:text-neutral-100">
{codes.map((code) => (
<span key={code} className="select-all">{code}</span>
))}
</div>
<div className="flex flex-wrap gap-2">
<Button variant="outline" size="sm" leftIcon={copied ? <Check className="w-4 h-4" /> : <Copy className="w-4 h-4" />} onClick={handleCopy}>
{copied ? t('settings.mfa.copied') : t('settings.mfa.copy')}
</Button>
<Button variant="outline" size="sm" leftIcon={<Download className="w-4 h-4" />} onClick={handleDownload}>
{t('settings.mfa.download')}
</Button>
</div>
<label className="flex items-start gap-2">
<input
type="checkbox"
checked={acknowledged}
onChange={(e) => setAcknowledged(e.target.checked)}
className="mt-1 w-4 h-4 text-primary-600 rounded focus:ring-primary-500"
/>
<span className="text-sm text-neutral-700 dark:text-neutral-300">{t('settings.mfa.recoveryCodesAck')}</span>
</label>
<Button variant="primary" disabled={!acknowledged} onClick={onConfirm}>
{t('settings.mfa.done')}
</Button>
</div>
);
};
export const MfaSettingsCard: React.FC = () => {
const { t } = useTranslation();
const queryClient = useQueryClient();
const confirm = useConfirm();
const { data: status, isLoading } = useQuery({
queryKey: ['admin-mfa-status'],
queryFn: () => mfaService.getStatus(),
});
// Enrollment flow state
const [setupData, setSetupData] = useState<Awaited<ReturnType<typeof mfaService.setup>> | null>(null);
const [enableCode, setEnableCode] = useState('');
const [enableError, setEnableError] = useState<string | null>(null);
// Recovery codes to display once (after enable or regenerate)
const [recoveryCodes, setRecoveryCodes] = useState<string[] | null>(null);
// Regenerate flow state
const [showRegenerate, setShowRegenerate] = useState(false);
const [regenerateCode, setRegenerateCode] = useState('');
const [regenerateError, setRegenerateError] = useState<string | null>(null);
const invalidateStatus = () => queryClient.invalidateQueries({ queryKey: ['admin-mfa-status'] });
const errorMessage = (error: any, fallbackKey: string): string =>
error?.response?.data?.error || t(fallbackKey);
const setupMutation = useMutation({
mutationFn: () => mfaService.setup(),
onSuccess: (data) => {
setSetupData(data);
setEnableCode('');
setEnableError(null);
},
onError: (error) => toast.error(errorMessage(error, 'settings.mfa.setupFailed')),
});
const enableMutation = useMutation({
mutationFn: (code: string) => mfaService.enable(code),
onSuccess: (data) => {
setRecoveryCodes(data.recoveryCodes);
setSetupData(null);
setEnableCode('');
setEnableError(null);
invalidateStatus();
},
onError: (error) => setEnableError(errorMessage(error, 'settings.mfa.enableFailed')),
});
const disableMutation = useMutation({
mutationFn: (code: string) => mfaService.disable(code),
onSuccess: () => {
toast.success(t('settings.mfa.disabledToast'));
invalidateStatus();
},
onError: (error) => toast.error(errorMessage(error, 'settings.mfa.disableFailed')),
});
const regenerateMutation = useMutation({
mutationFn: (code: string) => mfaService.regenerateRecoveryCodes(code),
onSuccess: (data) => {
setRecoveryCodes(data.recoveryCodes);
setShowRegenerate(false);
setRegenerateCode('');
setRegenerateError(null);
invalidateStatus();
},
onError: (error) => setRegenerateError(errorMessage(error, 'settings.mfa.regenerateFailed')),
});
const handleDisable = async () => {
const code = window.prompt(t('settings.mfa.disablePrompt'));
if (code === null) return;
const trimmed = code.trim();
if (!trimmed) {
toast.error(t('settings.mfa.codeRequired'));
return;
}
const ok = await confirm({
title: t('settings.mfa.disableConfirmTitle'),
message: t('settings.mfa.disableConfirmMessage'),
variant: 'danger',
confirmLabel: t('settings.mfa.disableConfirmButton'),
});
if (ok) disableMutation.mutate(trimmed);
};
return (
<Card padding="md">
<div className="flex items-center gap-2 mb-1">
<ShieldCheck className="w-5 h-5 text-neutral-700 dark:text-neutral-300" />
<h2 className="text-lg font-semibold text-neutral-900 dark:text-neutral-100">{t('settings.mfa.title')}</h2>
</div>
<p className="text-sm text-neutral-600 dark:text-neutral-400 mb-4">{t('settings.mfa.description')}</p>
{isLoading ? (
<div className="py-8 flex justify-center">
<Loading size="md" />
</div>
) : recoveryCodes ? (
<RecoveryCodesPanel codes={recoveryCodes} onConfirm={() => setRecoveryCodes(null)} />
) : status?.enabled ? (
/* ---------------- Enrolled ---------------- */
<div className="space-y-4">
<div className="p-3 rounded-lg bg-green-50 dark:bg-green-900/30 border border-green-200 dark:border-green-800 flex items-center gap-2">
<ShieldCheck className="w-5 h-5 text-green-600 dark:text-green-400 flex-shrink-0" />
<span className="text-sm text-green-800 dark:text-green-200">{t('settings.mfa.enabledBadge')}</span>
</div>
<p className="text-sm text-neutral-600 dark:text-neutral-400">
{t('settings.mfa.recoveryCodesRemaining', { count: status.recoveryCodesRemaining })}
</p>
{showRegenerate ? (
<div className="space-y-3 p-4 rounded-lg border border-neutral-200 dark:border-neutral-700">
<p className="text-sm text-neutral-700 dark:text-neutral-300">{t('settings.mfa.regenerateHelp')}</p>
<Input
type="text"
value={regenerateCode}
onChange={(e) => {
setRegenerateCode(e.target.value);
if (regenerateError) setRegenerateError(null);
}}
placeholder={t('settings.mfa.codePlaceholder')}
leftIcon={<KeyRound className="w-5 h-5 text-neutral-400" />}
error={regenerateError || undefined}
autoComplete="one-time-code"
/>
<div className="flex gap-2">
<Button
variant="primary"
isLoading={regenerateMutation.isPending}
onClick={() => {
const trimmed = regenerateCode.trim();
if (!trimmed) { setRegenerateError(t('settings.mfa.codeRequired')); return; }
regenerateMutation.mutate(trimmed);
}}
>
{t('settings.mfa.regenerateConfirm')}
</Button>
<Button variant="ghost" onClick={() => { setShowRegenerate(false); setRegenerateCode(''); setRegenerateError(null); }}>
{t('common.cancel')}
</Button>
</div>
</div>
) : (
<div className="flex flex-wrap gap-2">
<Button variant="outline" onClick={() => setShowRegenerate(true)}>
{t('settings.mfa.regenerate')}
</Button>
<Button
variant="outline"
leftIcon={<ShieldOff className="w-4 h-4" />}
isLoading={disableMutation.isPending}
onClick={handleDisable}
>
{t('settings.mfa.disable')}
</Button>
</div>
)}
</div>
) : setupData ? (
/* ---------------- Setup in progress ---------------- */
<div className="space-y-4">
<p className="text-sm text-neutral-700 dark:text-neutral-300">{t('settings.mfa.setupScanInstruction')}</p>
<div className="flex flex-col sm:flex-row gap-4 items-start">
<img
src={setupData.qr}
alt={t('settings.mfa.qrAlt')}
className="w-44 h-44 rounded-lg border border-neutral-200 dark:border-neutral-700 bg-white p-2"
/>
<div className="space-y-2">
<p className="text-sm text-neutral-600 dark:text-neutral-400">{t('settings.mfa.manualEntry')}</p>
<code className="block px-3 py-2 rounded bg-neutral-100 dark:bg-neutral-800 text-sm font-mono text-neutral-900 dark:text-neutral-100 break-all select-all">
{setupData.secret}
</code>
</div>
</div>
<div>
<label htmlFor="mfa-enable-code" className="block text-sm font-medium text-neutral-700 dark:text-neutral-300 mb-1">
{t('settings.mfa.enterCodeLabel')}
</label>
<Input
id="mfa-enable-code"
type="text"
value={enableCode}
onChange={(e) => {
setEnableCode(e.target.value);
if (enableError) setEnableError(null);
}}
placeholder={t('settings.mfa.codePlaceholder')}
leftIcon={<KeyRound className="w-5 h-5 text-neutral-400" />}
error={enableError || undefined}
inputMode="numeric"
autoComplete="one-time-code"
/>
</div>
<div className="flex gap-2">
<Button
variant="primary"
isLoading={enableMutation.isPending}
onClick={() => {
const trimmed = enableCode.trim();
if (!trimmed) { setEnableError(t('settings.mfa.codeRequired')); return; }
enableMutation.mutate(trimmed);
}}
>
{t('settings.mfa.enable')}
</Button>
<Button variant="ghost" onClick={() => { setSetupData(null); setEnableCode(''); setEnableError(null); }}>
{t('common.cancel')}
</Button>
</div>
</div>
) : (
/* ---------------- Not enrolled ---------------- */
<div className="space-y-3">
<p className="text-sm text-neutral-600 dark:text-neutral-400">{t('settings.mfa.notEnrolled')}</p>
<Button
variant="primary"
leftIcon={<ShieldCheck className="w-5 h-5" />}
isLoading={setupMutation.isPending}
onClick={() => setupMutation.mutate()}
>
{t('settings.mfa.setUp')}
</Button>
</div>
)}
</Card>
);
};