2FA en Bitrise: cómo configurar una app de autenticación

Bitrise es una plataforma de CI/CD para apps móviles: tu cuenta personal de Bitrise te da acceso a los workspaces y proyectos donde se compilan tus apps de iOS y Android. La autenticación de dos factores (2FA) es opcional y usa una app de autenticación. Antes de activarla, ten clara una cosa sobre Bitrise: si pierdes tanto tu app de autenticación como tus códigos de recuperación, Bitrise dice que, por lo general, su equipo de soporte no puede quitarte la 2FA (Bitrise). Por eso esta guía dedica tanto espacio al plan de respaldo como a la configuración.

La documentación de Bitrise menciona Google Authenticator, pero la configuración es un código QR estándar, así que sirve cualquier app de autenticación. En los pasos siguientes usamos Authenticator App - Novaz en el iPhone.

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

Activar la 2FA con una app de autenticación

El ajuste está en tu cuenta personal, no en un workspace (Bitrise):

1. Inicia sesión en Bitrise y elige Bitrise CI en el menú de navegación de la izquierda.
2. Haz clic en tu imagen de perfil en la esquina superior derecha y elige Account settings (ajustes de la cuenta).
3. Elige Security (seguridad) a la izquierda.
4. En Two-factor authentication (autenticación de dos factores), haz clic en el interruptor 2FA is enabled (2FA activada). (La documentación de Bitrise usa esa etiqueta tanto para activarla como para desactivarla).
5. Aparece un código QR. En Novaz, toca +, luego Escanear código QR, y apunta la cámara hacia él. Si el código QR está 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. Escribe en Bitrise el código de 6 dígitos de Novaz.
7. Guarda los códigos de recuperación que te da Bitrise.

Cuando la 2FA está activada y tus códigos de recuperación están guardados, Bitrise envía un correo de confirmación desde letsconnect@bitrise.io.

La página de Bitrise no menciona una clave en texto que puedas escribir en lugar de escanear. Si encuentras una en la pantalla de configuración, en Novaz toca +, luego Introducir clave manualmente, y pégala como Clave de configuración. Consulta ¿Qué es una clave de configuración de 2FA?

Tus códigos de recuperación son la verdadera copia de respaldo

Sin una copia de seguridad de Novaz (Copia en iCloud o un archivo de copia de seguridad), sus claves solo existen en tu iPhone y, en cualquier caso, los códigos de recuperación son tu única alternativa dentro de Bitrise. Guárdalos en un gestor de contraseñas o imprímelos, y mantenlos lejos del teléfono.

La captura de Bitrise de la página Security muestra una sección Recovery codes (códigos de recuperación) con un botón New recovery codes (nuevos códigos de recuperación), que es donde obtendrías una serie nueva. El texto de la página no explica cuántos códigos recibes ni qué pasa con los antiguos. Más información sobre cómo guardarlos en Códigos de respaldo de 2FA.

Cuándo pide Bitrise un código

Bitrise describe la 2FA como un paso más en el proceso de inicio de sesión (Bitrise). Su documentación no dice si puedes marcar un navegador como de confianza ni con qué frecuencia te lo pedirá.

Si tu workspace exige SAML SSO, inicias sesión a través del proveedor de identidad de tu empresa, y ese proveedor puede aplicar sus propias reglas de 2FA (Bitrise). En ese caso, la configuración de tu empresa decide cómo demuestras que eres tú.

Si Bitrise rechaza tu código

La documentación de Bitrise no trata los códigos rechazados. La causa más frecuente es el reloj del iPhone: abre Ajustes › General › Fecha y hora y activa Ajuste automático. Novaz te avisa cuando el reloj va desfasado 15 segundos o más. Ten en cuenta también que varios inicios de sesión fallidos seguidos pueden bloquear tu cuenta de Bitrise, y entonces Bitrise te envía por correo instrucciones para desbloquearla (Bitrise). Encontrarás otras causas en ¿El código de autenticación no funciona?

Cambiar de teléfono

Bitrise no describe ninguna forma de pasar la 2FA a un teléfono nuevo. Con una Copia en iCloud o un archivo de copia de seguridad de Novaz, basta con restaurar tus cuentas en el iPhone nuevo. Sin ninguno de los dos, ten en cuenta que, según la documentación de Bitrise, para desactivar la 2FA con la sesión iniciada solo se pide tu contraseña de Bitrise; así que, mientras todavía tengas el teléfono antiguo, puedes desactivar la 2FA, volver a activarla y escanear el nuevo código QR con el iPhone nuevo. Guarda los nuevos códigos de recuperación. Consulta Cómo transferir tu app de autenticación a un iPhone nuevo.

Si pierdes tu app de autenticación

Empieza por un código de recuperación. Sin ninguno, tus opciones son limitadas (Bitrise):

• Una cuenta de Git conectada. Si antes vinculaste GitHub, GitLab o Bitbucket a Bitrise, Bitrise sugiere intentar iniciar sesión a través de ella. Puedes conectarlas desde tu cuenta (Bitrise), y merece la pena hacerlo antes de necesitarlo.
• El soporte de Bitrise, en casos excepcionales. Bitrise solo puede quitar la 2FA si ya hay una cuenta de un proveedor de Git conectada. Escribe al soporte desde la dirección con la que te registraste y explica el motivo. El soporte te pedirá que crees en esa cuenta de Git un repositorio público nuevo llamado bitrise_verification y que le envíes el enlace. Aun así, pueden negarse si quitar la 2FA parece un riesgo de seguridad.
• Una cuenta nueva. Si no tienes ninguna cuenta de Git conectada, Bitrise recomienda crear una cuenta de Bitrise nueva.

Bitrise no dice cuánto tarda una solicitud al soporte. Más información en ¿Has perdido el teléfono con tu app de autenticación?

Desactivar la 2FA

Ve a Account settings › Security, haz clic en 2FA is enabled en Two-factor authentication, escribe tu contraseña de Bitrise en la ventana Edit profile (editar perfil) y haz clic en Done (listo) (Bitrise). Después abre la entrada de Bitrise en Novaz y toca Eliminar cuenta.

Ayuda oficial de Bitrise

• Two-factor authentication (autenticación de dos factores)
• Accounts overview (información general sobre las cuentas)
• Configuring SAML SSO on Bitrise (configurar SAML SSO en Bitrise)
• Resetting your password (restablecer tu contraseña)