Si vous recevez une erreur « Échec de l’authentification à 2 facteurs » lors de l’authentification à 2 facteurs (2FA), cela signifie que le code d’authentification saisi est incorrect. Vous pouvez essayer de résoudre les problèmes liés à vos méthodes d’authentification configurées avant de tenter de récupérer votre compte.
Résolution des problèmes d’authentification à l’aide d’une application TOTP
Utilisez la bonne application
Lors de l’authentification avec une application TOTP, GitHub ne vous envoie rien ; vous devez fournir à GitHub un code valide, basé sur la clé secrète que vous avez enregistrée dans votre application TOTP lors de la configuration de l’authentification à 2 facteurs. Trouvez l’application ou le programme que vous avez utilisé à l’origine pour configurer l’authentification à 2 facteurs et récupérez le code d’authentification à partir de là.
Vérifiez la date et l’heure de votre appareil
Les codes TOTP sont basés sur le temps. Si l’horloge de votre téléphone ou de votre ordinateur n’est pas synchronisée avec le serveur GitHub, le code sera invalide. Assurez-vous que la date, l’heure et le fuseau horaire de votre appareil sont réglés automatiquement par votre opérateur réseau. Sur la plupart des appareils mobiles, cela signifie qu’il faut activer l’option Définir automatiquement.
Attendez un nouveau code et entrez-le rapidement
Les codes changent toutes les 30 secondes. Ouvrez votre application TOTP, attendez l’apparition du code suivant et entrez-le immédiatement. Évitez de taper des espaces ou des caractères supplémentaires, car cela rendrait le code invalide.
Vérifiez que vous utilisez la bonne entrée de compte
La plupart des applications TOTP prennent en charge plusieurs comptes pour un même site web. Assurez-vous que vous lisez le code à partir de la bonne entrée dans l’application. Les codes générés pour un autre compte ne fonctionneront pas.
Restaurez à partir d’une sauvegarde TOTP
De nombreuses applications TOTP prennent en charge la sauvegarde dans le cloud ou l’exportation de clés. Si vous perdez ou réinitialisez votre appareil, vous pouvez restaurer vos données d’authentification à 2 facteurs à partir de la sauvegarde de l’application sur un nouvel appareil. Consultez la documentation de votre application pour obtenir des instructions.
Résolution des problèmes d’authentification à l’aide de SMS
Vérifiez que vous pouvez recevoir des SMS
Assurez-vous que votre appareil et votre forfait mobile permettent de recevoir des SMS (Short Message Service). Certains forfaits téléphoniques « données uniquement » et certaines tablettes connectées à un réseau mobile peuvent ne pas prendre en charge la réception de SMS. Vérifiez auprès de votre opérateur et du fabricant de votre appareil.
Des frais d’opérateur peuvent s’appliquer pour les SMS reçus. Assurez-vous que votre forfait mobile couvre les frais éventuels.
Désactivez le mode « Ne pas déranger » ou les applications de filtrage des spams qui pourraient bloquer la réception des codes d’authentification.
Vérifiez que vous disposez d’une couverture réseau suffisante
La réception de SMS nécessite généralement un signal réseau puissant. Assurez-vous que vous disposez d’une couverture suffisante avant de demander un code d’authentification.
Redémarrez votre téléphone
Éteindre et rallumer votre téléphone permet de réenregistrer l’appareil sur le réseau, ce qui peut résoudre certains problèmes de réception. Activer et désactiver le « mode Avion » peut également suffire, mais le redémarrage complet est plus fiable.
Consultez votre opérateur mobile
Vérifiez auprès de votre opérateur mobile s’il existe des pannes locales ou des problèmes de livraison dans votre région. Il pourra également enquêter sur les problèmes de livraison liés à votre connexion. Fournissez-leur le numéro SMS configuré sur votre compte GitHub et l’heure à laquelle vous avez demandé un code d’authentification à GitHub.
Remarque
GitHub, en collaboration avec nos partenaires de livraison SMS, surveille de manière proactive les taux de réussite de nos livraisons des SMS. Les périodes de faible délivrabilité, pouvant indiquer un problème généralisé, font l’objet d’investigations rapides. Vous pouvez consulter les incidents actifs et historiques affectant la livraison des SMS dans votre région sur la page d’état de GitHub.
Récupération de votre compte si la résolution des problèmes ne suffit pas
Si vous avez tenté la résolution des problèmes et que vous rencontrez toujours des difficultés, vous pouvez essayer de vous authentifier avec une autre méthode, comme une clé d’accès, GitHub Mobile, ou une clé de sécurité, si elles sont préconfigurées sur le compte. Pour plus d’informations, consultez « Accès à GitHub avec l’authentification à 2 facteurs ».
Avertissement
Pour des raisons de sécurité, Support GitHub ne peut pas vous aider à résoudre les problèmes liés à vos méthodes 2FA, y compris la livraison des SMS.
Si vous ne disposez pas d’une autre méthode d’authentification, vous devrez tenter la récupération de compte. Pour plus d’informations sur la récupération de compte, consultez Récupération de votre compte si vous perdez vos informations d’identification TFA.
Résolution des problèmes à l’aide de codes de récupération
Si vous recevez le message d’erreur « Échec de l’authentification par code de récupération » lorsque vous utilisez un code de récupération, cela signifie que le code que vous entrez n’est pas valide. Vous pouvez essayer de résoudre le problème lié à vos codes de récupération.
Utilisez un code à la fois
Un ensemble de codes de récupération contient plusieurs codes. Un code unique est composé de 10 caractères alphanumériques séparés par un tiret : xxxxx-yyyyy.
Essayez d’utiliser un autre code
Chaque code est à usage unique : une fois utilisé pour l’authentification, il ne peut plus être réutilisé. Essayez d’utiliser un autre code de l’ensemble.
Vérifiez que vous utilisez le bon ensemble de codes
Lorsque l’authentification à 2 facteurs est désactivée puis réactivée, un nouvel ensemble de codes est créé, ce qui invalide l’ensemble précédent. Les codes de récupération sont également invalidés chaque fois qu’un nouvel ensemble de codes est généré. Même si vous pensez ne pas disposer d’un autre ensemble de codes, vous pouvez essayer de les rechercher dans vos appareils, vos sauvegardes et vos gestionnaires de mots de passe. Ils porteront le nom de fichier par défaut github-recovery-codes.txt.