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

AppVeyor es un servicio de integración continua que compila y prueba código, sobre todo de proyectos para Windows. Puedes iniciar sesión con un botón de GitHub, Bitbucket o GitLab, o con una dirección de correo y una contraseña de AppVeyor. La autenticación de dos factores (2FA) pertenece a ese segundo tipo de inicio de sesión: protege el acceso con correo y contraseña, y el único método que describe AppVeyor es un código de una app de autenticación, respaldado por códigos de recuperación de un solo uso (AppVeyor). Es opcional para ti, salvo que una cuenta en la que trabajas la exija. Esta guía usa Authenticator App - Novaz en el iPhone, pero cualquier app de autenticación funciona igual.

Cómo comprobamos esta guía: los pasos de AppVeyor proceden de la entrada de su propio blog que anunciaba la 2FA, capturas de pantalla incluidas, y de sus notas de la versión, que consultamos el 21 de octubre de 2026. Esa entrada es de noviembre de 2018 y AppVeyor no ha publicado ninguna página de ayuda más reciente sobre la 2FA, así que las pantallas pueden haber cambiado desde entonces. No hemos probado los pasos en una cuenta de AppVeyor. Los pasos de Novaz están comprobados en la app, versión 1.0.5.

El botón de inicio de sesión importa

La 2FA de AppVeyor solo entra en juego cuando inicias sesión con correo y contraseña. Si inicias sesión con GitHub, Bitbucket, GitLab o lo que las pantallas de AppVeyor llaman Visual Studio Team Services, AppVeyor no te pide su propio código. Ese inicio de sesión es tan seguro como tu cuenta en ese servicio, así que activa también allí la 2FA (AppVeyor).

Activar la 2FA con una app de autenticación

El anuncio de AppVeyor describe estos pasos (AppVeyor):

1. Inicia sesión en AppVeyor y abre My profile (mi perfil) y después la pestaña Security (seguridad).
2. En Two-Factor authentication (2FA) (autenticación de dos factores), haz clic en Enable 2FA (activar 2FA).
3. Se abre la página Enable two-factor authentication (activar la autenticación de dos factores). Su primer paso, Scan this barcode with your auth app (escanea este código con tu app de autenticación), muestra un código QR. En Novaz, toca +, luego Escanear código QR, y apunta la cámara hacia él. Si la página está abierta en el mismo iPhone, haz una captura de pantalla, toca + y luego Elegir una foto. Consulta cómo escanear un código QR en el mismo iPhone.
4. Si no puedes escanearlo, AppVeyor muestra una clave en texto bajo el código QR. En Novaz, toca +, luego Introducir clave manualmente, escribe AppVeyor como Servicio y la clave como Clave de configuración. Consulta ¿Qué es una clave de configuración de 2FA?
5. En Enter 6-digit code from auth app (introduce el código de 6 dígitos de la app de autenticación), escribe el código que muestra Novaz para AppVeyor. La pantalla de configuración dice que estos códigos tienen 6 dígitos y cambian cada 30 segundos, lo que coincide con lo que genera Novaz a partir de una clave escrita a mano.
6. En Save recovery codes (guarda los códigos de recuperación), copia los códigos antes de continuar.
7. Haz clic en Enable 2FA.

Guarda los códigos de recuperación

AppVeyor muestra los códigos de recuperación en la propia página de configuración, junto al botón que la completa. El anuncio explica que cada código te permite superar una vez el paso de la 2FA, para cuando no tengas el teléfono a mano (AppVeyor). No describe ninguna forma de volver a verlos ni de generar otros más adelante, así que considera esa página tu única oportunidad.

Aunque hagas copia de seguridad de Novaz, estos códigos son tu forma de entrar si pierdes el teléfono y la copia no existe o está desactualizada, así que guárdalos en un gestor de contraseñas o en papel, lejos del teléfono. Más información en Códigos de respaldo de la 2FA.

Iniciar sesión después

Después de tu correo y tu contraseña, la página de inicio de sesión muestra un panel Two-factor authentication. Escribe el código actual de Novaz en Authentication code (código de autenticación) y haz clic en Verify code (verificar código). Si no tienes el teléfono, el mismo campo acepta uno de tus códigos de recuperación (AppVeyor).

Cuando una cuenta exige la 2FA

El administrador de una cuenta de AppVeyor puede hacer obligatoria la 2FA. En los ajustes de la cuenta, la página Security tiene una casilla, Require two-factor authentication for users accessing this account with email/password (exigir la autenticación de dos factores a los usuarios que accedan a esta cuenta con correo y contraseña), que se guarda con Update settings (actualizar ajustes). Si has iniciado sesión con correo y contraseña pero aún no tienes la 2FA, AppVeyor te envía a la página de configuración en cuanto abres los recursos de esa cuenta (AppVeyor).

La misma página incluye Allowed authentication methods (métodos de autenticación permitidos). Como los inicios de sesión con GitHub, Bitbucket y GitLab se saltan la comprobación, AppVeyor sugiere dejar marcado solo Email/password (correo/contraseña) cuando el requisito deba aplicarse a todos, salvo que esos servicios puedan configurarse para exigir la 2FA por su cuenta. La versión autoalojada de AppVeyor recibió la misma función en AppVeyor Enterprise 6.3.0, publicada el 15 de enero de 2019 (AppVeyor).

Si AppVeyor rechaza tu código

AppVeyor no publica consejos sobre códigos rechazados. La causa habitual es el reloj del iPhone: abre Ajustes › General › Fecha y hora y activa Ajuste automático. Novaz te avisa cuando el reloj tiene un desfase de 15 segundos o más. Otras causas en ¿El código de autenticación no funciona?

Teléfono nuevo, teléfono perdido o desactivar la 2FA

El anuncio de la 2FA de AppVeyor no explica cómo pasar la 2FA a otro teléfono, cómo desactivarla ni qué ocurre si pierdes a la vez el teléfono y los códigos de recuperación. Con la Copia en iCloud de Novaz o un archivo de copia de seguridad, puedes restaurar tus cuentas en el iPhone nuevo y conservar los mismos códigos. Sin ella, antes de deshacerte del teléfono antiguo, inicia sesión y busca en la pestaña Security de My profile una forma de desactivar la 2FA y volver a configurarla. Consulta Cómo pasar tu app de autenticación a un iPhone nuevo.

Si has perdido el teléfono, inicia sesión con un código de recuperación. Sin ninguno, el único contacto que indica AppVeyor es el soporte general por correo en support@appveyor.com. Su página de soporte se propone responder en 24 horas los días laborables, pero no dice nada concreto sobre la 2FA ni sobre qué pruebas pide (AppVeyor). Más información en ¿Has perdido el teléfono con tu app de autenticación?

Páginas oficiales de AppVeyor

• 2FA comes to AppVeyor (llega la 2FA a AppVeyor)
• AppVeyor Enterprise 6.3.0 release notes (notas de la versión de AppVeyor Enterprise 6.3.0)
• Support (soporte)