WebAuthn Übersicht

WebAuthn Passkey Authentication

WebAuthn ermöglicht passwortlose Authentifizierung mit Passkeys - sicher, schnell und benutzerfreundlich.

Was sind Passkeys?

Passkeys sind moderne, sichere Alternativen zu Passwörtern. Sie basieren auf dem WebAuthn-Standard und ermöglichen Authentifizierung mit:

Biometrische Daten: Fingerabdruck, Face ID, Touch ID
Device PIN: Geräte-Entsperrcode
Hardware Security Keys: YubiKey, Titan Security Key, etc.

Vorteile von Passkeys

✅ Sicher: Phishing-resistent, keine gestohlenen Passwörter
✅ Schnell: Ein Touch oder Blick genügt
✅ Einfach: Keine Passwörter merken
✅ Multi-Device: Mehrere Passkeys pro User
✅ Privat: Biometrische Daten verlassen nie das Gerät

Features

✅ Sichere Registrierung - Passkeys mit Biometrie oder Security Keys registrieren
✅ Schnelle Authentifizierung - Mit einem Touch oder Blick anmelden
✅ Multi-Device Support - Mehrere Passkeys pro User (Laptop, Handy, Security Key)
✅ Usernameless Flow - Optionales schnelles Anmelden ohne Username
✅ Credential Management - Passkeys auflisten und entfernen
✅ KV Storage - Sichere Speicherung in Cloudflare KV
✅ JWT Integration - Nahtlose Integration mit OAuth-Token-System

Wie funktioniert WebAuthn?

Registrierung

1. User → Server: Möchte Passkey registrieren
2. Server → User: Challenge (zufälliger Token)
3. User Device: Erstellt Keypair (öffentlich/privat)
4. User Device → Server: Öffentlicher Key + Signatur
5. Server: Verifiziert und speichert öffentlichen Key

Authentifizierung

1. User → Server: Möchte sich anmelden
2. Server → User: Challenge (zufälliger Token)
3. User Device: Signiert Challenge mit privatem Key
4. User Device → Server: Signatur
5. Server: Verifiziert Signatur mit öffentlichem Key
6. Server → User: JWT Token (erfolgreich angemeldet)

Architektur

WebAuthn Flow

Passkey Registrierung:
- User meldet sich mit OAuth an
- Fügt Passkey über /webauthn/add-passkey hinzu
- Passkey wird in KV gespeichert
Passkey Authentifizierung:
- User wählt Passkey
- Authentifiziert sich mit Biometrie/PIN
- Erhält JWT Token

Datenspeicherung

Passkeys werden in Cloudflare KV gespeichert:

{
  "userId": "github:123456",
  "credentials": [
    {
      "credentialId": "base64url...",
      "publicKey": "base64url...",
      "counter": 0,
      "deviceName": "MacBook Pro Touch ID",
      "createdAt": "2024-01-01T00:00:00Z"
    }
  ]
}

Browser-Kompatibilität

WebAuthn wird von modernen Browsern unterstützt:

Browser	Version	Platform
Chrome	67+	Windows, macOS, Linux, Android
Edge	18+	Windows, macOS
Firefox	60+	Windows, macOS, Linux
Safari	13+	macOS, iOS

Sicherheitshinweise

Siehe Sicherheitshinweise für Details.

Erste Schritte

Passkey Registrierung - Passkeys für User registrieren
Passkey Authentifizierung - Mit Passkeys anmelden
WebAuthn Client - Client-Library verwenden

Nächste Schritte

Registrierung - Passkey-Registrierung implementieren
Authentifizierung - Passkey-Login implementieren
Sicherheit - Sicherheitshinweise beachten