Permission denied (publickey) signifie que le serveur OpenSSH n'autorise que l'authentification par clé et qu'il a rejeté toutes les clés proposées par votre client pour cet utilisateur. Quatre causes couvrent presque tous les cas : le mauvais utilisateur distant, une clé non chargée ou non proposée, de mauvaises permissions sur ~/.ssh ou authorized_keys, et un algorithme de signature de clé que l'autre côté refuse.
Ce que Permission denied (publickey) vous apprend sur le serveur OpenSSH
OpenSSH affiche ce message lorsque la méthode publickey a échoué et qu'il ne reste aucune autre méthode d'authentification. Le texte entre parenthèses liste les méthodes acceptées par le serveur. S'il n'indique que publickey, la connexion par mot de passe est désactivée et il n'existe aucune solution de repli. Par conception, sshd n'explique jamais au client pourquoi une clé a été refusée. Le diagnostic se fait donc des deux côtés : la sortie détaillée du client et le journal du serveur.
Étape 1 : lire la sortie de ssh -vvv pour voir quelle clé SSH est proposée
L'option -v augmente la verbosité de ssh, jusqu'à trois niveaux. -vvv affiche chaque clé essayée par le client et la réponse du serveur. Filtrer la sortie vous évite de parcourir des centaines de lignes :
ssh -vvv -p 22 [email protected] 2>&1 | grep -E 'Connecting to|Offering|Trying|Authentications|Server accepts|No more'Voici les lignes qui comptent :
- Connecting to : l'hôte et le port réels une fois ~/.ssh/config appliqué. Par défaut, il s'agit du port TCP 22.
- Offering public key : la clé envoyée. Si aucune n'apparaît, le client ne trouve pas de clé (étape 3).
- Authentications that can continue: publickey juste après une proposition : le serveur a rejeté cette clé.
- Server accepts key : la clé est valide. Un échec après cette ligne désigne la phrase de passe ou l'agent.
- No more authentication methods to try : le client n'a plus de clés à proposer.
Étape 2 : confirmer l'utilisateur distant de la connexion SSH
Si vous ne précisez pas d'utilisateur, ssh envoie votre nom d'utilisateur local. Sur un téléphone ou une machine empruntée, ce nom correspond rarement au compte du serveur. ssh -G affiche la configuration effective sans se connecter :
ssh -G server.example.com | grep -E '^(user|hostname|port|identityfile) 'Chaque compte possède son propre authorized_keys. Une clé autorisée dans /home/ana/.ssh/authorized_keys ne vous permettra pas d'entrer en tant que root ni sous un autre utilisateur. Les images cloud créent généralement leur propre utilisateur non root : consultez la documentation de votre fournisseur avant d'aller plus loin.
Étape 3 : vérifier que la clé SSH est chargée dans l'agent et réellement proposée
ssh-add -l liste les clés détenues par l'agent. S'il n'indique aucune identité, le client n'essaie que les fichiers par défaut de ~/.ssh. Pour forcer une clé précise et comparer les empreintes :
ssh-add -l
ssh-add ~/.ssh/id_ed25519
ssh -i ~/.ssh/id_ed25519 -o IdentitiesOnly=yes [email protected]
ssh-keygen -lf ~/.ssh/id_ed25519.pub
# on the server:
ssh-keygen -lf ~/.ssh/authorized_keysIdentitiesOnly=yes empêche l'agent de proposer une série de clés avant la bonne. sshd coupe la connexion dès qu'il atteint sa limite MaxAuthTries. Si l'empreinte SHA256 de votre clé publique ne figure pas dans la liste pour authorized_keys, vous avez copié une autre clé.
Dans termi1, vous pouvez générer des clés directement sur le téléphone ; elles sont conservées dans le stockage sécurisé du système. La clé privée ne quitte jamais l'appareil : ce que vous collez sur le serveur est donc toujours la moitié publique. Sur un Mac, termi1 Companion installe cette clé publique lorsque vous effectuez l'appairage avec un code à six chiffres.
Étape 4 : corriger les permissions de ~/.ssh et d'authorized_keys sur le serveur
OpenSSH attend ~/.ssh en mode 700, et authorized_keys ainsi que les clés privées en mode 600. Avec StrictModes activé, ce qui est le cas par défaut, sshd ignore authorized_keys si ce fichier, ~/.ssh ou le répertoire personnel est accessible en écriture à d'autres utilisateurs.
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chown -R ana:ana ~/.ssh
chmod go-w ~
ls -ld ~ ~/.ssh ~/.ssh/authorized_keysLa même règle s'applique côté client. Si une clé privée est lisible par d'autres, ssh affiche UNPROTECTED PRIVATE KEY FILE et refuse de l'utiliser. Demandez à l'IA de termi1 de « corriger les permissions de mon .ssh » et la commande est saisie dans l'invite sans appuyer sur Entrée. Sur les connexions marquées comme production, Production Guard bloque toute modification avant qu'elle n'atteigne l'invite.
Étape 5 : lire /var/log/auth.log pour savoir pourquoi sshd refuse la clé
Sous Debian et Ubuntu, sshd consigne les tentatives d'authentification dans /var/log/auth.log. Sur les systèmes qui n'utilisent que journald, les mêmes informations sont accessibles via journalctl :
sudo tail -f /var/log/auth.log
sudo journalctl -u ssh -f # Debian/Ubuntu
sudo journalctl -u sshd -f # RHEL, Fedora, Arch
sudo sshd -T | grep -iE 'pubkey|authorizedkeys|strictmodes'- Invalid user : le compte n'existe pas sur le serveur (étape 2).
- Authentication refused: bad ownership or modes : permissions ou propriétaire incorrects (étape 4).
- Connection closed by authenticating user … [preauth] : une clé a été proposée, mais elle ne correspond à aucune entrée d'authorized_keys.
- Messages mentionnant ssh-rsa et PubkeyAcceptedAlgorithms : l'algorithme de signature a été refusé (étape 6).
Si le journal ne dit rien d'utile, définissez LogLevel VERBOSE dans sshd_config pour enregistrer l'empreinte de chaque clé essayée. Consultez les options serveur documentées de sshd_config. Sur le clavier de termi1, Ctrl+C arrête le tail -f, et tmux maintient la session active si votre réseau change.
Étape 6 : écarter le refus par OpenSSH de la signature ssh-rsa de la clé
Depuis OpenSSH 8.8 (septembre 2021), la signature ssh-rsa basée sur SHA-1 est désactivée par défaut. Une clé RSA peut échouer même si elle a été correctement copiée, lorsqu'un des deux côtés ne négocie que cette signature. La solution la plus propre est Ed25519, pris en charge par OpenSSH depuis la version 6.5 (janvier 2014) :
ssh-keygen -t ed25519 -C "ana@phone"
ssh-copy-id -i ~/.ssh/id_ed25519.pub [email protected]ssh-copy-id nécessite un autre moyen d'accès fonctionnel. À défaut, ajoutez la ligne de la clé publique à authorized_keys depuis la console de votre fournisseur. Les options du client sont listées dans le manuel officiel du client ssh.
Diagnostiquer Permission denied (publickey) sur mobile ou sur ordinateur
| Vérification | Ordinateur avec OpenSSH | Mobile (iOS/Android) |
|---|---|---|
| Détail de la négociation | ssh -vvv dans un terminal local | Dépend du client ; le journal du serveur fait référence |
| Utilisateur distant | ssh -G affiche la valeur effective | Champ Utilisateur de la connexion enregistrée |
| Clé proposée | ssh-add -l et ssh -i | Clé associée à la connexion ; dans termi1, conservée dans le stockage sécurisé |
| Permissions sur le serveur | chmod depuis la session | chmod depuis la session, avec Ctrl et Tab sur le clavier de termi1 |
| Inspecter authorized_keys | cat ou un éditeur distant | cat ou le SFTP intégré de termi1 |
Si vous gérez des serveurs depuis votre poche, le terminal SSH pour iOS et Android fonctionne sans compte.
Questions fréquentes
Pourquoi SSH affiche-t-il Permission denied (publickey) alors que ma clé est dans authorized_keys ?
SSH renvoie Permission denied (publickey) même avec la clé dans authorized_keys lorsque sshd ignore ce fichier ou qu'il appartient à un autre utilisateur. Les causes typiques sont des permissions trop ouvertes avec StrictModes activé, un mauvais propriétaire, une connexion avec un autre compte ou une signature ssh-rsa refusée.
Quelles permissions faut-il pour le dossier .ssh ?
Le dossier .ssh doit être en mode 700, pour que seul son propriétaire puisse le lire, y écrire et y entrer. Le fichier authorized_keys et les clés privées doivent être en mode 600. Le répertoire personnel ne doit pas être accessible en écriture au groupe ni aux autres utilisateurs, sinon sshd refuse la clé.
Où se trouve le journal SSH sous Ubuntu ?
Le journal SSH sous Ubuntu est /var/log/auth.log, et vous pouvez le suivre en direct avec sudo tail -f /var/log/auth.log. Les mêmes événements sont disponibles dans journald via sudo journalctl -u ssh -f. Définir LogLevel VERBOSE dans sshd_config enregistre l'empreinte de chaque clé essayée.
Mosh peut-il contourner Permission denied (publickey) ?
Mosh ne peut pas contourner Permission denied (publickey), car il lance mosh-server via une connexion SSH initiale. Si l'authentification par clé échoue à ce stade, Mosh n'ouvre jamais sa session UDP. Réparez d'abord l'accès SSH ; ensuite, Mosh maintient la session active lorsque vous changez de réseau.