Authentification auprès de GitHub dans GitHub Desktop

Vous pouvez accéder de façon sécurisée aux ressources de votre compte dans GitHub Desktop en vous authentifiant auprès de 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 et 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 ».

Authentification d’un compte sur 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 ouvert « GitHub Desktop », le curseur pointe sur « Préférences », qui est mis en évidence en bleu.

  2. Dans la fenêtre « Préférences », dans le volet Comptes, cliquez sur le bouton Se connecter à côté de « GitHub.com ».

    Capture d'écran du volet « Comptes » dans la fenêtre « Préférences ». À côté de « GitHub.com », un bouton intitulé « Se connecter » est entouré d’un encadré orange.

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

  4. Pour vous authentifier auprès de GitHub, dans le navigateur, tapez vos informations d’identification GitHub.com et cliquez sur Se connecter.

    Ou bien, si vous êtes déjà connecté à GitHub, suivez les invites pour revenir à GitHub Desktop afin de terminer l’authentification.

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

  6. Une fois que GitHub a authentifié votre compte, suivez les invites pour retourner à GitHub Desktop.

Authentification d’un compte sur GitHub Enterprise Server

  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 ouvert « GitHub Desktop », le curseur pointe sur « Préférences », qui est mis en évidence en bleu.

  2. Dans la fenêtre « Préférences », dans le volet Comptes, cliquez sur le bouton Se connecter à côté de « GitHub Enterprise ».

    Capture d’écran du volet « Comptes » dans la fenêtre « Préférences ». À côté de « GitHub Enterprise », un bouton intitulé « Se connecter » est entouré d’un encadré orange.

  3. Pour ajouter un compte sur votre instance GitHub Enterprise Server, dans la fenêtre modale « Se connecter », tapez l’URL de votre instance sous « Adresse de l’enterprise », 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 auprès d’un compte votre instance GitHub Enterprise Server, tapez vos informations d’identification de compte, puis cliquez sur Connexion.

    Ou bien, si vous êtes déjà connecté à votre instance GitHub Enterprise Server, suivez les invites pour revenir à GitHub Desktop afin de terminer l’authentification.

Authentification d’un compte sur 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 « Fichier » développé, l’élément « Options » est mis en évidence avec un encadré orange.

  2. Dans la fenêtre « Options », dans le volet Comptes, cliquez sur le bouton Se connecter à côté de « GitHub.com ».

    Capture d’écran du volet « Comptes » dans la fenêtre « Options ». À côté de « GitHub.com », un bouton intitulé « Se connecter » est entouré d’un encadré orange.

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

  4. Pour vous authentifier auprès de GitHub, dans le navigateur, tapez vos informations d’identification GitHub.com et cliquez sur Se connecter.

    Ou bien, si vous êtes déjà connecté à GitHub, suivez les invites pour revenir à GitHub Desktop afin de terminer l’authentification.

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

  6. Une fois que GitHub a authentifié votre compte, suivez les invites pour retourner à GitHub Desktop.

Authentification d’un compte sur GitHub Enterprise

  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 « Fichier » développé, l’élément « Options » est mis en évidence avec un encadré orange.

  2. Dans la fenêtre « Options », dans le volet Comptes, cliquez sur le bouton Se connecter à côté de « GitHub Enterprise ».

    Capture d’écran du volet « Comptes » dans la fenêtre « Options ». À côté de « GitHub Enterprise », un bouton intitulé « Se connecter » est entouré d’un encadré orange.

  3. Pour ajouter un compte GitHub Enterprise, tapez vos informations d’identification sous « Adresse de l’entreprise », puis cliquez sur Continuer.

  4. Si vous avez configuré l’authentification à 2 facteurs pour GitHub Enterprise, 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.

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. Sous le menu déroulant « Aide » développé, un curseur pointe sur « Afficher les journaux dans le Finder », mis en évidence 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 » développé, une option intitulée « Afficher les journaux dans l’Explorateur » est encadré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