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

Assembla aloja repositorios de Perforce, Subversion y Git junto con herramientas de gestión de proyectos (Assembla), así que tu acceso a Assembla suele proteger código fuente. Admite autenticación de dos factores (2FA) con una app de autenticación, y el propietario de un portfolio puede hacerla obligatoria para todo el portfolio. Hay dos cosas que la distinguen. La pantalla de configuración te da un código QR y nada más, sin ninguna clave para escribir. Y, una vez activada la 2FA, tu contraseña deja de funcionar en los clientes de repositorios (Assembla).

Esta guía usa Authenticator App - Novaz en el iPhone. Cualquier app de autenticación que genere códigos basados en tiempo funciona igual.

Cómo comprobamos esta guía: los pasos de Assembla proceden de su propio centro de ayuda, incluida la captura de pantalla de su artículo sobre la 2FA, enlazado más abajo, que consultamos el 21 de octubre de 2026. No los hemos probado en una cuenta de Assembla, así que alguna etiqueta puede variar ligeramente. Los pasos de Novaz están comprobados en la app, versión 1.0.5.

Antes de empezar

• ¿Inicias sesión con SSO? Assembla dice que una cuenta que usa inicio de sesión único no tiene contraseña, y sin ella no puedes activar la 2FA propia de Assembla (Assembla).
• Google 2FA en tu portfolio: el mismo artículo señala que, si un portfolio exige la 2FA de Google, ese método tiene prioridad. No explica nada más.
• La lista de apps es antigua. La lista de Assembla todavía incluye Windows Phone, pero sus códigos son códigos estándar basados en tiempo, así que Novaz puede escanear el mismo código QR.

Activar la 2FA con una app de autenticación

La ayuda de Assembla describe estos pasos (Assembla):

1. Haz clic en tu avatar, en la parte superior de la página.
2. Elige My Profile (mi perfil) › Two-factor authentication (autenticación de dos factores). La página indica que la autenticación de dos factores está desactivada y muestra un código QR.
3. En Novaz, toca +, luego Escanear código QR, y apunta la cámara hacia el código en la pantalla de tu equipo. Si Assembla está abierto 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. En Confirm current password (confirma la contraseña actual), escribe tu contraseña de Assembla.
5. En Enter the six-digit code from the application (introduce el código de seis dígitos de la app), escribe el código actual de Novaz.
6. Haz clic en Enable (activar).
7. Guarda el archivo con el código de recuperación que te da Assembla. Es tu forma de volver a entrar si pierdes el teléfono.

Sin clave de configuración en la página

La pantalla de Assembla no muestra ninguna clave en texto. Su ayuda sugiere un truco si tu teléfono no puede escanear: decodificar el código QR con otra app lectora, como un lector de QR de escritorio, para obtener un enlace otpauth://. La parte secret= de ese enlace es la clave. En Novaz, la escribirías en + › Introducir clave manualmente como Clave de configuración. Consulta ¿Qué es una clave de configuración de 2FA?

Con Novaz es más sencillo escanear. Una clave escrita a mano necesita al menos 16 caracteres, y Assembla no dice qué longitud tiene su clave.

Tu archivo de códigos de recuperación

Assembla te da un archivo de códigos de recuperación cuando activas la 2FA. Si pierdes el teléfono y no tienes copia de seguridad de Novaz, o añadiste Assembla después de tu último archivo de copia de seguridad, este archivo es tu forma de volver a entrar. Guárdalo en algún sitio al que puedas acceder sin ese teléfono. La ayuda de Assembla no dice cuántos códigos contiene el archivo ni cómo obtener un juego nuevo. Más información en Códigos de respaldo de la 2FA.

Clientes de Git, SVN y Perforce

Con la 2FA activada, los clientes externos no pueden descargar código ni hacer commits con tu nombre de usuario y tu contraseña. Crea en su lugar una clave de API (Assembla, Assembla):

1. Haz clic en tu avatar y luego en My Profile › API Applications & Sessions (aplicaciones y sesiones de API).
2. Marca Repository access (acceso a repositorios) y haz clic en Create (crear).
3. En tu cliente, inicia sesión con tu nombre de usuario de Assembla y el secreto de API en lugar de la contraseña.

Cuando es obligatoria

Si un administrador del portfolio activa el requisito (More (más) › Portfolio Admin (administración del portfolio), luego Enabled (activado) en la sección Two-factor Authentication y Update 2FA Settings (actualizar los ajustes de 2FA)), los miembros sin 2FA deben configurarla en su siguiente inicio de sesión. Hasta que lo hagan, no pueden entrar en Assembla en absoluto (Assembla).

Si Assembla rechaza tu código

La ayuda de Assembla no da consejos sobre códigos rechazados. La causa más común es un reloj del teléfono desfasado. En el iPhone, abre Ajustes › General › Fecha y hora y activa Ajuste automático. Novaz muestra un aviso cuando el reloj tiene un desfase de 15 segundos o más. Más causas en ¿El código de autenticación no funciona?

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

Assembla resuelve los tres casos de la misma forma: desactiva la 2FA y vuelve a activarla con el dispositivo nuevo (Assembla).

1. Haz clic en tu avatar y luego en My Profile › Two-factor Authentication.
2. Escribe tu contraseña en Confirm current password.
3. En Enter the six-digit code from the application, escribe un código. Si has perdido el teléfono, Assembla dice que en este campo va un código de recuperación sin usar.
4. Haz clic en Disable (desactivar). Después puedes volver a configurar la 2FA.

Si cambias de teléfono sin copia de seguridad de Novaz, hazlo mientras el iPhone antiguo siga funcionando. Con la Copia en iCloud o un archivo de copia de seguridad, puedes restaurar tus cuentas en el iPhone nuevo. Consulta Cómo pasar tu app de autenticación a un iPhone nuevo.

Si has perdido a la vez el teléfono y el archivo de recuperación, Assembla te pide que escribas a support@assembla.com para restablecer tu cuenta. Su ayuda no dice qué pruebas pide el soporte ni cuánto tarda. Consulta también ¿Has perdido el teléfono con tu app de autenticación?

Ayuda oficial de Assembla

• Using Two-Factor Authentication with your Assembla Account (usar la autenticación de dos factores en tu cuenta de Assembla)
• Working on my Repos with Third Party Authentication (trabajar con mis repositorios con autenticación de terceros)
• Assembla: Managed Cloud Hosting For Perforce, SVN & Git (alojamiento gestionado en la nube para Perforce, SVN y Git)