Postmortem de ingeniería

Una passkey, dos claves: lo que aprendimos sobre PRF y la corrección que protege cada nueva wallet

Dos claves derivadas de una passkey con una marca de verificación que confirma que coinciden

TL;DR: WebAuthn PRF es una forma segura y determinista de derivar la clave de una wallet: la misma passkey y la misma sal producen siempre el mismo secreto. Encontramos un caso en el que un gestor de contraseñas devolvió un valor al crear la passkey y otro distinto en cada inicio de sesión posterior. Nuestro error fue confiar en el valor del alta sin verificar que el inicio de sesión lo reprodujera. Los fondos se recuperaron y están a salvo. La corrección consiste en una prueba de estabilidad al registrarse, una comparación de clave en cada inicio de sesión y una comprobación adicional antes de mover fondos.

Autor Emin Mahrt

6 minutos de lectura

Esta publicación también está disponible en English , Deutsch y Italiano .

Qué ocurrió

La clave de una wallet Nuri se deriva en el dispositivo del usuario a partir de la salida PRF de la passkey y nunca se guarda en nuestro servidor. En una cuenta, la passkey devolvió el valor A al crearse. A se convirtió en la clave de la wallet y recibió fondos.

En cada inicio de sesión posterior, la misma passkey devolvió el valor B. B deriva otra wallet vacía, así que la app mostraba saldo cero. Los fondos no se habían movido: la app simplemente derivaba una wallet distinta.

Tuvieron que fallar dos cosas a la vez: el gestor de contraseñas devolvió dos respuestas distintas para la misma passkey y nuestra app no las comparó.

Por qué PRF sigue siendo la herramienta adecuada

PRF es determinista por diseño. CTAP2 hmac-secret guarda un secreto aleatorio para la credencial y la salida WebAuthn PRF se calcula con una fórmula fija: HMAC-SHA256(CredRandom, SHA256("WebAuthn PRF" || 0x00 || salt)). Misma credencial, misma sal, misma salida.

Nuestra derivación no cambió en ningún momento. La sal, los parámetros HKDF y la ruta BIP-32 siguen siendo idénticos a cuando se creó la cuenta, y la clave del usuario afectado sigue derivándose correctamente del secreto original. El fallo no estuvo en PRF ni en nuestra derivación, sino en el paso del que tomamos el valor y en la comprobación que faltaba.

Los dos errores

El nuestro, y el más importante: durante el registro tomamos la salida PRF de create() y construimos la wallet sobre ella. La especificación WebAuthn permite que ese valor falte y no garantiza nada sobre inicios de sesión futuros. Registramos y fondeamos la clave sin consultar la passkey una segunda vez, y al iniciar sesión mostramos una wallet vacía en lugar de avisar de una discrepancia. Todo eso ya está corregido.

El del gestor de contraseñas: una credencial devolvió un valor al crearse y otro en cada get(). Verificamos que el valor de creación coincide exactamente con la fórmula estándar aplicada al secreto almacenado. El valor de inicio de sesión no coincide con ningún cálculo a partir de ese secreto. Seguimos investigando qué componente de la cadena passkey en Android lo provoca.

Una limitación honesta: nuestros registros prueban que la clave registrada y las de inicio de sesión difieren, pero no si la divergencia existía desde el primer día o apareció después. Las comprobaciones siguientes cubren ambos casos.

Cómo se recuperaron los fondos

La recuperación es la parte tranquilizadora. El gestor de contraseñas conserva el secreto del que se deriva la salida PRF. Desciframos sin conexión la copia de seguridad del propio usuario, aplicamos la fórmula PRF estándar y reprodujimos exactamente el valor A. Al pasar A por nuestra derivación normal reapareció la clave original.

Lo demostramos antes de mover nada: una firma con la clave recuperada verifica y el script reconstruido reproduce exactamente la dirección financiada. Luego los fondos se enviaron on-chain al destino elegido por el usuario y se confirmaron. Nunca se publicó ninguna clave privada, salida PRF ni semilla.

La lección para todos los usuarios: el dinero nunca corrió riesgo de ser tomado por terceros, porque cada gasto exige la clave del propio usuario.

La corrección

Tres comprobaciones, todas baratas.

1. No derivar nunca una wallet desde un PRF de create(). Después de create(), leer siempre el PRF con un get() sobre la nueva credencial y usar ese valor.

2. Comparar antes de registrar o recibir fondos. Si create y get discrepan, detenerse, no registrar nada y pedir al usuario otro gestor de contraseñas.

3. En cada inicio de sesión, comparar la clave derivada con la clave guardada para esa credencial. Si no coinciden, mostrar un error claro y abrir soporte. Nunca mostrar una wallet vacía ni revincular automáticamente. Antes de cualquier migración o depósito, volver a derivar y comparar.

La comparación en el registro detecta de inmediato un proveedor inconsistente. Las de inicio de sesión y depósito detectan si su respuesta cambia más adelante.

El núcleo de la comprobación de registro son unas pocas líneas:

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) };

Pruebas: un proveedor simulado cuyas respuestas de create y get difieran debe hacer fallar el registro. Un vector PRF fijo debe producir siempre la misma clave. En el servidor, una comparación diaria entre la clave derivada y la vinculada convierte cualquier deriva silenciosa en un ticket de soporte.

Lo que aprendimos de filekey.app

filekey.app cifra archivos con claves derivadas de passkey PRF y evita por completo la trampa de create(). Su registro solo comprueba soporte PRF y la clave siempre llega desde un get() independiente con sal fija y verificación de usuario obligatoria.

Fuente: https://github.com/RockwellShah/filekey/blob/HEAD/reference/web/webauthn.ts

Adoptamos ese modelo y añadimos la comparación explícita encima, para detectar un proveedor que se contradice en el alta y no después de un depósito.

Qué deberían llevarse otros equipos

- Trata un PRF de create() como no verificado. Construye solo sobre un valor que un get() haya reproducido.

- Guarda la clave pública derivada junto al id de la credencial y compárala en cada inicio de sesión.

- Falla cerrado. Un error en el registro cuesta un toque extra de passkey; una clave equivocada cuesta una recuperación.

- Prueba el fallo, no solo el camino feliz: basta un proveedor simulado que se contradiga.

- Mantén la derivación estable y versionada para que un secreto recuperado reconstruya siempre la misma wallet.

Qué significa esto para los usuarios de Nuri

Tus claves se derivan en tu dispositivo y no se guardan en nuestros servidores. La derivación sigue intacta. Los fondos afectados se recuperaron y las comprobaciones descritas ya forman parte de la app. No hace falta ninguna acción por tu parte.

Si alguna vez ves un saldo que no cuadra, contacta con soporte en lugar de crear una wallet nueva.

PRF es determinista y seguro cuando se verifica su valor. Tres comprobaciones garantizan ahora que cualquier discrepancia se detecte al registrarse, al iniciar sesión y antes de mover fondos.

Emin Mahrt · Verificación