Autenticación en GitHub en GitHub Desktop

Puedes acceder de forma segura a los recursos de tu cuenta en GitHub Desktop si te autenticas en GitHub.

Platform navigation

En este artículo

Acerca de la autenticación

Para mantener la seguridad de la cuenta, debes autenticarte antes de que puedas utilizar GitHub Desktop para acceder a los recursos en GitHub.

Antes de realizar la autenticación, Ya debes tener una cuenta en GitHub. Para más información, consulta "Creación de una cuenta en GitHub.

Autenticación en tu cuenta de GitHub

  1. En la barra de menús, selecciona GitHub Desktop y, a continuación, haz clic en Settings.

    Captura de pantalla de la barra de menús en un equipo Mac. En el menú desplegable "GitHub Desktop" abierto, el cursor mantiene el puntero sobre "Settings", que se resalta en azul.

  2. En la ventana "Settings", en el panel Accounts, haz clic en el botón "Sign Into" adecuado. Usa Sign Into GitHub Enterprise para iniciar sesión en GitHub Enterprise Server o Nube de GitHub Enterprise con residencia de datos.

    Recorte de pantalla del panel "Accounts" en la ventana "Settings". Se muestran los botones azules con la etiqueta "Sign Into GitHub.com" y "Sign Into GitHub Enterprise".

  3. Si inicias sesión en una cuenta de GitHub Enterprise, en la ventana modal "Sign in", escribe la dirección URL donde accedes a GitHub y, a continuación, haz clic en Continue.

  4. En la ventana modal "Iniciar sesión con el navegador", haz clic en Continuar con el navegador. GitHub Desktop abrirá tu buscador predeterminado.

  5. Para autenticarte en GitHub, en el explorador, escribe tus credenciales y haz clic en Sign in.

    Como alternativa, si ya hubieras iniciado sesión en GitHub, sigue los mensajes para regresar a GitHub Desktop y así completar la autenticación.

  6. Si has configurado la autenticación de dos factores (2FA) para GitHub, realiza una de las siguientes acciones:

    • Si configuras 2FA por medio de SMS, recupera tu código 2FA de un mensaje SMS.
    • Si configuras 2FA con una aplicación TOTP, genera un código 2FA.

    Después, escriba el código de 2FA en el mensaje de GitHub y haga clic en Verificar.

  7. Después de que GitHub autentique tu cuenta, sigue las indicaciones para volver a GitHub Desktop.

Autenticación en tu cuenta de GitHub

  1. Use el menú Archivo y haga clic en Opciones.

    Captura de pantalla de la barra de menús "Escritorio de GitHub" en un equipo Windows. En el menú desplegable "Archivo" expandido, el elemento "Opciones" se resalta en naranja.

  2. En la ventana "Options", en el panel Accounts, haz clic en el botón "Sign Into" adecuado. Usa Sign Into GitHub Enterprise para iniciar sesión en GitHub Enterprise Server o Nube de GitHub Enterprise con residencia de datos.

    Captura de pantalla del panel "Cuentas" en la ventana "Opciones". Se muestran los botones azules con la etiqueta "Sign Into GitHub.com" y "Sign Into GitHub Enterprise".

  3. Si inicias sesión en una cuenta de GitHub Enterprise, en la ventana modal "Sign in", escribe la dirección URL donde accedes a GitHub y, a continuación, haz clic en Continue.

  4. En la ventana modal "Iniciar sesión con el navegador", haz clic en Continuar con el navegador. GitHub Desktop abrirá tu buscador predeterminado.

    Advertencia

    No se admite la autenticación en GitHub usando tu nombre de usuario y contraseña. En vez de esto, se requiere que te autentiques utilizando tu buscador.

  5. Para autenticarte en GitHub, en el explorador, escribe tus credenciales y haz clic en Sign in.

    Como alternativa, si ya hubieras iniciado sesión en GitHub, sigue los mensajes para regresar a GitHub Desktop y así completar la autenticación.

  6. Si has configurado la autenticación de dos factores (2FA) para GitHub, realiza una de las siguientes acciones:

    • Si configuras 2FA por medio de SMS, recupera tu código 2FA de un mensaje SMS.
    • Si configuras 2FA con una aplicación TOTP, genera un código 2FA.

    Después, escriba el código de 2FA en el mensaje de GitHub y haga clic en Verificar.

  7. Después de que GitHub autentique tu cuenta, sigue las indicaciones para volver a GitHub Desktop.

Solución de problemas de autenticación

Si GitHub Desktop encuentra un error de autenticación, puedes utilizar los mensajes de error para solucionar los problemas.

Si te encuentras con un error de autenticación, primero intenta salir y entrar nuevamente a tu cuenta en GitHub Desktop.

En el caso de algunos errores, GitHub Desktop te solicitará que indiques el mensaje de error. Si no se te solicita esto, o si quieres encontrar información adicional sobre cualquier error, consulta los archivos de bitácora de GitHub Desktop siguiendo estos pasos.

  1. En la barra de menús, seleccione Ayuda y, a continuación, haga clic en Mostrar registros en Finder.

    Captura de pantalla de la barra de menús "Escritorio de GitHub" en un equipo Mac. En el menú desplegable "Help" expandido, aparece "Show Logs in Finder" resaltado en azul.

  2. Selecciona el archivo de bitácora desde la fecha en donde encontraste el error de autenticación.

  1. Use el menú desplegable Help y haga clic en Show Logs in Explorer.

    Captura de pantalla de la barra de menús "Escritorio de GitHub" en un equipo Windows. En el menú desplegable "Help" expandido, aparece "Show Logs in Explorer" resaltado en naranja.

  2. Selecciona el archivo de bitácora desde la fecha en donde encontraste el error de autenticación.

Revisa la información de solución de problemas que se muestra a continuación dependiendo del error con el que te hayas encontrado.

Credenciales incorrectas

Error: Bad credentials

Este error significa que hay un problema con las credenciales almacenadas de tu cuenta.

Para solucionar este problema, sal de tu cuenta en GitHub Desktop y vuelve a firmarte.

Token vacío

info: [ui] [AppStore.withAuthenticatingUser] account found for repository: node - USERNAME (empty token)

Este error significa que GitHub Desktop no puede encontrar el token de acceso que creó en la cadena de llaves del sistema.

Para solucionar este problema, sal de tu cuenta en GitHub Desktop y vuelve a firmarte.

No se encuentra el repositorio

fatal: repository 'https://github.com/<user>/<repo>.git' not found

(The error was parsed as 8: The repository does not seem to exist anymore. You may not have access, or it may have been deleted or renamed.)

Este error significa que no tienes permiso para acceder al repositorio que estás intentando clonar.

Para solucionar los problemas, contacta a la persona que administre los permisos en tu organización.

No se pudo leer del repositorio remoto

git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights and the repository exists.

Este error significa que no tienes una llave SSH válida configurada.

Para solucionar problemas, consulta Generación de una nueva clave SSH y adición al agente SSH.

No se pudo clonar

fatal: clone of 'git@github.com:<user>/<repo>' into submodule path '<path>' failed
Failed to clone 'src/github.com/<user>/<repo>'. Retry scheduled
Cloning into '<path>'...
git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

Este error significa ya sea que el repositorio que intentas clonar tiene submódulos a los cuales no tienes acceso o que no tienes una llave SSH válida configurada.

Si no tienes acceso a los submódulos, soluciona este problema contactando a la persona que administre los permisos para este repositorio.

Si no tiene configurada una clave SSH válida, consulta Generación de una nueva clave SSH y adición al agente SSH.

No se pudo leer la respuesta de AskPass

error: unable to read askpass response from '/Users/<path>/GitHub Desktop.app/Contents/Resources/app/static/ask-pass-trampoline.sh'
fatal: could not read Username for 'https://github.com': terminal prompts disabled

Este error se puede presentar a causa de varios eventos.

Si se modifican las entradas del registro de Command Processor, GitHub Desktop responderá con un error de Authentication failed. Para verificar si estas entradas de registro se modifcaron, sigue estos pasos.

  1. Abra el Editor del Registro (regedit.exe) y desplácese hasta las siguientes ubicaciones. HKEY_CURRENT_USER\Software\Microsoft\Command Processor\ HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor\
  2. Compruebe si hay un valor Autorun en cualquiera de las ubicaciones.
  3. Si hay un valor Autorun, elimínelo.

Si tu nombre de usuario de Windows tiene caracteres extendidos de Unicode, esto podría causar un error de respuesta de AskPass. Para solucionar los problemas, crea una cuenta nueva de usuario de Windows y migra tus archivos a dicha cuenta. Para obtener más información, consulta Crear una cuenta de usuario en Windows en la documentación de Microsoft.

Información adicional