Configura una app de autenticación
- Abre el menú de tu avatar y selecciona Edit profile (Editar perfil).
- Elige Access → Password and authentication (Acceso → Contraseña y autenticación).
- En One-time password authenticator (Autenticador de contraseña de un solo uso), elige Register authenticator (Registrar autenticador).
Agrega GitLab a Sign In
Usa Sign In, nuestra app de autenticación, para generar códigos de verificación directamente en tu iPhone.
- Con el código QR de configuración en otra pantalla, abre Sign In y toca Add (Agregar) → Scan QR Code (Escanear código QR).
- Escanea el código, revisa los detalles de la cuenta y toca Add Account (Agregar cuenta).
- Ingresa tu contraseña actual y el código de seis dígitos en GitLab, y luego elige Register with two-factor app (Registrar con la app de dos factores). Descarga tus códigos de recuperación.
GitLab proporciona detalles de configuración para la entrada manual, así como un código QR. En Sign In, elige Add (Agregar) → Enter Setup Key (Ingresar clave de configuración), escribe GitLab en Service (Servicio) y el nombre de tu cuenta en Account (Cuenta), pega la clave de configuración en Key (Clave) y luego toca Add Account (Agregar cuenta). Mantén esta clave de configuración en privado.
Guarda los códigos de recuperación
Guarda gitlab-recovery-codes.txt de forma segura fuera de tu teléfono. Cada código funciona una sola vez. Cuando se te pida el código de la app de autenticación, elige Recover your account (Recuperar tu cuenta) para usar uno.
Si no están disponibles, consulta las instrucciones de recuperación de GitLab para tu instancia. Prepara la recuperación antes de reemplazar tu teléfono.
Requisitos de Git y de la organización
Después de habilitar 2FA, usa un token de acceso personal en lugar de tu contraseña para usar Git por HTTPS o acceder a la API. Las políticas del grupo o de la instancia pueden requerir 2FA. Los dispositivos WebAuthn compatibles proporcionan otra opción de verificación.
Si un código no funciona
Asegúrate de que la entrada de GitLab en Sign In corresponda a la cuenta que estás usando. Espera un código nuevo e ingrésalo antes de que cambie. Si los códigos nuevos siguen fallando, verifica que la fecha y la hora de tu iPhone se ajusten automáticamente.
Mantén abierta una sesión que funcione y ten a mano tu información de recuperación mientras solucionas el problema. Agregar una entrada a Sign In no completa la configuración: GitLab debe aceptar un código y confirmar la activación.