Definiert Speicherung, Endpunkte, Ereignisse, Fehlerbehandlung, Überwachung und Supportverfahren für Passkeys. Diese Referenz legt die Adoptionsgrenze, das Fehlverhalten und beobachtbare Beweise fest, während umgebungsspezifische Grenzen konfigurierbar bleiben.
Paketstatus: Referenzkontext bereit für menschliche Überprüfung. Der Vertrag und die Testszenarien sind abgeschlossen, es wird jedoch nicht behauptet, dass eine übernehmende Implementierung diese bestanden hat.
Entscheidung
Für Passkeys wird ein serverseitiger Lebenszyklus von Anmeldeinformationen und Sitzungen mit expliziter Zusicherung übernommen. Es wird ein Ressourcen- oder Ereignisvertrag mit stabiler Identität, Autorisierung, Validierung, Idempotenz, Kompatibilität und expliziten Fehlern bereitgestellt. Dieses Paket ist ein Referenzvertrag: Das übernehmende Team muss numerische Grenzen, Anbieter, Rechtsordnungen und operative Verantwortliche anhand von Beweisen in der eigenen Umgebung auswählen.
Umfang
- Die Passkeys-Akteure, Eingaben, Ausgaben, Zustände, Richtlinien- oder Schema-Versionen und extern sichtbaren Ergebnisse, die durch diesen API-Block beschrieben werden.
- Primäre und alternative Schnittstellen, Hintergrundarbeiten, Caches, Integrationen, Supportwege und Beweise, die dieselbe Grenze ausüben können.
- Adoptionsspezifische Konfiguration, Rollout, Wiederherstellung und Verifikationsverantwortlichkeiten, die benötigt werden, um die Referenz sicher anzuwenden.
Außerhalb dieses Blocks
- Die Wahl eines universellen Anbieters, Frameworks, einer Rechtsordnung, numerischer Schwellenwerte, Aufbewahrungsfristen oder Service-Level-Objectives für jeden Übernehmer.
- Die Behauptung, dass verpackte Szenarien gegen eine nachgelagerte Implementierung ausgeführt wurden oder dass diese Referenz eine rechtliche, sicherheitsbezogene oder barrierefreie Zertifizierung gewährt.
Vertrag
- Speichere nur geschütztes Anmeldeinformationsmaterial, rotiere Signatur- und Wiederherstellungsgeheimnisse und halte Anmeldeinformationen aus URLs, Logs, Analysen und Supportansichten fern.
- Binde Ausstellung, Nutzung, Ablauf, Widerruf, Wiederherstellung und Wiedergabe-Behandlung an ein benanntes Subjekt und die beabsichtigte Aktion.
- Gib öffentlichkeitsresistente Aufzählungsantworten zurück, während ausreichend interne Gründe und Korrelationsdaten für Support und Missbrauchsreaktion erhalten bleiben.
- Überprüfe sensible Aktionen nach Änderungen von Subjekt, Gerät, Authentifikator, Risiko oder Sitzungsstatus erneut, anstatt einem veralteten Login dauerhaft zu vertrauen.
- Dokumentiere Methoden- oder Ereignisse-Semantik, erforderliche Felder, bedingtes Verhalten, Grenzen und ein maschinenlesbares Fehler-Vokabular.
- Lehne unbekannte sicherheitsrelevante Felder ab und bewahre Vorwärtskompatibilität für explizit erweiterbare Daten.
- Binde Registrierungs- und Authentifizierungsherausforderungen an Identität der vertrauenden Partei, Ursprung, Benutzer, Zweck, Ablauf und einmaligen Serverstatus und verifiziere die vollständige Authentifikator-Antwort.
- Unterstütze mehrere Anmeldeinformationen, entdeckbare und nicht entdeckbare Abläufe, Benutzerverifikationsrichtlinien, Geräteverlust, Widerruf, Wiederherstellung und Kontoverknüpfung, ohne den Identitätsnachweis zu schwächen.
Implementierungsanleitung
- Veröffentliche Vertrags-Fixtures und Verbrauchertests, bevor Produktionsverkehr auf eine neue Version umgeleitet wird.
- Modelle Passkeys-Eingaben, -Ausgaben, Akteure, Zustände, Invarianten, Nebeneffekte und Beweise, bevor Framework- oder Anbieterdetails ausgewählt werden.
- Speichere die anwendbare Passkeys-Vertrags- oder Richtlinienversion mit materiellem Zustand, damit Migrationen, Wiedergabe und Supportentscheidungen zuordenbar bleiben.
- Führe den Pfad hinter kontrolliertem Rollout ein, vergleiche erwartete und beobachtete Ergebnisse und behalte einen getesteten Wiederherstellungsweg, bis Adoptionsbeweise vollständig sind.
Fehlerbehandlung und Schutzmaßnahmen
- Fehlende, abgelaufene, wiederholte oder widersprüchliche Authentifizierungsnachweise verweigern die Aktion und folgen einem rate-begrenzten Wiederherstellungspfad.
- Ungültiger oder widersprüchlicher Passkeys-Zustand wird abgelehnt oder isoliert; die Implementierung schätzt niemals einen Wert, der Autorität erweitert oder eine Wirkung dupliziert.
- Wiederholungen sind begrenzt und verwenden dauerhafte Identität; nach Erschöpfung erreicht die Arbeit einen überprüfbaren Endzustand mit verantwortlichem Eigentümer.
Verifikation und Betrieb
- Teste Wiederholungen, doppelte Anfragen, bedingte Updates, Paginierung oder Wiederaufnahme, ungültige Anmeldeinformationen, Grenzen und Abhängigkeits-Timeout.
- Überwache Passkeys-Erfolg, Ablehnung, Validierungsfehler, Abhängigkeitsfehler, Erschöpfung von Wiederholungen und Wiederherstellung nach Vertragsversion ohne sensible Nutzlastdimensionen.
- Führe gepaarte positive und negative Fixtures nach Richtlinien-, Schema-, Abhängigkeits-, Migrations- oder Grenzänderungen erneut aus und bewahre die resultierenden Beweise.
Adoptionsannahmen
- Namen und Werte im Beispiel sind ein konkretes Fixture, keine universellen Standardwerte; Übernehmer ersetzen sie durch dokumentierte Beweise und Eigentum.
- Das übernehmende System kann authentifizierte Identität, dauerhafte Operationen oder Versionsaufzeichnungen, begrenzte Telemetrie und einen kontrollierten Änderungsweg bereitstellen.
Die ausführbar aussehenden Beispiele in diesem Paket sind Fixtures und Akzeptanzverträge. Führe den Sammlungsvalidator aus, um Struktur und Metadaten zu prüfen, übersetze und führe dann die Szenarien im Ziel-Repository aus, bevor Implementierungsbeweise aufgezeichnet werden.
Referenzen
- NIST SP 800-63B-4, Authentication and Authenticator Management (gültig ab 2026-09-08)