Comment configurer des clés SSH ?
Dans cet article
Avec des clés SSH, vous vous connectez à votre VPS avec une paire de clés au lieu d'un mot de passe. La partie privée reste sur votre ordinateur, la partie publique va sur le serveur. Une fois la connexion par mot de passe désactivée, un bot qui tente de deviner des mots de passe n'a plus aucune chance. Ce guide concerne un VPS ou un serveur dédié Linux sous Ubuntu, Debian ou AlmaLinux ; sur un VPS Windows, vous vous connectez via le Bureau à distance.
Étape 1 : créer une paire de clés
Créez la clé sur votre propre ordinateur, pas sur le VPS. Windows 10 et 11 (dans PowerShell), macOS et Linux intègrent ssh-keygen :
ssh-keygen -t ed25519
Appuyez sur Entrée pour enregistrer la clé à l'emplacement par défaut et choisissez une phrase de passe (passphrase) : un fichier de clé volé ne suffira alors pas. Vous obtenez deux fichiers dans le dossier .ssh de votre dossier utilisateur :
id_ed25519: votre clé privée. Ne la partagez jamais et gardez-en une copie ; sans ce fichier, vous ne pourrez plus vous connecter avec cette clé après l'étape 4.id_ed25519.pub: votre clé publique. C'est elle qui va sur le VPS.
Ed25519 est le type de clé recommandé par Ubuntu : court, rapide et sûr. Vous préférez PuTTY ? Passez les étapes 1 et 2 et suivez la section Avec PuTTY sous Windows plus bas.
Étape 2 : placer la clé publique sur votre VPS
Vous vous connectez une dernière fois avec le mot de passe de votre e-mail de livraison. Sous macOS et Linux, une seule commande suffit :
ssh-copy-id root@votre-ip
Windows ne dispose pas de ssh-copy-id ; dans PowerShell, faites la même chose avec :
type $env:USERPROFILE\.ssh\id_ed25519.pub | ssh root@votre-ip "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"
Remplacez votre-ip par l'adresse IP de votre VPS. Si vous avez créé votre propre utilisateur (voir Sécuriser un VPS : les 30 premières minutes), indiquez son nom à la place de root : la clé ne fonctionne que pour l'utilisateur chez qui vous l'installez.
Étape 3 : tester dans une deuxième session
Laissez votre session actuelle ouverte et ouvrez une nouvelle fenêtre de terminal :
ssh root@votre-ip
Si SSH demande maintenant la phrase de passe de votre clé (Enter passphrase for key) au lieu du mot de passe du serveur, la clé fonctionne. S'il demande encore le mot de passe du serveur, ne passez pas à l'étape 4 et consultez d'abord les problèmes fréquents ci-dessous.
Étape 4 : désactiver la connexion par mot de passe
Ne modifiez pas /etc/ssh/sshd_config directement ; créez plutôt votre propre fichier de réglages dans le dossier sshd_config.d :
sudo nano /etc/ssh/sshd_config.d/00-securite.conf
Ajoutez-y cette ligne et enregistrez avec Ctrl + X, Y, Entrée :
PasswordAuthentication no
Pourquoi ainsi ? OpenSSH retient la première valeur qu'il rencontre pour chaque réglage, et les fichiers de sshd_config.d sont lus par ordre alphabétique, avant le reste de sshd_config. Sur les images cloud, cloud-init ajoute parfois un fichier 50-cloud-init.conf avec PasswordAuthentication yes ; une modification dans sshd_config lui-même est alors ignorée. Avec 00- dans le nom, votre fichier passe en premier. Vérifiez les réglages et redémarrez le serveur SSH :
sudo sshd -t && sudo systemctl restart ssh
sudo sshd -T | grep -i '^passwordauthentication'
La dernière ligne doit afficher passwordauthentication no. Sous Ubuntu et Debian, le service s'appelle ssh ; sous Ubuntu 24.04, systemctl restart sshd échoue avec Unit sshd.service not found. Seuls AlmaLinux et Rocky Linux appellent le service sshd :
sudo sshd -t && sudo systemctl restart sshd
Ouvrez ensuite une nouvelle fenêtre et vérifiez que vous vous connectez avec votre clé. Ne fermez votre première session qu'une fois que cela fonctionne.
Avec PuTTY sous Windows
Si vous utilisez PuTTY, créez la clé avec PuTTYgen, installé en même temps que PuTTY. Les étapes 3 et 4 ci-dessus restent identiques.
- Ouvrez PuTTYgen. En bas, sous Type of key to generate, choisissez EdDSA (appelé Ed25519 dans les anciennes versions) et vérifiez que Ed25519 (255 bits) est sélectionné.
- Cliquez sur Generate et déplacez la souris sur la zone vide jusqu'à ce que la barre soit pleine.
- Saisissez une phrase de passe solide dans Key passphrase et Confirm passphrase. Si vous l'oubliez, vous ne pourrez plus utiliser la clé.
- Cliquez sur Save private key et rangez le fichier
.ppken lieu sûr. - Copiez tout le texte du champ Public key for pasting into OpenSSH authorized_keys file. Il commence par
ssh-ed25519et tient sur une seule longue ligne. - Connectez-vous à votre VPS avec PuTTY (voir se connecter au VPS en SSH) et ouvrez le fichier des clés :
mkdir -p ~/.ssh && chmod 700 ~/.ssh
nano ~/.ssh/authorized_keys
- Collez la clé publique sur une nouvelle ligne avec le bouton droit de la souris, enregistrez avec Ctrl + X, Y, Entrée et réglez les droits :
chmod 600 ~/.ssh/authorized_keys
- Dans PuTTY, saisissez l'adresse IP de votre VPS sous Session. Allez dans Connection > SSH > Auth > Credentials (directement sous Auth dans les anciennes versions) et choisissez votre fichier
.ppksous Private key file for authentication. Revenez à Session, donnez un nom à la session sous Saved Sessions et cliquez sur Save pour que PuTTY retienne la clé. - Ouvrez la session dans une nouvelle fenêtre PuTTY : PuTTY demande maintenant la phrase de passe de votre clé au lieu du mot de passe. Si cela fonctionne, passez à l'étape 4 ci-dessus.
Problèmes fréquents
Unit sshd.service not found: sous Ubuntu et Debian, le service s'appellessh. Utilisezsudo systemctl restart ssh.- Le mot de passe du serveur est toujours demandé : la clé n'est pas installée pour l'utilisateur avec lequel vous vous connectez, ou les droits sont incorrects. Sur le VPS, vérifiez avec
cat ~/.ssh/authorized_keysque votre clé y figure sur une seule ligne, puis réglez les droits avecchmod 700 ~/.sshetchmod 600 ~/.ssh/authorized_keys.ssh -v root@votre-ipmontre quelles clés votre ordinateur propose. - La connexion par mot de passe fonctionne encore après l'étape 4 : un autre fichier est prioritaire, ou votre fichier n'est pas lu. Vérifiez avec
sudo grep -ri passwordauthentication /etc/ssh/sshd_config /etc/ssh/sshd_config.d/où le réglage apparaît encore, et assurez-vous que votre fichier se termine par.conf: les autres fichiers de ce dossier sont ignorés. Server refused our key(PuTTY) : vous avez collé le mauvais texte, par exemple le contenu d'un fichier enregistré avec Save public key.authorized_keysattend la ligne unique qui commence parssh-ed25519, copiée depuis le champ en haut de PuTTYgen.- Vous ne pouvez plus vous connecter (
Permission denied (publickey)) : utilisez la console de votre panneau VPS (voir se connecter via VNC), qui fonctionne indépendamment de SSH. Connectez-vous-y avec votre mot de passe root, supprimez/etc/ssh/sshd_config.d/00-securite.confet exécutezsystemctl restart ssh. Vous pourrez alors vous reconnecter avec votre mot de passe et reconfigurer la clé.
Besoin d'aide ?
Avec une clé SSH et la connexion par mot de passe désactivée, votre VPS est bien mieux protégé. Les étapes suivantes, comme un utilisateur dédié, un pare-feu et fail2ban, sont détaillées dans Sécuriser un VPS : les 30 premières minutes. Vous êtes bloqué ? Ouvrez un ticket via notre page support. N'envoyez jamais votre clé privée.
Lancez votre serveur en 60 secondes sur notre propre matériel.