Authentification auprès de GitHub dans GitHub Desktop

Vous pouvez accéder en toute sécurité aux ressources de votre compte sur GitHub Desktop en vous authentifiant sur GitHub.

Platform navigation

Dans cet article

À propos de l’authentification

Pour garantir la sécurité de votre compte, vous devez vous authentifier avant de pouvoir utiliser GitHub Desktop pour accéder aux ressources sur GitHub.

Avant de vous authentifier, Vous devez déjà avoir un compte sur GitHub. Pour plus d'informations, consultez Création d’un compte sur GitHub.

S'authentifier sur votre compte GitHub

  1. Dans la barre de menus, sélectionnez GitHub Desktop, puis cliquez sur Préférences.

    Capture d'écran de la barre de menus sur un Mac. Dans le menu déroulant « Bureau GitHub », le curseur se trouve sur « Paramètres », qui est surligné en bleu.

  2. Dans la fenêtre « Options », dans le volet Comptes , cliquez sur le bouton « Se connecter » approprié. Utilisez Se connecter à GitHub Enterprise pour vous connecter à GitHub Enterprise Server ou GitHub Enterprise Cloud avec résidence des données.

    Capture d'écran du volet « Comptes » dans la fenêtre « Paramètres ». Les boutons bleus intitulés « Se connecter à GitHub.com » et « Se connecter à GitHub Enterprise » sont affichés.

  3. Si vous vous connectez à un compte sur GitHub Enterprise, dans la fenêtre modale « Se connecter », tapez l'URL où vous accédez à GitHub, puis cliquez sur Continuer.

  4. Dans la fenêtre modale « Se connecter à l’aide de votre navigateur », cliquez sur Continuer avec le navigateur. GitHub Desktop ouvre votre navigateur par défaut.

  5. Pour vous authentifier sur GitHub, dans le navigateur, saisissez vos informations d'identification et cliquez sur Sign in .

    Si vous étiez déjà connecté à GitHub, suivez les instructions pour retourner à GitHub Desktop afin de terminer l'authentification.

  6. Si vous avez configuré l’authentification à 2 facteurs (2FA) pour GitHub, effectuez l’une des opérations suivantes :

    • Si vous configurez 2FA via SMS, récupérez votre code 2FA à partir d’un message SMS.
    • Si vous configurez 2FA avec une application TOTP, générez un code 2FA.

    Entrez ensuite votre code 2FA dans l’invite sur GitHub, puis cliquez sur Vérifier.

  7. Après que GitHub a authentifié votre compte, suivez les invites pour retourner à GitHub Desktop.

S'authentifier sur votre compte GitHub

  1. Utilisez le menu Fichier, puis cliquez sur Options.

    Capture d’écran de la barre de menus « GitHub Desktop » sur Windows. Dans le menu déroulant développé « Fichier », l'élément « Options » est mis en évidence en orange.

  2. Dans la fenêtre « Options », dans le volet Comptes , cliquez sur le bouton « Se connecter » approprié. Utilisez Se connecter à GitHub Enterprise pour vous connecter à GitHub Enterprise Server ou GitHub Enterprise Cloud avec résidence des données.

    Capture d'écran du volet « Comptes » dans la fenêtre « Options ». Les boutons bleus intitulés « Se connecter à GitHub.com » et « Se connecter à GitHub Enterprise » sont affichés.

  3. Si vous vous connectez à un compte sur GitHub Enterprise, dans la fenêtre modale « Se connecter », tapez l'URL où vous accédez à GitHub, puis cliquez sur Continuer.

  4. Dans la fenêtre modale « Se connecter à l’aide de votre navigateur », cliquez sur Continuer avec le navigateur. GitHub Desktop ouvre votre navigateur par défaut.

    Avertissement

    L’authentification sur GitHub avec votre nom d’utilisateur et votre mot de passe n’est pas prise en charge. À la place, nous vous demandons de vous authentifier en utilisant le navigateur.

  5. Pour vous authentifier sur GitHub, dans le navigateur, saisissez vos informations d'identification et cliquez sur Sign in .

    Si vous étiez déjà connecté à GitHub, suivez les instructions pour retourner à GitHub Desktop afin de terminer l'authentification.

  6. Si vous avez configuré l’authentification à 2 facteurs (2FA) pour GitHub, effectuez l’une des opérations suivantes :

    • Si vous configurez 2FA via SMS, récupérez votre code 2FA à partir d’un message SMS.
    • Si vous configurez 2FA avec une application TOTP, générez un code 2FA.

    Entrez ensuite votre code 2FA dans l’invite sur GitHub, puis cliquez sur Vérifier.

  7. Après que GitHub a authentifié votre compte, suivez les invites pour retourner à GitHub Desktop.

Résolution des problèmes d’authentification

Si GitHub Desktop rencontre une erreur d’authentification, aidez-vous des messages d’erreur pour résoudre le problème.

Si vous rencontrez une erreur d’authentification, essayez d’abord de vous déconnecter, puis de vous reconnecter à votre compte sur GitHub Desktop.

Pour certaines erreurs, GitHub Desktop affiche un message d’erreur. Si ce n’est pas le cas, ou si vous souhaitez obtenir plus d’informations sur une erreur, consultez les fichiers journaux de GitHub Desktop en suivant les étapes ci-après.

  1. Dans la barre de menus, sélectionnez Aide et cliquez sur Afficher les journaux dans le Finder.

    Capture d’écran de la barre de menus « GitHub Desktop » sur un Mac. Dans le menu déroulant « Aide », l'option « Afficher les journaux dans le Finder » est surlignée en bleu.

  2. Sélectionnez le fichier journal correspondant à la date à laquelle vous avez rencontré l’erreur d’authentification.

  1. Utilisez le menu déroulant Aide, puis cliquez sur Afficher les journaux dans l’Explorateur.

    Capture d’écran de la barre de menus « GitHub Desktop » sur Windows. Dans le menu déroulant « Aide », l'option « Afficher les journaux dans l'explorateur » est soulignée en orange.

  2. Sélectionnez le fichier journal correspondant à la date à laquelle vous avez rencontré l’erreur d’authentification.

Passez en revue les informations de résolution des problèmes ci-dessous pour rechercher le message d’erreur rencontré.

Informations d’identification incorrectes

Error: Bad credentials

Cette erreur signifie qu’il existe un problème avec les informations d’identification stockées pour votre compte.

Pour résoudre le problème, déconnectez-vous de votre compte sur GitHub Desktop, puis reconnectez-vous.

Jeton vide

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

Cette erreur signifie que GitHub Desktop ne trouve pas le jeton d’accès créé dans le trousseau système.

Pour résoudre le problème, déconnectez-vous de votre compte sur GitHub Desktop, puis reconnectez-vous.

Dépôt introuvable

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.)

Cette erreur signifie que vous n’avez pas l’autorisation d’accéder au dépôt que vous essayez de cloner.

Pour résoudre le problème, contactez la personne de votre organisation qui gère les autorisations.

Impossible de lire le dépôt distant

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.

Cette erreur signifie que vous n’avez pas de clé SSH valide configurée.

Pour résoudre les problèmes, consultez Génération d’une nouvelle clé SSH et ajout de celle-ci à ssh-agent.

Échec du clonage

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.

Cette erreur signifie que le dépôt que vous essayez de cloner contient des sous-modules auxquels vous n’avez pas accès, ou que vous n’avez pas de clé SSH valide configurée.

Si vous n’avez pas accès aux sous-modules, résolvez le problème en contactant la personne qui gère les autorisations du dépôt.

Si vous n’avez pas de clé SSH valide configurée, consultez Génération d’une nouvelle clé SSH et ajout de celle-ci à ssh-agent.

Impossible de lire la réponse 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

Cette erreur peut être due à plusieurs événements.

Si les entrées de Registre Command Processor sont modifiées, GitHub Desktop répond par une erreur Authentication failed. Pour vérifier si ces entrées de Registre ont été modifiées, suivez les étapes ci-après.

  1. Ouvrez l’éditeur du Registre (regedit.exe), puis accédez aux emplacements suivants. HKEY_CURRENT_USER\Software\Microsoft\Command Processor\ HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor\
  2. Vérifiez s’il existe une valeur Autorun à l’un ou l’autre des emplacements.
  3. S’il existe une valeur Autorun, supprimez-la.

Si votre nom d’utilisateur Windows comporte des caractères Unicode étendus, cela peut entraîner une erreur de réponse AskPass. Pour résoudre le problème, créez un compte d’utilisateur Windows, puis migrez vos fichiers vers ce compte. Pour plus d’informations, consultez Créer un compte d’utilisateur dans Windows au sein de la documentation Microsoft.

Pour aller plus loin