Anmeldung per Passkey (WebAuthn)
CI / pruefen (pull_request) Canceled after 0s

Ein Passkey ist der dritte Weg in denselben Trichter: finishLogin() prueft die
Antwort und gibt die Kennung zurueck, der Endpunkt legt damit ueber
createSession() dieselbe Sitzung an wie bei Passwort und OIDC. Die
Sitzungsschicht bleibt unangetastet.

Die Trennung zwischen Pruefung und Sitzung ist Absicht: in passkeys.ts steht
nur WebAuthn, das Setzen von Cookie und Sitzungszeile gehoert zur HTTP-Schicht.

Die Challenge liegt in einem signierten, fuenf Minuten gueltigen httpOnly-
Cookie statt in einer Tabelle — das spart Schema und Aufraeumjob fuer alles,
was liegen bleibt, wenn jemand den Dialog abbricht.

Die RP ID kommt aus APP_URL, nicht aus dem Host-Header. Hinter einem Reverse
Proxy hinge sie sonst am falschen Namen, und ein Passkey ist fest an diesen
Namen gebunden. Ueber nacktes HTTP verschwindet die Verwaltung mit einem
Hinweis statt einen kryptischen Browserfehler zu zeigen.

Den letzten verbleibenden Anmeldeweg laesst sich nicht entfernen: wer kein
Passwort und keine OIDC-Verknuepfung hat, behaelt seinen letzten Passkey.

Die Bibliothek prueft den Signaturzaehler selbst und wirft dabei gewoehnliche
Error. Die werden jetzt uebersetzt, damit eine erwartete Ablehnung nicht als
unerwarteter Serverfehler im Log landet. Die eigene Zaehlerpruefung bleibt als
zusaetzliche Sicherung fuer den Fall, den die Bibliothek durchlaesst.

Geprueft mit virtuellem Authenticator gegen einen Produktionsbau: anlegen,
abmelden, Anmeldung allein per Passkey, Sitzungscookie gesetzt,
Challenge-Cookie verbraucht, Passwortweg unveraendert. Mit kuenstlich
hochgesetztem Zaehler wird die Anmeldung abgelehnt und der Zaehler bleibt
stehen. Dazu sieben Tests fuer Verwaltung, Rechte und die Aussperrsperre.

Refs #6
This commit is contained in:
Florian Wilde
2026-09-02 07:04:45 +02:00
parent 58a1d177df
commit c0579c6f61
17 changed files with 1381 additions and 6 deletions
+28
View File
@@ -3,6 +3,9 @@ import { requireUser } from "@/lib/auth";
import { getSettings } from "@/lib/settings";
import { prisma } from "@/lib/db";
import { PasswordForm, ProfileForm } from "@/components/settings/Forms";
import { PasskeyList } from "@/components/settings/Passkeys";
import { listPasskeys } from "@/lib/passkeys";
import { env } from "@/lib/env";
import pkg from "../../../package.json";
export const metadata: Metadata = { title: "Einstellungen" };
@@ -28,6 +31,8 @@ export default async function SettingsPage() {
const { passwordHash, ...profile } = user;
const passkeys = env.passkeys.enabled ? await listPasskeys(session.id) : [];
return (
<div className="space-y-6">
<section className="fl-card p-5">
@@ -42,6 +47,29 @@ export default async function SettingsPage() {
</section>
)}
{env.passkeys.enabled && (
<section className="fl-card p-5">
<h2 className="mb-1 text-lg font-semibold">Passkeys</h2>
<p className="mb-4 text-sm text-[var(--fl-muted)]">
Anmelden ohne Passwort — per Fingerabdruck, Gesicht oder Sicherheitsschlüssel.
</p>
<PasskeyList
passkeys={passkeys.map((passkey) => ({
...passkey,
createdAt: passkey.createdAt.toISOString(),
lastUsedAt: passkey.lastUsedAt?.toISOString() ?? null,
}))}
available={env.passkeys.isAvailable}
hinweis={
env.passkeys.isAvailable
? null
: "Passkeys brauchen eine verschlüsselte Verbindung. Diese Instanz läuft über " +
"einfaches HTTP — richte HTTPS ein, dann erscheint hier die Verwaltung."
}
/>
</section>
)}
<p className="text-xs text-[var(--fl-faint)]">
Flimmer {pkg.version} · Instanz {settings.instanceName}
</p>