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

Codeberg aloja repositorios de Git y funciona con el software de forja Forgejo (Codeberg). La autenticación de dos factores (2FA) es opcional, pero la documentación de Codeberg sugiere activarla poco después de registrarte (Codeberg). La documentación describe dos métodos: códigos de una app de autenticación, que Codeberg llama TOTP, y llaves de seguridad físicas, que añades una vez configurado el TOTP.

Hay dos detalles importantes antes de empezar: recibes una sola clave de recuperación, no una lista de códigos de respaldo, y restablecer la contraseña no te permite saltarte la 2FA. 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 Codeberg proceden de su documentación y del código fuente de la versión de Forgejo que ejecuta hoy codeberg.org, que Codeberg publica en su propio sitio, todo enlazado más abajo. Los consultamos el 20 y el 21 de octubre de 2026. Las capturas de pantalla de la documentación de Codeberg son anteriores a las pantallas actuales, así que las etiquetas que damos aquí proceden del código actual. No hemos probado los pasos en una cuenta de Codeberg, 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

Estos pasos siguen la guía de Codeberg, con las etiquetas actuales (Codeberg, Codeberg source):

1. Inicia sesión en codeberg.org, abre el menú bajo tu avatar, arriba a la derecha, y elige Settings (ajustes).
2. Elige Security (seguridad).
3. En la sección Two-factor authentication (TOTP) (autenticación de dos factores), selecciona Enroll into two-factor authentication (inscribirse en la autenticación de dos factores).
4. Codeberg muestra 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, toca + y luego Elegir una foto. Consulta cómo escanear un código QR en el mismo iPhone.
5. Si prefieres escribir la clave, la encontrarás después de Or enter the secret: (o introduce el secreto:). En Novaz, toca + y luego Introducir clave manualmente. Escribe Codeberg como Servicio, tu nombre de usuario como Cuenta y el secreto como Clave de configuración. El secreto tiene 64 caracteres, así que es más fácil escanear. Consulta ¿Qué es una clave de configuración de 2FA?
6. Escribe el código de 6 dígitos de Novaz en Passcode (código) y selecciona Verify (verificar).
7. Vuelves a la página Security. Un mensaje verde contiene tu clave de recuperación de un solo uso, entre paréntesis. Cópiala ahora: Codeberg no volverá a mostrarla.

La sección debería indicar ahora que tu cuenta está enrolled (inscrita). Codeberg te envía un correo cada vez que se activa o desactiva el TOTP (Codeberg source).

Una clave de recuperación con tres nombres

La documentación de Codeberg la llama scratch token, la página de ajustes la llama single-use recovery key (clave de recuperación de un solo uso) y la pantalla de inicio de sesión la llama scratch code. Es un único código y sirve una vez. Después de usarlo, Codeberg te lleva a tus ajustes de seguridad para generar uno nuevo (Codeberg source). También puedes sustituirlo en cualquier momento con Regenerate single-use recovery key (regenerar la clave de recuperación de un solo uso), que anula la anterior.

Si pierdes el teléfono y no tienes ninguna copia de Novaz que restaurar, esta clave es tu única forma de volver a entrar. Guárdala en un gestor de contraseñas o en papel. Más información en Códigos de respaldo de 2FA.

Iniciar sesión, y Git después de la 2FA

Codeberg te pide un código cada vez que inicias sesión (Codeberg). Escríbelo en Passcode y selecciona Verify, o elige Use a scratch code (usar un código de recuperación). Si has añadido una llave de seguridad, puedes elegir entre la llave y un código.

Para Git por SSH, no cambia nada. Por HTTPS, tu contraseña deja de funcionar para Git, así que crea un token de acceso en Settings > Applications (aplicaciones) y úsalo como contraseña (Codeberg). Codeberg muestra cada token una sola vez.

Si Codeberg rechaza tu código

Codeberg acepta el código del intervalo actual de 30 segundos y el del anterior, lo que te da al menos 30 segundos (Codeberg). Un código que acaba de funcionar no se puede volver a usar, así que espera al siguiente (Codeberg source). Si fallan todos los códigos, revisa el reloj del iPhone: Ajustes › General › Fecha y hora › Ajuste automático. Novaz te avisa cuando el reloj va desfasado 15 segundos o más. Más información en ¿El código de autenticación no funciona?

Cambiar de teléfono

Hazlo mientras todavía tengas el teléfono antiguo. En la página Security, selecciona Re-enroll two-factor authentication (volver a inscribirse en la autenticación de dos factores), escanea el nuevo código QR con Novaz en el iPhone nuevo y verifica un código. Esto sustituye la configuración anterior y te da una clave de recuperación nueva (Codeberg source). Después, comprueba que la página sigue indicando enrolled. Si tienes una Copia en iCloud o un archivo de copia de seguridad de Novaz, puedes restaurar tus cuentas en el iPhone nuevo y conservar la configuración actual. Consulta Cómo pasar tu app de autenticación a un iPhone nuevo.

Si pierdes tu app de autenticación

Inicia sesión con Use a scratch code y tu clave de recuperación, y luego usa Re-enroll two-factor authentication para configurar tu teléfono nuevo.

Restablecer la contraseña no sirve: la página de recuperación de cuenta de Codeberg también pide un código o el scratch code (Codeberg source).

Sin la clave de recuperación, la documentación de Codeberg no describe ningún proceso de recuperación. En el gestor de incidencias de la comunidad de Codeberg, un miembro de su junta directiva ha indicado a usuarios sin acceso que escriban a contact@codeberg.org (Codeberg staff reply). Un equipo muy pequeño atiende el soporte a usuarios en su tiempo libre, y la página de contacto de Codeberg advierte: «Response times will be very long» (los tiempos de respuesta serán muy largos) (Codeberg). Codeberg no publica qué prueba de titularidad pide. Más información en ¿Has perdido el teléfono con tu app de autenticación?

Desactivar la 2FA

En la página Security, selecciona Disable two-factor authentication (desactivar la autenticación de dos factores) y luego Yes (sí) para confirmar (Codeberg source).

Ayuda oficial de Codeberg

• Setting up two-factor authentication (configurar la autenticación de dos factores)
• Your First Steps on Codeberg (tus primeros pasos en Codeberg)
• Contact (contacto)
• Need assistance with account recovery (gestor de incidencias Codeberg/Community, respuesta del equipo)
• El código de Forgejo desplegado en codeberg.org: ajustes de 2FA, inicio de sesión con 2FA, recuperación de cuenta, textos de la interfaz en inglés