2FA en Appwrite: cómo configurar una app de autenticación en tu cuenta de la Console

Appwrite tiene dos tipos de autenticación multifactor (MFA), y es fácil acabar en la página equivocada. Uno es una función que integras en tu propia app para tus usuarios. El otro protege tu propia cuenta de desarrollador, la que usas para iniciar sesión en la Appwrite Console y gestionar tus organizaciones y proyectos. Esta guía trata del segundo (Appwrite). Si quieres MFA para las personas que usan tu app, Appwrite lo explica en su documentación de Auth.

Para tu cuenta de la Console, la MFA es opcional. La documentación de Appwrite indica como método admitido un código basado en tiempo de una app de autenticación (TOTP) y dice que más adelante llegarán otros factores (Appwrite). En los pasos siguientes usamos Authenticator App - Novaz en el iPhone, pero cualquier app de autenticación funciona igual.

Cómo comprobamos esta guía: los pasos de Appwrite proceden de su propia documentación y sus capturas de pantalla, enlazadas más abajo, que consultamos el 21 de octubre de 2026. No los hemos probado en una cuenta de Appwrite, así que alguna etiqueta puede variar ligeramente. Los pasos de Novaz están comprobados en la app, versión 1.0.5.

Activar la MFA con una app de autenticación

La página de Appwrite es breve, y su texto y sus capturas usan etiquetas algo distintas. Estos pasos siguen ambos (Appwrite):

1. Inicia sesión en la Appwrite Console. Abre el menú de tu cuenta, arriba a la derecha, y elige Your account (tu cuenta).
2. Ve a los ajustes de seguridad. En la captura de Appwrite, es Security (seguridad) en la lista de la izquierda, con una tarjeta Multi-factor authentication (autenticación multifactor) en la página.
3. Activa el interruptor Multi-factor authentication.
4. Añade la app de autenticación. El texto llama al botón Add authentication factor (añadir factor de autenticación); la captura muestra una fila Authenticator app (app de autenticación) con un botón Add (añadir).
5. Se abre una ventana Scan QR code (escanear código QR). En Novaz, toca +, luego Escanear código QR, y apunta la cámara hacia el código. Si la Console está abierta en el mismo iPhone, haz una captura de pantalla y usa Elegir una foto. Consulta cómo escanear un código QR en el mismo iPhone.
6. Si no puedes escanearlo, la misma ventana muestra un Manual entry code (código de entrada manual) con un botón para copiarlo. En Novaz, toca +, luego Introducir clave manualmente, escribe un nombre como Appwrite en Servicio y pega el código en Clave de configuración. Consulta ¿Qué es una clave de configuración de 2FA?
7. Elige Continue (continuar) y escribe el código actual de Novaz para terminar la configuración.
8. Guarda tus códigos de recuperación (siguiente sección).

La documentación no dice cuántos dígitos tienen los códigos ni cada cuánto cambian. Escanear el código QR es la opción más segura, porque transmite esos ajustes a tu app. Una clave escrita a mano te da códigos de 6 dígitos cada 30 segundos.

Los códigos de recuperación son tu única vía de vuelta

Appwrite es inusualmente tajante en esto. Su documentación llama a los códigos de recuperación «the only way to access your account if you lose access to your authenticator app» (la única forma de acceder a tu cuenta si pierdes el acceso a tu app de autenticación) (Appwrite). No describe ninguna vía de soporte para una cuenta de la Console bloqueada.

Su captura muestra una fila Recovery codes (códigos de recuperación) con un botón View (ver) en la misma página de ajustes, así que puedes volver a consultarlos mientras sigas con la sesión iniciada. Guarda una copia en algún sitio que no sea tu teléfono, como un gestor de contraseñas o una copia impresa. Si no tienes copia de seguridad de Novaz, o es anterior a tu cuenta de Appwrite, estos códigos son tu forma de volver a entrar. Más información en Códigos de respaldo de la 2FA.

La misma captura también incluye Email (correo) como factor, con códigos de un solo uso enviados a la dirección verificada de la cuenta. El texto de la página solo menciona la app de autenticación, así que, con la documentación en la mano, no podemos decirte si los códigos por correo sirven como alternativa al iniciar sesión.

Si Appwrite rechaza tu código

La documentación de Appwrite no trata los códigos rechazados. La causa más común es el reloj del iPhone: abre Ajustes › General › Fecha y hora y activa Ajuste automático. Novaz también te avisa cuando el reloj tiene un desfase de 15 segundos o más. Si escribiste la clave a mano, comprueba que la copiaste entera. Otras causas en ¿El código de autenticación no funciona?

Cambiar de teléfono

Appwrite no documenta cómo pasar la MFA a un teléfono nuevo, cómo sustituir la app de autenticación ni cómo desactivar la MFA. Haz cualquiera de estas cosas mientras aún puedas iniciar sesión con el teléfono antiguo, desde la misma tarjeta Multi-factor authentication. Si activaste la Copia en iCloud de Novaz o exportaste un archivo de copia de seguridad, puedes restaurar Appwrite en el teléfono nuevo; sin ella, tendrás que añadirla en el teléfono nuevo como una cuenta nueva. Consulta Cómo pasar tu app de autenticación a un iPhone nuevo.

Si pierdes tu app de autenticación

Inicia sesión con uno de tus códigos de recuperación y vuelve a configurar la app de autenticación en tu teléfono nuevo. Sin los códigos de recuperación, la documentación de Appwrite no ofrece ninguna otra vía para volver a entrar en la cuenta. Más información en ¿Has perdido el teléfono con tu app de autenticación?

Ayuda oficial de Appwrite

• Multi-factor authentication (tu cuenta de la Console)
• Multi-factor authentication (Appwrite Auth, para los usuarios de tu app)
• Security (seguridad)