Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Autenticar a GitHub

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

En este artículo

¿Te ayudó este documento?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.

Acerca de la autenticación

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

Antes de realizar la autenticación, debes contar previamente con una cuenta de GitHub o GitHub Enterprise.

  • Para obtener más información sobre crear una cuenta de GitHub, consulta "Registrar una nueva cuenta de GitHub".
  • Para una cuenta de GitHub Enterprise, contacta a tu administrador de sitio de GitHub Enterprise.

Autenticar una cuenta en GitHub

  1. En la barra de menú, utiliza el menú desplegable de GitHub Desktop y luego da clic en Preferencias.

    El valor de preferencias en el menú desplegable de GitHub Desktop

  2. En la ventana Preferences (Preferencias), selecciona Accounts (Cuentas).

    El panel Accounts (Cuentas) en la ventana Preferences (Preferencias)

  3. A la derecha de "GitHub.com", da clic en Iniciar sesión.

    El botón Sign In (Iniciar sesión) para GitHub Enterprise

  4. En el recuadro de "Iniciar sesión", da clic en Iniciar sesión utilizando tu buscador. GitHub Desktop abrirá tu buscador predeterminado.

    Inicio de sesión mediante el enlace de su navegador

    Advertencia: Autenticarse en GitHub utilizand tu nombre de usuario y contraseña está en desuso. En vez de esto, te recomendamos autenticarte utilizando el buscador.

  5. Para autenticarte en GitHub, escribe tus credenciales de GitHub.com y haz clic en Sign in (Iniciar sesión).

    El botón de Inicio de sesión para GitHub en el navegador

    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.

    Ingresa entonces tu código de 2FA en el mensaje de GitHub y da clic en Verificar.

    El campo de código de autenticación 2FA

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

Autenticar una cuenta en GitHub Enterprise

Advertencia: Autenticarse en GitHub utilizand tu nombre de usuario y contraseña está en desuso. En vez de esto, te recomendamos autenticarte utilizando el buscador.

  1. En la barra de menú, utiliza el menú desplegable de GitHub Desktop y luego da clic en Preferencias.

    El valor de preferencias en el menú desplegable de GitHub Desktop

  2. En la ventana Preferences (Preferencias), selecciona Accounts (Cuentas).

    El panel Accounts (Cuentas) en la ventana Preferences (Preferencias)

  3. A la derecha de "GitHub Enterprise Server", da clic en Iniciar sesión.

    El botón de Iniciar sesión para GitHub Enterprise Server

  4. Para agregar una cuenta de GitHub Enterprise, teclea tus credenciales bajo el campo "Dirección de Enterprise Server", y luego da clic en Continuar.

    El botón Sign In (Iniciar sesión) para GitHub Enterprise

  5. Si has configurado la autenticación de dos factores para GitHub Enterprise, 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.

    Ingresa entonces tu código de 2FA en el mensaje de GitHub Desktop y da clic en Iniciar Sesión.

    El campo de código de autenticación 2FA

Autenticar una cuenta en GitHub

  1. Utiliza el menú de Archivo y luego da clic en Opciones.

    El valor de Opciones en el menú desplegable de Configuración

  2. En la ventana de Opciones, selecciona Accounts (Cuentas).

    El panel Accounts (Cuentas) en la ventana de Opciones

  3. A la derecha de "GitHub.com", da clic en Iniciar sesión.

    El botón Sign In (Iniciar sesión) para GitHub Enterprise

  4. En el panel de inicio de sesión, haz clic en Sign in using your browser (Iniciar sesión usando el navegador).

    Inicio de sesión mediante el enlace de su navegador

    Advertencia: Autenticarse en GitHub utilizand tu nombre de usuario y contraseña está en desuso. En vez de esto, te recomendamos autenticarte utilizando el buscador.

  5. Para autenticarte en GitHub, escribe tus credenciales de GitHub.com y haz clic en Sign in (Iniciar sesión).

    El botón de Inicio de sesión para GitHub en el navegador

    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.

    Ingresa entonces tu código de 2FA en el mensaje de GitHub y da clic en Verificar.

    El campo de código de autenticación 2FA

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

Autenticar una cuenta en GitHub Enterprise

Advertencia: Autenticarse en GitHub utilizand tu nombre de usuario y contraseña está en desuso. En vez de esto, te recomendamos autenticarte utilizando el buscador.

  1. Utiliza el menú de Archivo y luego da clic en Opciones.

    El valor de Opciones en el menú desplegable de Configuración

  2. En la ventana de Opciones, selecciona Accounts (Cuentas).

    El panel Accounts (Cuentas) en la ventana de Opciones

  3. A la derecha de "GitHub Enterprise Server", da clic en Iniciar sesión.

    El botón de Iniciar sesión para GitHub Enterprise Server

  4. Para agregar una cuenta de GitHub Enterprise, teclea tus credenciales bajo el campo "Dirección de Enterprise Server", y luego da clic en Continuar.

    El botón Sign In (Iniciar sesión) para GitHub Enterprise

  5. Si has configurado la autenticación de dos factores para GitHub Enterprise, 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.

    Ingresa entonces tu código de 2FA en el mensaje de GitHub Desktop y da clic en Iniciar Sesión.

    El campo de código de autenticación 2FA

Solucionar 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. Utiliza el menú desplegable de Ayuda y da clic en Mostrar bitácoras en el buscador.
    El botón de Mostrar Bitácoras en el Buscador
  2. Selecciona el archivo de bitácora desde la fecha en donde encontraste el error de autenticación.
  1. Utiliza el menú desplegable de Ayuda y da clic en Mostrar las bitácoras en el explorador.
    El botón de Mostrar Bitácoras en el Buscador
  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 -  (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//.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 solucionarlo, consulta la sección "Generar una llave SSH nueva y agregarla al agente de SSH".

No se pudo clonar

fatal: clone of 'git@github.com:/' into submodule path '' failed
Failed to clone 'src/github.com//'. Retry scheduled
Cloning into ''...
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 tienes una llave SSH válida configurada, consulta la sección "Generar una llave SSH nueva y agregarla al agente de SSH".

No se pudo leer la respuesta de AskPass

error: unable to read askpass response from '/Users//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. Abre el editor de registro (regedit.exe) y navega hasta las siguientes ubicaciones. HKEY_CURRENT_USER\Software\Microsoft\Command Processor\`HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor`
  2. Revisa para ver si hay un valor de Autorun en cualquiera de las ubicaciones.
  3. Si hay un valor de Autorun, bórralo.

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 la sección "Crear una cuenta de usuario en Windows" en la documentación de Microsoft.

Leer más

¿Te ayudó este documento?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.