Engineering-Postmortem
Ein Passkey, zwei Schlüssel: was wir über PRF gelernt haben und der Fix für jede neue Wallet
TL;DR: WebAuthn PRF ist ein sicherer und deterministischer Weg, einen Wallet-Schlüssel abzuleiten: derselbe Passkey und dasselbe Salt ergeben immer dasselbe Geheimnis. Wir haben einen Fall gefunden, in dem ein Passwortmanager beim Erstellen des Passkeys einen Wert und bei jedem späteren Login einen anderen Wert zurückgab. Unser Fehler war es, dem Wert aus dem Create-Schritt zu vertrauen, ohne zu prüfen, ob ein Login ihn reproduziert. Die Mittel wurden wiederhergestellt und sind sicher. Der Fix besteht aus einer Stabilitätsprüfung beim Signup, einem Schlüsselvergleich bei jedem Login und einer weiteren Prüfung, bevor Geld bewegt wird.
Dieser Beitrag ist auch verfügbar auf English , Español und Italiano .
Was passiert ist
Ein Nuri-Wallet-Schlüssel wird direkt auf dem Gerät aus der PRF-Ausgabe des Passkeys abgeleitet und nie auf unserem Server gespeichert. In einem Konto lieferte der Passkey beim Erstellen den Wert A. A wurde zum Wallet-Schlüssel, und auf diesen Schlüssel gingen Mittel ein.
Bei jedem späteren Login lieferte derselbe Passkey den Wert B. B leitet eine andere, leere Wallet ab, sodass die App einen Kontostand von null zeigte. Die Mittel hatten sich nicht bewegt. Die App leitete schlicht eine Wallet ab, zu der das Guthaben nicht gehörte.
Dafür mussten zwei Dinge gleichzeitig schiefgehen: Der Passwortmanager gab zwei verschiedene Antworten für denselben Passkey zurück, und unsere App verglich sie nicht.
Warum PRF trotzdem das richtige Werkzeug bleibt
PRF ist per Design deterministisch. CTAP2 hmac-secret speichert ein zufälliges Geheimnis für das Credential, und die WebAuthn-PRF-Ausgabe wird daraus mit einer festen Formel berechnet: HMAC-SHA256(CredRandom, SHA256("WebAuthn PRF" || 0x00 || salt)). Gleiches Credential, gleiches Salt, gleiches Ergebnis. Genau das macht PRF als Wurzel einer Wallet geeignet.
Unsere Ableitung hat sich zu keinem Zeitpunkt geändert. Salt, HKDF-Parameter und BIP-32-Pfad sind heute identisch mit dem Stand bei Kontoerstellung, und der Schlüssel des betroffenen Nutzers lässt sich weiterhin sauber aus dem ursprünglichen Geheimnis ableiten. Der Fehler lag weder in PRF noch in unserer Ableitung, sondern darin, aus welchem Schritt wir den Wert übernahmen und welche Prüfung fehlte.
Die zwei Fehler
Unser Fehler, und der entscheidende: Beim Signup übernahmen wir die PRF-Ausgabe direkt aus der create()-Antwort und bauten die Wallet darauf auf. Die WebAuthn-Spezifikation erlaubt, dass dieser Wert fehlt, und er ist kein verifiziertes Versprechen für spätere Logins. Wir registrierten und befüllten den Schlüssel, ohne den Passkey ein zweites Mal zu fragen, und beim Login zeigten wir eine leere Wallet statt einer klaren Abweichung. All das ist jetzt behoben.
Der Fehler des Passwortmanagers: Ein Credential lieferte beim Erstellen einen Wert und bei jedem get() einen anderen. Wir haben verifiziert, dass der Create-Wert exakt der Standardformel aus dem gespeicherten Geheimnis entspricht. Der Login-Wert passt zu keiner Berechnung aus diesem Geheimnis. Welche Komponente in der Android-Passkey-Kette das auslöst, untersuchen wir weiter; wir nennen keinen Verursacher, den wir nicht messen können.
Eine ehrliche Einschränkung: Unsere Daten belegen, dass sich der registrierte Schlüssel und die Login-Schlüssel unterscheiden. Sie belegen nicht, ob die Abweichung ab Tag eins bestand oder später auftrat. Die folgenden Prüfungen decken beides ab.
Wie die Mittel wiederhergestellt wurden
Die Wiederherstellung ist der beruhigende Teil der Geschichte. Der Passwortmanager speichert das Geheimnis, aus dem die PRF-Ausgabe berechnet wird. Wir haben das eigene Backup des Nutzers offline entschlüsselt, die Standard-PRF-Formel darauf angewendet und Wert A exakt reproduziert. Mit unserer regulären Ableitung ergab A wieder den ursprünglichen Wallet-Schlüssel.
Wir haben das vor jeder Transaktion bewiesen: Eine Signatur mit dem wiederhergestellten Schlüssel verifiziert, und das neu gebaute Einzahlungs-Skript ergibt exakt die finanzierte Adresse. Anschließend wurden die Mittel on-chain an das gewünschte Ziel des Nutzers gesendet und bestätigt. Zu keinem Zeitpunkt wurde ein privater Schlüssel, eine PRF-Ausgabe oder ein Seed veröffentlicht.
Die Lehre für alle Nutzer: Das Geld war zu keinem Zeitpunkt dem Zugriff Dritter ausgesetzt, weil jeder Ausgabepfad den eigenen Schlüssel des Nutzers verlangt.
Der Fix
Drei Prüfungen, alle günstig.
1. Niemals eine Wallet aus einem Create-PRF ableiten. Nach create() den PRF immer mit einem get() auf dem neuen Credential zurücklesen und diesen Wert verwenden.
2. Vergleichen, bevor etwas registriert oder eingezahlt wird. Wenn create und get voneinander abweichen: abbrechen, nichts registrieren und den Nutzer um einen anderen Passwortmanager bitten.
3. Bei jedem Login den abgeleiteten Schlüssel mit dem für das Credential hinterlegten Schlüssel vergleichen. Bei Abweichung einen klaren Fehler zeigen und einen Support-Weg öffnen. Niemals eine leere Wallet anzeigen und niemals automatisch neu binden. Vor jeder Migration oder Einzahlung noch einmal ableiten und vergleichen.
Der Signup-Vergleich fängt einen Anbieter, der sich selbst widerspricht, sofort ab. Die Prüfungen bei Login und Einzahlung fangen Anbieter ab, deren Antwort sich später ändert.
Der Kern der Signup-Prüfung umfasst wenige Zeilen:
const created = await createWalletPasskeyCredential(rpId, prfSalt);
const assertion = await getAssertion({ rpId, challenge: randomBytes(32), credIdB64u: created.credIdB64u, prfSalt });
const prf = readPrfFirst(assertion);
if (!prf) throw new Error("missing_prf_after_create");
if (created.prfB64 && created.prfB64 !== toBase64(prf)) throw new Error("prf_unstable");
return { ...created, prfB64: toBase64(prf) };
Tests: Ein Mock-Anbieter mit abweichender create- und get-Antwort muss das Signup abbrechen lassen. Ein fester PRF-Vektor muss immer denselben Schlüssel liefern. Eine Anbieter-Matrix muss zeigen, dass create, get und get übereinstimmen. Auf dem Server macht ein täglicher Abgleich zwischen abgeleitetem und gebundenem Schlüssel aus stillem Drift ein Support-Ticket statt einer Überraschung.
Was wir von filekey.app gelernt haben
filekey.app verschlüsselt Dateien mit Schlüsseln aus Passkey-PRF und umgeht die Create-Falle vollständig. Beim Registrieren wird nur geprüft, ob PRF unterstützt wird; der Schlüssel kommt immer aus einem separaten get() mit festem Salt und verpflichtender User Verification. Der Code dokumentiert auch, warum User Verification wichtig ist: Manche Authentifikatoren halten je UV-Status ein anderes Geheimnis.
Quelle: https://github.com/RockwellShah/filekey/blob/HEAD/reference/web/webauthn.ts
Wir haben dieses Modell übernommen und den expliziten Vergleich obendrauf gesetzt, damit ein inkonsistenter Anbieter schon beim Signup auffällt und nicht erst nach einer Einzahlung.
Was andere Teams mitnehmen sollten
- Behandle ein Create-PRF als unverifiziert. Baue nur auf einem Wert auf, den ein get() reproduziert hat.
- Speichere den abgeleiteten öffentlichen Schlüssel neben der Credential-ID und vergleiche ihn bei jedem Login.
- Fail closed. Ein Fehler beim Signup kostet eine zusätzliche Passkey-Abfrage. Ein falscher Schlüssel kostet eine Wiederherstellung.
- Teste den Fehlerfall, nicht nur den Happy Path: Ein Mock-Anbieter, der sich selbst widerspricht, reicht aus.
- Halte die Ableitung stabil und versioniert, damit ein wiederhergestelltes Geheimnis immer dieselbe Wallet rekonstruiert.
Was das für Nuri-Nutzer bedeutet
Deine Schlüssel werden auf deinem Gerät abgeleitet und nicht auf unseren Servern gespeichert. Die Ableitung selbst ist sauber und unverändert. Die betroffenen Mittel wurden wiederhergestellt, und die hier beschriebenen Prüfungen sind jetzt Teil der App, sodass eine Abweichung abgefangen wird, bevor überhaupt eine Wallet entsteht. Du musst nichts tun.
Falls dir jemals ein Kontostand ungewöhnlich erscheint, melde dich beim Support statt eine neue Wallet anzulegen. Genau diesen Fall fangen die neuen Prüfungen jetzt ab.