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 en dos fases habilitada, deberá proporcionar un código o usar una clave de acceso o clave de seguridad al acceder a través del GitHub explorador. Si accede GitHub mediante otros métodos, como la API o la línea de comandos, deberá usar una forma alternativa de autenticación. 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 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.

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

Después de habilitar 2FA, ya no usarás tu contraseña para acceder a GitHub en la línea de comandos. En su lugar, use el Administrador de credenciales de Git, o personal access tokenuna clave SSH.

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. El indicador de la línea de comandos no indicará que debe introducir personal access token cuando le 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