WebAuthn Registrierung

Passkey Registrierung

Anleitung zur Registrierung von Passkeys für Benutzer.

Voraussetzungen

• Benutzer muss bereits mit OAuth angemeldet sein
• Browser muss WebAuthn unterstützen
• Gerät muss Biometrie, PIN oder Security Key unterstützen

Registrierungsprozess

Schritt 1: Registrierung initiieren

import { WebAuthnClient } from './webauthn-client.js';

const webauthn = new WebAuthnClient({
  authServerUrl: 'https://auth.deine-domain.de'
});

// Benutzer muss angemeldet sein
const result = await webauthn.addPasskey();

Schritt 2: Browser fordert Biometrie/PIN

Der Browser zeigt automatisch einen Dialog zur Authentifizierung:

• Touch ID: Fingerabdruck scannen
• Face ID: Gesicht scannen
• Windows Hello: PIN oder Biometrie
• Security Key: Hardware-Key einstecken

Schritt 3: Passkey wird gespeichert

Nach erfolgreicher Authentifizierung:

• Passkey wird im Cloudflare KV gespeichert
• Benutzer kann sich jetzt mit diesem Passkey anmelden

Mehrere Passkeys

Benutzer können mehrere Passkeys registrieren:

// Ersten Passkey registrieren
await webauthn.addPasskey();

// Zweiten Passkey registrieren (z.B. auf anderem Gerät)
await webauthn.addPasskey();

API Referenz

Siehe API Endpoints für Details zu den WebAuthn-Endpoints.

Nächste Schritte

• Authentifizierung - Mit Passkeys anmelden
• WebAuthn Client - Client-Library verwenden