SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Corriger « Permission denied (publickey) » en SSH

L’erreur « Permission denied (publickey) » recouvre cinq causes. Analysez la sortie de ssh -v pour identifier la vôtre et corriger SSH sans perdre l’accès.

Ce que signifie réellement « Permission denied (publickey) »

« Permission denied (publickey) » signifie que votre client a envoyé une ou plusieurs clés publiques et que le serveur n’en a accepté aucune. Le réseau fonctionne et sshd est actif : le refus se produit lors de la dernière étape de l’authentification. Si votre session s’interrompt avant cette étape, vous êtes face à un refus de connexion ou un délai d’attente dépassé, ce qui correspond à un autre diagnostic et à d’autres tests. La correction ne repose jamais sur des suppositions, car ssh -v indique laquelle des cinq causes est en jeu.

Les termes entre parenthèses correspondent aux méthodes que le serveur acceptait. Permission denied (publickey) signifie à lui seul que l’authentification par mot de passe est désactivée sur ce serveur ; aucun mot de passe ne peut donc prendre le relais. Permission denied (publickey,password) signifie que les mots de passe étaient proposés, mais que ces tentatives ont également échoué.

Un même message couvre cinq problèmes distincts, et son manque de précision est volontaire. Un serveur qui répondrait « utilisateur inexistant » ou « cette clé n’est pas installée » aiderait quiconque cherche des comptes valides. Ne commencez donc pas par remplacer les clés ou modifier les fichiers de configuration. Exécutez une commande, lisez trois lignes de sortie, et les cinq causes possibles se réduisent à une seule.

Exécutez d’abord ssh -v et lisez trois lignes

Répétez la commande qui a échoué en ajoutant -v :

ssh -v deploy@203.0.113.10

Voici un résultat tronqué mais réaliste :

OpenSSH_9.6p1 Ubuntu-3ubuntu13, OpenSSL 3.0.13 30 Jan 2024
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established.
debug1: Authenticating to 203.0.113.10:22 as 'deploy'
debug1: Authentications that can continue: publickey
debug1: Next authentication method: publickey
debug1: Will attempt key: /home/you/.ssh/id_ed25519 ED25519 SHA256:0eL/8sBw... agent
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:0eL/8sBw... agent
debug1: Authentications that can continue: publickey
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).

Trois lignes contiennent toutes les informations nécessaires.

Authenticating to 203.0.113.10:22 as 'deploy' est le nom d’utilisateur qui sera réellement utilisé. Ce n’est pas forcément celui que vous vouliez utiliser, mais celui que ssh a déterminé à partir de la ligne de commande, de ~/.ssh/config ou de votre nom de connexion local.

Authentications that can continue: publickey est la liste des méthodes acceptées par le serveur, envoyée avant toute tentative avec une clé. Si publickey ne figure pas dans cette première liste, l’authentification par clé publique est désactivée sur le serveur. Aucune clé ne pourra donc fonctionner.

Offering public key: ... est affiché pour chaque clé dont ssh possède déjà la partie publique, juste avant de proposer cette clé, suivi du type de clé et de son empreinte SHA256. Pour une clé lue depuis un fichier, ssh indique le nom de ce fichier. Pour une clé présente uniquement dans ssh-agent, ssh affiche le commentaire enregistré par l’agent à la place d’un chemin. Le mot agent à la fin de la ligne indique qu’un agent a fourni la clé. ssh affiche cette ligne juste avant de vérifier que les deux extrémités utilisent le même algorithme de signature pour la clé. Si la ligne suivante est send_pubkey_test: no mutual signature algorithm, cette clé n’a finalement pas été envoyée. La cause 5 couvre ce cas. Pour une clé dont ssh n’a pas pu lire à l’avance la partie publique, aucune ligne Offering n’est affichée. ssh journalise Trying private key: ... avec le seul nom du fichier, charge la clé privée, puis envoie immédiatement une requête signée. Une clé qui ne produit aucune de ces deux lignes n’a jamais été envoyée au serveur.

Séparez maintenant le problème en deux cas :

  • Aucune ligne Offering public key ou Trying private key ne correspond à la clé attendue. Le problème se trouve sur votre machine, car le serveur n’a jamais reçu votre clé.
  • La clé est proposée et Authentications that can continue: publickey réapparaît. Le serveur a reçu cette clé et l’a refusée. Le problème se trouve donc sur le serveur.

Les causes ci-dessous sont classées selon la fréquence à laquelle elles se révèlent être la bonne réponse.

Cause 1: vous utilisez le mauvais nom d’utilisateur

La cause la plus fréquente est aussi la moins intéressante. sshd, le daemon SSH (Secure Shell), ne vous indique jamais qu’un compte n’existe pas. Il exécute tout l’échange avec un nom d’utilisateur inventé, puis refuse la connexion à la fin avec le même message, car divulguer les noms de comptes valides facilite le travail d’un attaquant. Une faute de frappe dans le nom d’utilisateur ressemble exactement à un problème de clé.

Vérifiez la ligne Authenticating to ... as avant toute autre chose. Si elle contient le nom de connexion de votre ordinateur portable au lieu du compte du serveur, vous avez omis le nom d’utilisateur dans la commande.

ssh -v deploy@203.0.113.10
ssh -v root@203.0.113.10

Le compte par défaut dépend de l’image créée par votre fournisseur. En août 2026, les images cloud Ubuntu fournissent généralement un compte ubuntu, les images Debian un compte debian ou admin, Rocky Linux et AlmaLinux fournissent rocky et almalinux, et de nombreux fournisseurs de VPS installent directement votre clé dans root. Le panneau de contrôle de votre fournisseur indique le compte qu’il a créé. Aucune commande exécutée depuis l’extérieur du serveur ne peut le lui demander.

Un bloc Host dans ~/.ssh/config définit également le nom d’utilisateur, et ce nom est prioritaire sur celui de votre compte local :

Host vps-prod
  HostName 203.0.113.10
  User deploy

Si vous avez créé vous-même le compte et que vous n’avez ensuite pas pu vous y connecter, la clé a probablement été installée pour l’utilisateur par défaut de l’image et n’a jamais été copiée dans le nouveau compte. Cette étape fait partie des dix premières minutes sur un nouveau VPS, et il est facile de l’oublier.

Cause 2 : la clé que vous pensez envoyer n’est pas celle qui est envoyée

Par défaut, ssh propose uniquement les clés détenues par ssh-agent, ainsi qu’un ensemble fixe de noms de fichiers dans ~/.ssh : id_rsa, id_ecdsa, id_ed25519, les variantes pour clés matérielles id_ecdsa_sk et id_ed25519_sk, et la clé post-quantique hybride id_mldsa44_ed25519. Les versions actuelles d’OpenSSH ne prennent plus du tout DSA en charge (OpenSSH 10.0 a supprimé cette prise en charge en avril 2025). Un ancien fichier id_dsa n’est donc jamais essayé. Une clé enregistrée sous le nom ~/.ssh/vps-prod est invisible pour ssh tant que vous ne l’indiquez pas explicitement. C’est pourquoi la sortie verbeuse ne contient aucune ligne Offering public key correspondante.

Indiquez le nom du fichier et empêchez les clés de l’agent de prendre sa place :

ssh -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@203.0.113.10

-i seul ne suffit pas lorsque l’agent contient des clés, car ssh propose toujours d’abord les clés de l’agent, puis le fichier indiqué en dernier. C’est important, car un serveur exécutant une version d’OpenSSH antérieure à 10.6 compte chaque clé refusée dans MaxAuthTries, dont la valeur par défaut est 6. Un agent contenant sept clés peut atteindre cette limite avant que la bonne clé soit proposée. OpenSSH 10.6, publiée le 6 octobre 2026, ajoute le mot-clé max-pk-ok à l’option sshd existante PubkeyAuthOptions, sous la forme PubkeyAuthOptions max-pk-ok:6. Il permet au serveur de vérifier jusqu’à ce nombre de clés proposées, 6 par défaut, avant que les suivantes commencent à être comptées dans MaxAuthTries. La limite est ainsi augmentée, mais elle n’est pas supprimée. Lorsque la limite est atteinte, le message devient :

Received disconnect from 203.0.113.10 port 22:2: Too many authentication failures

Si c’est plutôt ce message qui s’affiche, le serveur a interrompu la session avant que votre bonne clé soit proposée. Ce cas est traité dans trop d’échecs d’authentification. IdentitiesOnly=yes limite la tentative au fichier que vous avez indiqué. Affichez les clés détenues par l’agent avec ssh-add -l, puis supprimez-les avec ssh-add -D s’il a accumulé d’anciennes clés au fil des années. Enregistrez ensuite ces paramètres afin que la prochaine connexion ne dépende pas du rappel des options :

Host vps-prod
  HostName 203.0.113.10
  User deploy
  IdentityFile ~/.ssh/vps-prod
  IdentitiesOnly yes

Autre problème côté client. ssh refuse d’utiliser une clé privée lisible par d’autres comptes sur votre propre machine. Il affiche un avertissement et refuse de charger la clé. Celle-ci ne peut donc pas servir à se connecter. Ne vous attendez toutefois pas à l’absence de la ligne Offering : lorsque ssh possède déjà la partie publique, par exemple grâce au fichier .pub placé à côté, il la propose. Le serveur peut répondre Server accepts key. ssh charge alors seulement la clé privée pour signer, affiche cet avertissement et abandonne cette clé :

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/you/.ssh/vps-prod' are too open.

chmod 600 ~/.ssh/vps-prod corrige le problème. Le transfert d’une clé sur une clé USB ou via un partage Windows est la cause habituelle de la perte des permissions. L’emplacement des clés et leur nommage sont expliqués dans Notions de base sur la gestion des clés SSH.

Cause 3 : la clé publique n’est jamais arrivée dans authorized_keys

Si ssh -v indique que la clé a bien été envoyée, mais que le serveur la refuse toujours, vérifiez ensuite si cette clé se trouve dans le fichier authorized_keys du compte. Ouvrez la console de votre fournisseur pour effectuer ce contrôle, car vous ne pouvez pas vous connecter en SSH pour le faire.

sudo ls -l /home/deploy/.ssh/
sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keys

ssh-keygen -lf sur un fichier authorized_keys affiche une empreinte par entrée :

256 SHA256:0eL/8sBw... you@laptop (ED25519)
3072 SHA256:9Tq2yZk... old-laptop (RSA)

Comparez ces empreintes avec celle de votre ligne Offering public key. Si votre clé a été envoyée sur une ligne Trying private key, cette ligne indique uniquement le fichier. Obtenez alors son empreinte avec ssh-keygen -lf sur le fichier .pub correspondant. Si elle n’apparaît pas dans la liste, la clé n’est pas installée pour ce compte, quelles que soient les opérations dont vous vous souvenez.

Voici quatre causes fréquentes :

  • Vous avez collé la clé privée au lieu du fichier .pub. Une ligne de clé publique contient un type de clé tel que ssh-ed25519, ecdsa-sha2-nistp256 ou ssh-rsa, suivi d’une longue chaîne base64 et d’un commentaire facultatif. Des options telles que restrict peuvent se trouver avant le type de clé. Une clé privée commence par -----BEGIN OPENSSH PRIVATE KEY-----.
  • Le collage s’est réparti sur plusieurs lignes. Chaque entrée doit tenir sur une seule ligne. Une clé répartie sur plusieurs lignes est donc lue comme plusieurs entrées incorrectes et ne correspond à rien.
  • La clé a été ajoutée dans /root/.ssh/authorized_keys alors que vous vous connectez avec deploy, ou inversement. Le fichier est propre à chaque compte. Il n’existe pas de fichier partagé.
  • Le champ « ajouter ma clé » du fournisseur l’a écrite uniquement pour l’utilisateur par défaut de l’image. Le compte que vous avez créé ensuite possède donc un répertoire .ssh vide.

Pour ajouter une clé depuis la console, en tant que root :

sudo install -d -m 700 -o deploy -g deploy /home/deploy/.ssh
sudo tee -a /home/deploy/.ssh/authorized_keys >/dev/null <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleKeyDataHere you@laptop
EOF
sudo chown deploy:deploy /home/deploy/.ssh/authorized_keys
sudo chmod 600 /home/deploy/.ssh/authorized_keys

Exécutez de nouveau sudo ssh-keygen -lf /home/deploy/.ssh/authorized_keys ensuite. La nouvelle empreinte doit maintenant apparaître dans la liste. Depuis une machine qui peut encore se connecter avec un mot de passe, ssh-copy-id -i ~/.ssh/vps-prod.pub deploy@203.0.113.10 ajoute la clé pour vous et crée .ssh et authorized_keys avec des permissions privées s’ils n’existent pas encore. Cette commande ne modifie pas les permissions d’un répertoire .ssh ou d’un fichier authorized_keys déjà existant. Vérifiez-les donc comme indiqué dans la cause 4.

Cause 4 : pourquoi sshd ignore authorized_keys lorsque les permissions sont trop ouvertes

StrictModes yes est la configuration par défaut de sshd. Avec cette configuration, sshd refuse de lire authorized_keys si ce fichier, le répertoire .ssh ou le répertoire personnel du compte peuvent être modifiés par un autre utilisateur que le propriétaire, ou appartiennent au mauvais compte. La raison est directe : si le groupe ou les autres utilisateurs peuvent écrire dans votre répertoire personnel, tout compte disposant de cet accès peut remplacer authorized_keys et prendre le contrôle de la connexion. sshd considère alors le chemin comme non fiable, comme si aucune clé n’existait.

Le client affiche le simple message Permission denied. Le journal du serveur indique la véritable cause :

Authentication refused: bad ownership or modes for directory /home/deploy/.ssh

ou, lorsque le problème concerne le fichier lui-même :

Authentication refused: bad ownership or modes for file /home/deploy/.ssh/authorized_keys

Ce que sshd accepte :

  • Le répertoire personnel : il ne doit pas être accessible en écriture au groupe ni aux autres utilisateurs. 755, 750 et 700 sont acceptés. 775 et 777 échouent.
  • ~/.ssh : la même règle s’applique. Le manuel de sshd recommande un accès réservé au propriétaire, soit le mode 700.
  • ~/.ssh/authorized_keys : la même règle s’applique, et il doit s’agir d’un fichier normal. Dans le cas contraire, le journal indique que le chemin is not a regular file. Le manuel recommande les droits de lecture et d’écriture pour le propriétaire uniquement, soit le mode 600.
  • Propriétaire : chaque élément doit appartenir au compte utilisé pour la connexion ou à root. Tout autre propriétaire fait échouer le contrôle.

Le propriétaire est aussi important que le mode. sshd lit authorized_keys avec le compte utilisé pour la connexion. Ainsi, si vous créez un fichier avec sudo nano et oubliez de le rendre à son propriétaire, il reste la propriété de root avec le mode 600. Il passe le contrôle du propriétaire, mais sshd ne peut pas l’ouvrir. Le journal indique alors qu’il n’a pas pu ouvrir le fichier. Corrigez les deux éléments en une seule fois :

sudo chown -R deploy:deploy /home/deploy/.ssh
sudo chmod 700 /home/deploy/.ssh
sudo chmod 600 /home/deploy/.ssh/authorized_keys
sudo chmod go-w /home/deploy
ls -ld /home/deploy /home/deploy/.ssh

La dernière commande affiche le résultat. Le répertoire personnel doit avoir drwxr-xr-x ou des permissions plus restrictives, et drwx------ doit être appliqué à .ssh. Si ces chaînes ne sont pas encore évidentes, consultez comment lire une chaîne de permissions telle que drwxr-xr-x avant de modifier les modes sur un serveur en production.

Sur Rocky Linux et AlmaLinux, ajoutez SELinux (Security-Enhanced Linux) à la liste des causes possibles. Un répertoire .ssh créé par un chemin inhabituel peut avoir le mauvais label de fichier. sshd se voit alors refuser l’accès en lecture, même si les modes sont corrects. sudo restorecon -Rv /home/deploy/.ssh rétablit les labels, et sudo ausearch -m avc -ts recent indique si SELinux est le composant qui a refusé l’accès.

Cause 5 : sshd est configuré pour vous refuser

La lecture de /etc/ssh/sshd_config ne suffit pas sur un système Ubuntu ou Debian récent. Ce fichier commence par Include /etc/ssh/sshd_config.d/*.conf, et OpenSSH conserve la première valeur qu’il trouve pour chaque paramètre. Un fichier drop-in tel que 50-cloud-init.conf est donc lu avant le reste du fichier principal et prend le dessus sur tout paramètre global que vous modifiez plus bas. L’exception est un bloc Match : le manuel de sshd_config indique que les paramètres qu’il contient remplacent ceux définis dans la section globale. Ainsi, un bloc Match correspondant, même placé à la fin du fichier principal, prend le dessus sur un drop-in pour les connexions auxquelles il s’applique. Les drop-ins sont eux-mêmes lus dans l’ordre lexical : un fichier nommé 00-something.conf est lu avant 50-cloud-init.conf, et le premier fichier qui définit une valeur l’emporte. C’est pourquoi une modification peut sembler correcte tout en ne changeant absolument rien.

Demandez à sshd la configuration effective qu’il construit à partir de tous ces fichiers :

sudo sshd -T | grep -Ei 'pubkeyauth|authorizedkeysfile|permitrootlogin|allowusers|allowgroups|denyusers'

sshd -T lance un nouveau processus de test qui lit les fichiers tels qu’ils se trouvent actuellement sur le disque. Il ne s’adresse pas au processus sshd déjà en cours d’exécution. Une modification que vous n’avez pas encore appliquée par un redémarrage apparaît donc ici avant que le serveur en cours d’exécution ne l’utilise.

Une réponse correcte ressemble à ceci :

permitrootlogin prohibit-password
pubkeyauthentication yes
authorizedkeysfile .ssh/authorized_keys .ssh/authorized_keys2

Voici les éléments à rechercher dans votre sortie :

  • pubkeyauthentication no. Aucune clé ne sera acceptée. Cela apparaît également dans ssh -v sous la forme d’une première liste Authentications that can continue: sans publickey.
  • authorizedkeysfile pointe vers un autre emplacement, par exemple /etc/ssh/authorized_keys/%u. Votre fichier dans le répertoire personnel est alors complètement ignoré, et les règles de permissions de la cause 4 s’appliquent au nouvel emplacement.
  • allowusers ou allowgroups est présent. Tout compte qui ne figure pas dans la liste est refusé avec exactement cette erreur et sans explication. denyusers et denygroups font l’inverse.
  • permitrootlogin no alors que vous essayez de vous connecter en tant que root. prohibit-password est le réglage intermédiaire utile : root peut utiliser une clé, mais pas un mot de passe.

Les blocs Match n’apparaissent pas dans un sshd -T simple, car leur résultat dépend de l’identité de la personne qui se connecte. Demandez le résultat pour une connexion précise :

sudo sshd -T -C user=deploy,host=vps.example.com,addr=198.51.100.7

Un autre paramètre concerne les clés plus anciennes. OpenSSH 8.8 a cessé d’accepter par défaut les signatures SHA-1 (ssh-rsa). Une clé RSA qui fonctionnait depuis des années peut donc cesser de fonctionner après une mise à niveau d’un côté lorsque l’autre côté est trop ancien pour utiliser RSA avec SHA-256. Un client récent qui communique avec un serveur ancien de ce type l’indique clairement :

debug1: send_pubkey_test: no mutual signature algorithm

La clé elle-même est généralement correcte. Les notes de version d’OpenSSH 8.8 indiquent qu’il n’est pas nécessaire de remplacer les clés ssh-rsa, car elles basculent vers RSA/SHA-256 ou RSA/SHA-512 lorsque les deux extrémités le prennent en charge. La mise à niveau de l’extrémité ancienne constitue donc une correction durable. Si vous ne pouvez pas la mettre à niveau, une nouvelle clé fonctionne également à condition que l’extrémité ancienne exécute OpenSSH 6.5 ou une version ultérieure, qui est la version ayant ajouté Ed25519 (RSA avec SHA-256 n’est arrivé qu’avec la version 7.2) : ssh-keygen -t ed25519 -C "deploy@vps-prod", puis installez le fichier .pub comme indiqué plus haut. Une extrémité antérieure à la version 6.5 ne prend en charge ni Ed25519 ni RSA avec SHA-256. Une nouvelle clé Ed25519 ne l’aidera donc pas. Définir PubkeyAcceptedAlgorithms +ssh-rsa du côté mis à niveau, dans un bloc Host du ~/.ssh/config du client ou dans la configuration sshd du serveur, réactive les anciennes signatures et vous permet de vous connecter aujourd’hui. Considérez donc cette modification comme un moyen d’accéder à la machine, et non comme la fin du travail. Les autres paramètres côté serveur qu’il est utile de vérifier sont présentés dans le renforcement de la sécurité du serveur SSH sur un VPS.

Comment vérifier qu’une clé privée correspond à la clé publique installée

La plupart des incertitudes liées à cette erreur viennent du fait qu’on ne sait pas si deux fichiers forment une paire. Une commande permet de le vérifier :

ssh-keygen -y -f ~/.ssh/vps-prod

Cette commande affiche la clé publique dérivée de la clé privée. Elle ne lit jamais le fichier .pub placé à côté. Elle indique donc la véritable clé associée à la clé privée, et non ce qu’affirme un fichier .pub obsolète. Si la clé est protégée par une phrase secrète, la commande vous la demande. Cela confirme également que vous connaissez toujours cette phrase secrète.

ssh-keygen -lf ~/.ssh/vps-prod.pub
ssh-add -l

La première commande affiche l’empreinte d’un fichier de clé publique. La seconde affiche les empreintes que votre agent détient. Comparez les quatre représentations de cette même chaîne : l’empreinte de la ligne Offering public key de ssh -v, l’empreinte de votre fichier .pub, les empreintes dans ssh-keygen -lf sur le authorized_keys du serveur et l’empreinte dans le journal du serveur. L’endroit où elles cessent de correspondre indique votre erreur.

Lire les journaux du serveur lorsque la connexion échoue

Le client ne reçoit volontairement aucune information utile. Le serveur enregistre la véritable raison de l’échec. Lancez le suivi des journaux dans la session de console, puis exécutez depuis votre ordinateur portable la commande ssh qui échoue.

sudo journalctl -u ssh -f

L’image cloud standard d’Ubuntu 24.04 installe rsyslog par défaut (son manifeste de paquets le répertorie au 3 novembre 2026). Les mêmes enregistrements sont donc également écrits dans /var/log/auth.log. Les images cloud minimales d’Ubuntu 24.04 sont livrées sans rsyslog. Elles ne disposent donc pas de auth.log par défaut ; les journaux systemd sont alors la source à consulter. Sous Rocky Linux et AlmaLinux, l’unité s’appelle sshd et les mêmes enregistrements sont également écrits dans /var/log/secure.

Définissez LogLevel VERBOSE dans la configuration de sshd, puis rechargez le service. Chaque tentative enregistre alors l’empreinte de la clé effectivement reçue par le serveur :

Failed publickey for deploy from 198.51.100.7 port 49812 ssh2: ED25519 SHA256:0eL/8sBw...

Cette ligne indique de quel côté se situe le problème. Si vous reconnaissez l’empreinte, votre clé est bien arrivée au serveur, qui l’a refusée. Examinez donc les causes 3, 4 et 5. Si vous ne reconnaissez pas l’empreinte, votre client a envoyé une clé différente de celle prévue. Revenez alors à la cause 2.

Si les journaux restent peu explicites, lancez un second sshd sur un autre port en mode debug. Il reste au premier plan, accepte une seule connexion, affiche son raisonnement, puis se termine :

sudo /usr/sbin/sshd -ddd -p 2222

Depuis la session de console du même serveur, connectez-vous à cette instance via l’adresse loopback :

ssh -p 2222 -i ~/.ssh/vps-prod -o IdentitiesOnly=yes deploy@127.0.0.1

Le passage par 127.0.0.1 exclut du test le réseau situé entre vous et le serveur. Le trafic loopback passe tout de même par le packet filter du kernel. Sous Ubuntu, les règles ufw par défaut acceptent toutefois tout le trafic sur l’interface lo. Le port 2222 ne nécessite donc pas de règle de firewall spécifique, sauf si cette règle par défaut a été supprimée. La sortie de debug indique le fichier ouvert, l’empreinte comparée et le refus exact, notamment avec des lignes telles que Authentication refused: bad ownership or modes for directory /home/deploy. Appuyez sur Ctrl+C dès que vous avez trouvé la cause. Le sshd réel, sur le port 22, reste entièrement inchangé pendant toute l’opération.

Comment éviter de vous verrouiller dehors

Chaque étape qui modifie la configuration du serveur doit prévoir un accès de secours qui ne dépend pas de SSH. Configurez-le tant que SSH fonctionne, et non après une panne. Si vous joignez déjà ce serveur par Tailscale SSH, comme dans notre guide pour suivre vos agents Claude Code avec herdr sur un VPS, gardez aussi ce chemin en réserve : les connexions vers l’adresse Tailscale du serveur sont traitées par le daemon tailscaled sans passer par sshd ni par authorized_keys, mais elles ne remplacent pas la console du fournisseur.

  1. Ouvrez la console de votre fournisseur, via une connexion série ou VNC (virtual network computing), puis vérifiez que vous pouvez vous y connecter.
  2. Assurez-vous de connaître un mot de passe local valide pour un compte disposant de sudo. Si vous n’en avez pas, réinitialisez d’abord le mot de passe root depuis la console du fournisseur.
  3. Gardez votre session SSH actuelle ouverte. Une session ouverte survit à systemctl restart ssh, donc elle reste un moyen de rétablir l’accès si la nouvelle configuration est incorrecte.
  4. Vérifiez la syntaxe avant de redémarrer : sudo sshd -t n’affiche rien lorsque le fichier est valide et affiche le fichier ainsi que le numéro de ligne lorsqu’il ne l’est pas.
  5. Ouvrez un second terminal et connectez-vous avec une nouvelle session avant de fermer la première. Une configuration incorrecte bloque les nouvelles connexions, mais laisse les connexions existantes intactes. La session que vous utilisez ne permet donc pas de vérifier si la modification a fonctionné.

Redémarrez avec sudo systemctl restart ssh sur Debian et Ubuntu, ou avec sudo systemctl restart sshd sur Rocky Linux et AlmaLinux. Sur Ubuntu 24.04, sshd est démarré depuis une unité socket dont le port et l’adresse proviennent de sshd_config via un générateur systemd. Une modification de Port ou de ListenAddress nécessite donc aussi sudo systemctl daemon-reload, puis sudo systemctl restart ssh.socket, avant de prendre effet.

FAQ

Pourquoi « Permission denied (publickey) » s’affiche-t-il alors que la même clé fonctionne sur un autre serveur ?

Parce que la clé est correcte et que le problème vient d’un élément associé. Exécutez ssh -v et recherchez la ligne Offering public key ou Trying private key correspondant à votre clé. Si votre clé n’apparaît dans aucune des deux, ssh ne l’a jamais envoyée : le fichier n’est pas présent dans ~/.ssh sous un nom par défaut et la clé n’est pas chargée dans l’agent. Ajoutez-la donc avec -i /path/to/key -o IdentitiesOnly=yes. Si la clé apparaît mais que le serveur la refuse toujours, elle ne figure pas dans le fichier authorized_keys du compte, le chemin qui y mène est accessible en écriture au groupe, ou la configuration de sshd bloque l’utilisateur. Le journal du serveur permet de distinguer ces cas.

Comment voir quelle clé SSH envoie réellement ?

ssh -v host affiche une ligne debug1: Offering public key: pour chaque clé dont il possède déjà la partie publique, avec le type de clé et une empreinte SHA256. Une clé lue depuis un fichier indique ce fichier, tandis qu’une clé détenue uniquement par l’agent affiche le commentaire de l’agent. La mention agent à la fin de la ligne indique que la clé a été fournie par l’agent. Si la ligne suivante est send_pubkey_test: no mutual signature algorithm, cette clé n’a finalement pas été envoyée. Pour une clé dont ssh n’a pas pu lire la partie publique à l’avance, aucune ligne Offering n’est affichée : ssh affiche Trying private key: avec le nom du fichier, charge la clé privée et envoie directement une demande signée. ssh-add -l liste les empreintes détenues par l’agent. ssh-keygen -lf ~/.ssh/id_ed25519.pub affiche l’empreinte d’un fichier de clé unique, et ssh-keygen -y -f ~/.ssh/id_ed25519 affiche la clé publique réellement dérivée d’une clé privée. Pour que la connexion réussisse, l’empreinte de la clé envoyée doit également apparaître dans ssh-keygen -lf exécuté sur le authorized_keys du serveur.

Pourquoi sshd ignore-t-il mon fichier authorized_keys ?

Parce que StrictModes est activé par défaut, et que le fichier, le répertoire .ssh ou le répertoire personnel est accessible en écriture au groupe ou à tout le monde, ou appartient à un compte différent du vôtre ou de root. sshd ne fait pas confiance à un chemin qu’une autre personne peut modifier. Il se comporte donc comme si aucune clé n’existait. Le contrôle exige qu’aucun des trois éléments ne soit accessible en écriture au groupe ou aux autres utilisateurs, que chacun appartienne au compte de connexion ou à root, et que authorized_keys soit un fichier normal. Supprimer les permissions d’écriture ne suffit donc pas toujours. Utilisez 755 ou une valeur plus restrictive sur le répertoire personnel, 700 sur .ssh et 600 sur authorized_keys, tous appartenant au compte de connexion. Avec LogLevel VERBOSE, le serveur enregistre Authentication refused: bad ownership or modes for directory /home/deploy/.ssh.

Ma clé a cessé de fonctionner juste après une mise à niveau du serveur. Qu’est-ce qui a changé ?

S’il s’agit d’une clé RSA, il s’agit très probablement du changement concernant SHA-1. OpenSSH 8.8 désactive par défaut les signatures SHA-1 ssh-rsa. Une clé RSA est donc refusée lorsque l’autre extrémité ne peut l’utiliser que de cette manière. Un client récent affiche debug1: send_pubkey_test: no mutual signature algorithm. Il n’est pas nécessaire de remplacer la clé si vous pouvez mettre à niveau l’ancienne extrémité, car les clés RSA utilisent SHA-256 ou SHA-512 lorsque les deux extrémités les prennent en charge. Si ce n’est pas possible et que l’ancienne extrémité exécute OpenSSH 6.5 ou une version ultérieure, générez une clé moderne avec ssh-keygen -t ed25519 et installez son fichier .pub. Une extrémité antérieure à 6.5 ne prend en charge ni Ed25519 ni RSA avec SHA-256. Une nouvelle clé ne résout donc pas ce cas. Si vous devez récupérer l’accès immédiatement, PubkeyAcceptedAlgorithms +ssh-rsa sur l’extrémité mise à niveau réactive les anciennes signatures. Supprimez cette ligne dès que le correctif durable est en place.

J’ai modifié sshd_config et je ne peux plus me connecter. Comment récupérer l’accès ?

Utilisez la console de votre fournisseur, qui ne passe pas par SSH. Connectez-vous avec un mot de passe local, exécutez sudo sshd -t pour afficher l’erreur de syntaxe et son numéro de ligne, annulez la modification, puis redémarrez le service. Exécutez ensuite sudo sshd -T pour afficher les valeurs effectives produites par les fichiers actuels, car un fichier situé dans /etc/ssh/sshd_config.d/ peut remplacer la configuration principale. Cette commande relit les fichiers au lieu d’interroger le sshd en cours d’exécution. Redémarrez donc le service après toute nouvelle modification avant de tester une connexion. Si vous n’avez pas de mot de passe local, réinitialisez d’abord le mot de passe root depuis la console, puis corrigez le fichier.

Cet article vous a-t-il été utile ?