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

Un inicio de sesión en Buildkite da acceso a tus pipelines de CI/CD, tus compilaciones y tus agentes. La autenticación de dos factores (2FA) añade un código de una app de autenticación además de tu contraseña. Lo único que debes saber antes de empezar: Buildkite te da códigos de recuperación y, si pierdes tanto tu app de autenticación como esos códigos, la vía documentada para volver a entrar es que borren tu cuenta y crear una nueva (Buildkite).

La documentación de Buildkite describe un único método de 2FA: una app de autenticación de terceros. La 2FA es opcional en tu cuenta personal, pero un administrador de la organización puede hacerla obligatoria para todos sus miembros (más abajo). Esta guía usa Authenticator App - Novaz en el iPhone. Cualquier app de autenticación funciona igual.

Cómo comprobamos esta guía: los pasos de Buildkite proceden de la propia documentación de Buildkite, enlazada más abajo, que consultamos el 21 de octubre de 2026. No los hemos probado en una cuenta de Buildkite, así que alguna etiqueta puede variar ligeramente. 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 tutorial de Buildkite sobre la 2FA describe estos pasos en el panel (Buildkite):

1. Abre el menú desplegable bajo tu foto de perfil y selecciona Personal Settings (ajustes personales).
2. Haz clic en Two-Factor Authentication (autenticación de dos factores). Si aparece un campo Confirm Password (confirmar contraseña), introduce tu contraseña de Buildkite y continúa.
3. Haz clic en Setup Two-Factor Authentication (configurar la autenticación de dos factores).
4. Buildkite muestra primero tus códigos de recuperación. Cópialos o descárgalos como archivo de texto, y guárdalos en algún lugar que no sea tu teléfono. Después, continúa.
5. Buildkite muestra un código de barras (un código QR). En Novaz, toca +, luego Escanear código QR, y apunta la cámara hacia él. Si el panel está abierto 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, usa la clave secreta que Buildkite muestra bajo el código de barras. En Novaz, toca + y luego Introducir clave manualmente. Escribe «Buildkite» como Servicio, tu correo como Cuenta si quieres, y la clave secreta como Clave de configuración. Consulta ¿Qué es una clave de configuración de 2FA?
7. Escribe el código de 6 dígitos de Novaz en el campo de Buildkite y haz clic en Activate (activar).

Si ha funcionado, Personal Settings muestra una insignia Enabled (activada) junto a Two-Factor Authentication.

Buildkite dice que sus códigos tienen seis dígitos y cambian aproximadamente cada 30 segundos, lo que coincide con lo que genera Novaz a partir de una clave escrita a mano. Si Novaz no acepta la clave que escribiste, escanea el código QR.

Tus códigos de recuperación son el respaldo

Buildkite te da los códigos de recuperación antes incluso de mostrar el código QR, y su tutorial dice que los guardes en un lugar digital seguro o en papel y que nunca los compartas (Buildkite). Tómate ese paso en serio. Si ese teléfono desaparece y Novaz no tiene copia de seguridad con la Copia en iCloud o un archivo de copia de seguridad, los códigos de recuperación son tu forma de volver a entrar. La documentación no dice cuántos códigos recibes, si cada uno sirve solo una vez ni cómo generar un juego nuevo. Más información en Códigos de respaldo de la 2FA.

Cuándo pide Buildkite un código

Buildkite pide el código actual cuando inicias sesión desde un navegador nuevo, un dispositivo nuevo o una ubicación nueva (Buildkite).

Cuando tu organización exige la 2FA

Un administrador de la organización puede exigir la 2FA a todos los miembros en Settings › Security (ajustes › seguridad), seleccionando Enforce Two-factor authentication (exigir la autenticación de dos factores) y luego Update Access Control (actualizar el control de acceso) (Buildkite). De ahí se derivan algunas cosas:

• Los miembros que no hayan configurado la 2FA pierden al instante el acceso a la organización y a sus pipelines. Configúrala antes de que se active el ajuste.
• Los tokens de acceso a la API existentes siguen funcionando, pero no puedes crear tokens nuevos ni modificar los existentes hasta que hayas activado la 2FA (Buildkite).
• Las organizaciones que exigen el inicio de sesión único (SSO) necesitan en cambio desactivar la exigencia de 2FA, para que no se apliquen las dos a la vez (Buildkite).

Si Buildkite rechaza tu código

La documentación de Buildkite no da consejos para resolver códigos erróneos. La causa más frecuente es un reloj del teléfono que se ha desfasado. En el iPhone, abre Ajustes › General › Fecha y hora y activa Ajuste automático. Novaz también te avisa cuando el reloj va desfasado 15 segundos o más. Encontrarás otras causas en ¿El código de autenticación no funciona?

Cambiar de teléfono

Buildkite dice que puedes volver a configurar o desactivar la 2FA desde la zona Two-Factor Authentication de Personal Settings (Buildkite). La documentación no describe un cambio de teléfono, pero el orden seguro es volver a configurar ahí la 2FA mientras el teléfono antiguo aún te da códigos, y escanear el nuevo código QR con Novaz en el iPhone nuevo. O, si usas la Copia en iCloud o un archivo de copia de seguridad de Novaz, restáuralo en el iPhone nuevo y ahórrate la reconfiguración. 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 2FA en tu teléfono nuevo.

Sin los códigos de recuperación, el tutorial de Buildkite no ofrece ninguna forma de restablecer la 2FA en la cuenta que tienes. Su vía es esta (Buildkite):

1. Pide al administrador de tu organización de Buildkite que elimine tu cuenta de la organización.
2. Escribe a support@buildkite.com y pide que borren tu cuenta.
3. Una vez borrada, crea una cuenta nueva. El tutorial no explica cómo volver a unirte a la organización, así que pregunta a tu administrador.

La documentación no dice qué pruebas pide el soporte ni cuánto tarda el borrado. Para los equipos, la guía de respuesta a incidentes de Buildkite sugiere guardar el secreto de 2FA y los códigos de recuperación de un administrador en un almacén de acceso restringido (Buildkite). Consulta ¿Has perdido el teléfono con tu app de autenticación?

Desactivar la 2FA

Ve a Personal Settings › Two-Factor Authentication para desactivarla (Buildkite). El tutorial no indica los botones exactos. Si tu organización exige la 2FA, desactivarla te dejará sin acceso a esa organización. Después de desactivarla, quita la cuenta de Novaz: ábrela y toca Eliminar cuenta.

Ayuda oficial de Buildkite

• Two-factor authentication (autenticación de dos factores)
• Enforce two-factor authentication (2FA) (exigir la autenticación de dos factores)
• Single sign-on support (compatibilidad con el inicio de sesión único)
• Incident response (respuesta a incidentes)