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

Buddy es la plataforma de CI/CD de buddy.works donde los equipos compilan, prueban y despliegan código mediante pipelines. Antes de buscar el ajuste, comprueba tu plan: la documentación de Buddy dice que la autenticación de dos factores (2FA) no está disponible en el plan gratuito (Buddy). En un plan de pago, cada persona la activa en su propia cuenta, y el propietario o un administrador del espacio de trabajo puede hacerla obligatoria para todos sus miembros.

Buddy ofrece dos métodos: un código por mensaje de texto (SMS) o una app de autenticación. Esta guía trata de la app. Usamos Authenticator App - Novaz en el iPhone, pero cualquier app de autenticación sigue los mismos pasos.

Cómo comprobamos esta guía: los pasos de Buddy proceden de la propia documentación y el blog de Buddy, incluidas las capturas de pantalla de su documentación, enlazados más abajo, que consultamos el 21 de octubre de 2026. No los hemos probado en una cuenta de Buddy, 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 ajuste está en los ajustes de tu cuenta personal, que Buddy llama My ID (mi ID), no en Workspace Settings (ajustes del espacio de trabajo) (Buddy):

1. Abre My ID y ve a la pestaña Security (seguridad).
2. En la sección Two-Factor Authentication (autenticación de dos factores), haz clic en el botón +. Elige Enable authentication app (activar app de autenticación); la otra opción, Enable text message (activar mensaje de texto), es el SMS.
3. Se abre una página llamada Set up 2FA via a third-party authenticator (configura la 2FA con una app de autenticación de terceros) con un código QR. En Novaz, toca +, luego Escanear código QR, y apunta la cámara hacia la pantalla. Si estás viendo Buddy 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.
4. Junto al código QR hay un botón Show code (mostrar código). La documentación de Buddy no lo explica. Si te da una clave en texto, puedes tocar + y luego Introducir clave manualmente en Novaz y pegarla en Clave de configuración. Buddy no dice cuánto duran sus códigos, así que escanear el código QR es la opción más segura. Consulta ¿Qué es una clave de configuración de 2FA?
5. Escribe el código de 6 dígitos de Novaz en Auth code (código de autenticación) y haz clic en Enable 2FA (activar la 2FA).
6. Buddy muestra entonces tus códigos de recuperación (siguiente sección).

Cuando termina, la sección Two-Factor Authentication indica Authenticator App (app de autenticación) como tu método.

Descarga los códigos de recuperación

Buddy crea códigos de recuperación durante la configuración, y la pantalla no te deja continuar hasta que los hayas descargado. La captura de la documentación de Buddy muestra diez códigos de seis dígitos con un botón Download (descargar) y un botón para copiar (Buddy). Buddy sugiere guardarlos en un gestor de contraseñas.

Si no has hecho una copia de seguridad de Novaz con la Copia en iCloud o un archivo de copia de seguridad, sus claves solo existen en tu iPhone, así que estos códigos son lo que te permite entrar si ese teléfono desaparece. Guárdalos en algún lugar lejos del teléfono. Más información en Códigos de respaldo de la 2FA.

Para volver a verlos más adelante, haz clic en + en la sección Two-Factor Authentication y elige Show backup codes (mostrar códigos de respaldo). La opción del menú y el título de la pantalla usan palabras distintas, pero se refieren a los mismos códigos. El anuncio de Buddy de 2018 decía que también podías regenerarlos en cualquier momento desde My ID (Buddy); la documentación actual no menciona la regeneración.

Si tu espacio de trabajo exige la 2FA

Los propietarios y administradores del espacio de trabajo pueden activar Enforce 2FA (exigir la 2FA) en Workspace Settings › Security. A partir de entonces, los miembros que no hayan activado la 2FA no pueden iniciar sesión en el espacio de trabajo (Buddy). Si te quedas bloqueado, configura la 2FA en My ID como se explica arriba.

Con el inicio de sesión único (SSO), los miembros con la 2FA activada inician sesión en su proveedor de identidad y aun así confirman con su método de 2FA de Buddy (Buddy).

Git por HTTPS necesita un token

Si alojas repositorios en el propio Buddy, activar la 2FA cambia la forma en que Git inicia sesión. Desde el 14 de enero de 2022, Buddy ya no acepta tu nombre de usuario y tu contraseña para Git por HTTPS una vez activada la 2FA. Usa en su lugar un token de acceso personal o una clave SSH (Buddy). Ambos se configuran en la misma pestaña Security de My ID.

Si Buddy rechaza tu código

La documentación de Buddy no da consejos sobre códigos rechazados. La mayoría de las veces el reloj del iPhone va desfasado: ve a Ajustes › General › Fecha y hora y activa Ajuste automático. Novaz muestra un aviso cuando el reloj va desfasado 15 segundos o más. Para otras causas, consulta ¿El código de autenticación no funciona?

Teléfono nuevo o teléfono perdido

La documentación de Buddy no describe cómo pasar la 2FA a un teléfono nuevo ni cómo cambiar de la app al SMS. La captura de una cuenta con la 2FA activada muestra un menú (tres puntos) junto a Authenticator App, pero la página no dice qué ofrece. En Novaz, puedes restaurar tus cuentas en el iPhone nuevo desde la Copia en iCloud o un archivo de copia de seguridad. En cualquier caso, conserva el teléfono antiguo hasta que la 2FA de Buddy funcione en el nuevo. Consulta Cómo pasar tu app de autenticación a un iPhone nuevo.

Si pierdes el teléfono, inicia sesión con uno de tus códigos de recuperación. Buddy advierte de que sin esos códigos no podrás volver a entrar en la cuenta si tu dispositivo se pierde o se estropea (Buddy). Su documentación no describe ningún otro proceso de recuperación, prueba de identidad ni plazo. La dirección de soporte que da Buddy es support@buddy.works (Buddy). Más información en ¿Has perdido el teléfono con tu app de autenticación?

Desactivar la 2FA tampoco está documentado.

Ayuda oficial de Buddy

• Security (Buddy docs) (seguridad, documentación de Buddy)
• Single Sign-On (SSO) with SAML & OIDC Identity Providers (inicio de sesión único con proveedores de identidad SAML y OIDC)
• Two-factor authentication (2FA) (blog de Buddy, 2018)
• Changes to Git access in Buddy-hosted repos (2FA accounts only) (cambios en el acceso Git a los repositorios alojados en Buddy; blog de Buddy, 2021)