Skip to main content

Acceso a GitHub mediante la autenticación en dos fases

Con 2FA habilitado, se le pedirá que proporcione el código de autenticación 2FA, así como la contraseña, al iniciar sesión en GitHub.

Con la autenticación de dos factores (2FA) habilitada, tendrás que usar un segundo factor al acceder a GitHub desde tu navegador. Cuando configures 2FA por primera vez, la cuenta entrará en un periodo de comprobación de 28 días para garantizar que los métodos 2FA de la cuenta están configurados correctamente. Puedes salir del período de comprobación realizando de manera exitosa la autenticación de dos factores dentro de los 28 días. Si no se autentica en un plazo de 28 días, se le pedirá que realice 2FA dentro de una de las sesiones existentes GitHub . Si no puedes realizar la autenticación de dos factores (2FA) para superar la comprobación del día 28, utiliza el acceso directo proporcionado para volver a configurar tus ajustes de 2FA y mantener el acceso a GitHub. Para más información, consulta Configurar la autenticación de dos factores.

Si accede GitHub mediante otros métodos, como la API o la línea de comandos, se autenticará mediante un token, una aplicación o una clave SSH. Para más información, consulta Acerca de la autenticación para GitHub.

Uso de 2FA al iniciar sesión en el sitio web

Después de iniciar sesión en GitHub con la contraseña, deberá proporcionar un código de autenticación, pulsar una notificación en GitHub Mobile o usar una clave de seguridad para realizar 2FA.

GitHub solo le pedirá que proporcione de nuevo el código de autenticación 2FA si ha cerrado la sesión, está usando un nuevo dispositivo, está realizando una acción confidencial o la sesión expira. Para más información sobre 2FA para acciones confidenciales, consulta Modo sudo.

Generar un código a través de una aplicación TOTP

Si decide configurar la autenticación en dos fases mediante una aplicación TOTP, puede generar un código de autenticación para GitHub en cualquier momento. En la mayoría de los casos, el lanzamiento de la aplicación generará un código nuevo. Deberías consultar la documentación de la aplicación para conocer las instrucciones específicas.

Si eliminas la aplicación autenticadora después de configurar la autenticación en dos fases, deberás proporcionar tu código de recuperación para obtener acceso a tu cuenta. Muchas aplicaciones de TOTP permiten realizar una copia de seguridad de los códigos de autenticación en la nube y restaurarlos si pierdes el acceso a tu dispositivo. Para más información, consulta Recuperar tu cuenta si pierdes tus credenciales 2FA.

Uso de una clave de seguridad

Si has configurado una clave de seguridad en la cuenta y el explorador admite claves de seguridad, puedes usarla para completar el inicio de sesión.

  1. Con el nombre de usuario y la contraseña, inicie sesión en GitHub a través del explorador.
  2. Si usas una clave de seguridad física, asegúrate de que está conectada al dispositivo.
  3. Para desencadenar la solicitud de clave de seguridad desde el sistema operativo, seleccione "Usar clave de seguridad".
  4. Selecciona la opción adecuada en el mensaje. Dependiendo de la configuración de la clave de seguridad, puedes escribir un PIN, completar una solicitud biométrica o usar una clave de seguridad física.

Uso de claves de paso

Si has habilitado 2FA y has agregado una clave de paso a tu cuenta, puedes usar la clave de paso para iniciar sesión. Como las claves de paso cumplen los requisitos de contraseña y 2FA, puedes completar el inicio de sesión con un solo paso. Consulta Acerca de las claves de paso.

Recibir un mensaje de texto

Si configura la autenticación en dos fases a través de mensajes de texto, GitHub le enviará un mensaje de texto con el código de autenticación.

Verificar con GitHub Mobile

Si ha instalado e iniciado sesión en GitHub Mobile, puede optar por autenticarse con GitHub Mobile para la autenticación en dos fases.

  1. Inicie sesión en GitHub con el explorador con su nombre de usuario y contraseña.

  2. GitHub le enviará una notificación push para comprobar el intento de inicio de sesión. Al abrir la notificación push o al abrir la aplicación GitHub Mobile, aparecerá un aviso para que apruebe o rechace este intento de inicio de sesión.

    Nota:

    Este mensaje podría indicarte que escribas un número de dos dígitos que se muestra dentro del explorador en el que has iniciado sesión.

    • Al aprobar el intento de inicio de sesión mediante GitHub Mobile, el explorador completará automáticamente el intento de inicio de sesión.
    • Si rechazas el intento de inicio de sesión, evitará que la autenticación se complete. Para más información, consulta Mantener tu cuenta y tus datos seguros.

Usar autenticación en dos fases con la línea de comando

Autenticación en la línea de comandos mediante el Administrador de credenciales de Git

Git Credential Manager es un asistente de credenciales de Git seguro que se ejecuta en Windows, macOS y Linux. Para obtener más información sobre los auxiliares de credenciales de Git, consulta Evitar repeticiones en el libro Pro Git.

Las instrucciones de configuración varían en función del sistema operativo del equipo. Para obtener más información, consulta Descargar e instalar en el repositorio GitCredentialManager/git-credential-manager.

Autenticar en la línea de comando mediante HTTPS

Debe crear un personal access token para usarlo como contraseña al autenticarse en GitHub desde la línea de comandos usando URL HTTPS.

Cuando se le solicite un nombre de usuario y una contraseña en la línea de comandos, use el GitHub nombre de usuario y personal access token. La línea de comandos no te indicará que debes introducir tu personal access token cuando te pida la contraseña.

Para más información, consulta Administración de tokens de acceso personal.

Autenticar en la línea de comandos mediante SSH

Activar la autenticación en dos fases no cambia cómo te autenticas en GitHub desde la línea de comandos mediante URL SSH. Para obtener más información sobre la configuración y el uso de una clave SSH, consulta Conexión a GitHub con SSH.

Solución de problemas

Si recibes un error "Error de autenticación en dos fases" al autenticarte con 2FA, el código de autenticación que estás escribiendo es incorrecto. Puedes intentar solucionar los problemas de los métodos de autenticación configurados antes de intentar la recuperación de la cuenta. Consulta Solución de problemas de autenticación en dos fases.

Información adicional