feat: Anmelden mit Passkey
Passkeys (WebAuthn/FIDO2) als zweiter Anmeldeweg - auf der Anmeldeseite und bei der erneuten Bestaetigung vor sensiblen Aktionen. Verwaltet unter "Mein Konto". Der Passkey ERSETZT den zweiten Faktor, statt zu ihm hinzuzukommen. Das ist tragbar, weil er zwei Faktoren in sich vereint: Besitz des Geraets und dessen Entsperrung. Damit das keine Annahme bleibt, wird die Nutzerverifikation angefordert (userVerification: 'required') und serverseitig nachgeprueft - eine Antwort ohne sie wird abgewiesen. TOTP muss vorher eingerichtet sein. Ein Passkey haengt an einem Geraet; waere er der einzige Weg hinein, koennte ein verlorenes Handy die Akte schliessen. Aufbau: - Die Pruefung laeuft vollstaendig im Credentials-Provider "passkey", nicht in der Server Action davor. Ein "war schon geprueft" ueber die Grenze zu reichen waere die Stelle, an der sich Anmeldungen faelschen lassen. - Challenges liegen serverseitig und werden per DELETE genau einmal verbraucht - die Datenbank entscheidet, wer sie bekommt. - Bereichskennung und Herkunft kommen aus AUTH_URL, nicht aus einer zweiten Konfigurationsquelle. - Ohne https wird der Knopf gar nicht erst angeboten. - Rate-Limiting, Kontosperre und Audit-Log gelten unveraendert; die Anmeldung nennt den verwendeten Passkey namentlich. Zwei Anmerkungen zur Migration: - "prisma migrate diff" wollte zusaetzlich die Trigramm-Indizes aus prisma/sql/suche.sql loeschen, die Prisma nicht kennt. Die Zeilen sind entfernt und im Migrationskopf vermerkt - ein DROP haette die unscharfe Suche stillgelegt, ohne dass etwas fehlgeschlagen waere. - "prisma format" hat das Schema durchgaengig neu ausgerichtet. Ohne Whitespace betrachtet sind es 88 hinzugefuegte Zeilen und keine geloeschte. Geprueft: 21 Einheitstests, drei End-to-End-Tests gegen Chromiums virtuellen Authenticator (einrichten, anmelden, bestaetigen, entfernen, Geraet ohne Verifikation abgewiesen), beide Geraeteprofile. 496 Tests, null Typfehler, Produktionsbau steht. Nebenbei: Die Zahlen im README waren veraltet (24 statt 33 Modelle, 46 statt 79 Seiten). Sie stehen jetzt mit dem Befehl daneben, mit dem man sie nachzaehlt.
This commit is contained in:
@@ -0,0 +1,55 @@
|
||||
/**
|
||||
* Browserseitige Hilfen fuer Passkeys.
|
||||
*
|
||||
* Bewusst ohne "server-only" und ohne Datenbankzugriff: Diese Datei laeuft
|
||||
* im Browser. Die eigentliche Pruefung passiert auf dem Server
|
||||
* (src/lib/auth/passkey.ts) - hier geht es nur darum, das Geraet
|
||||
* anzusprechen und seine Fehler in verstaendliche Saetze zu uebersetzen.
|
||||
*/
|
||||
|
||||
import {
|
||||
browserSupportsWebAuthn,
|
||||
startAuthentication,
|
||||
startRegistration,
|
||||
} from '@simplewebauthn/browser'
|
||||
|
||||
export { browserSupportsWebAuthn, startAuthentication, startRegistration }
|
||||
|
||||
/**
|
||||
* Uebersetzt die Ausnahmen der WebAuthn-Schnittstelle.
|
||||
*
|
||||
* Der Browser wirft DOMExceptions mit sehr knappen Namen und einer
|
||||
* englischen Beschreibung, die man niemandem zeigen kann. Vor allem
|
||||
* "NotAllowedError" ist irrefuehrend: Er bedeutet meistens schlicht, dass
|
||||
* der Vorgang abgebrochen wurde oder die Zeit abgelaufen ist - nicht, dass
|
||||
* etwas verboten waere.
|
||||
*/
|
||||
export function passkeyBrowserfehler(fehler: unknown, beimEinrichten = false): string {
|
||||
const name = fehler instanceof Error ? fehler.name : ''
|
||||
|
||||
switch (name) {
|
||||
case 'NotAllowedError':
|
||||
return 'Abgebrochen oder zu lange gewartet. Du kannst es gleich noch einmal versuchen.'
|
||||
|
||||
case 'InvalidStateError':
|
||||
return beimEinrichten
|
||||
? 'Für dieses Gerät ist hier bereits ein Passkey hinterlegt. Ein zweiter bringt nichts — ' +
|
||||
'nimm ein anderes Gerät oder entferne zuerst den vorhandenen.'
|
||||
: 'Dieses Gerät kann den Passkey gerade nicht verwenden.'
|
||||
|
||||
case 'SecurityError':
|
||||
return (
|
||||
'Die Adresse im Browser passt nicht zu der, für die der Passkey ausgestellt wurde. ' +
|
||||
'Das ist genau der Schutz, der Phishing verhindert — prüfe die Adresszeile.'
|
||||
)
|
||||
|
||||
case 'NotSupportedError':
|
||||
return 'Dieses Gerät unterstützt keine Passkeys mit Fingerabdruck, Gesicht oder PIN.'
|
||||
|
||||
case 'AbortError':
|
||||
return 'Abgebrochen.'
|
||||
|
||||
default:
|
||||
return 'Der Passkey konnte nicht verwendet werden. Bitte versuche es noch einmal.'
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user