Comment se connecter à votre serveur d'hébergement en SSH

Ce guide explique comment configurer SSH pour vous connecter à votre serveur d'hébergement via un alias court, sans devoir saisir un mot de passe à chaque connexion.

Vous allez apprendre à rassembler les informations nécessaires, générer une paire de clés SSH, copier votre clé publique sur le serveur et configurer ~/.ssh/config pour obtenir un raccourci pratique.

Pour cet article, partons du principe que vous avez un compte d'hébergement PlanetHoster. À la fin de ce guide, vous pourrez vous connecter à votre serveur PlanetHoster avec une simple commande du type ssh planethoster.

Le résultat​

Une fois la clé et l'alias ~/.ssh/config en place (voir plus bas), démarrer une session tient en une commande — immédiat, sans demande de mot de passe :

Pourquoi ça marche​

• Votre clé publique est copiée dans le fichier ~/.ssh/authorized_keys du serveur — le serveur peut vérifier votre identité sans jamais voir de mot de passe.
• Un court bloc dans ~/.ssh/config regroupe l'host, le port, l'utilisateur et la clé sous un seul alias — ssh planethoster au lieu d'une commande à quatre options à retenir.
• Une fois la clé en place, il n'y a plus rien à taper ni à retaper — le « mot de passe à chaque fois » évoqué en ouverture de cet article, c'est fini.

Installation​

Pour les trois premiers éléments, connectez-vous au tableau de bord PlanetHoster.

Vous arrivez sur la page du tableau de bord. Dans la barre latérale gauche, allez dans Hébergement Web --> Gestion du compte et cliquez sur la flèche pour ouvrir la page :

En haut de la page, vous trouverez les trois informations nécessaires :

• Le Current user : le nom d'utilisateur à utiliser pour SSH.
• Le nom de votre serveur (et son adresse IP).
• Le port SSH à utiliser (probablement 5022).

La quatrième information à rassembler est le mot de passe associé à votre compte utilisateur.

Si vous passez par un autre hébergeur, les étapes pour obtenir ces informations seront différentes. Reportez-vous à la documentation de votre fournisseur.

D'abord, essayez une connexion SSH manuelle​

Dans une console Linux (ou Windows Powershell), lancez la commande suivante :

$ ssh -p 5022 john_doe@node30-eu.n0c.com▋

Un mot de passe vous sera demandé ; saisissez celui de votre compte.

Si tout est correctement configuré, vous obtenez un shell. Vous serez dans le répertoire home de votre utilisateur (et non à la racine du système).

Tapez ls -al pour lister les fichiers et pwd ou whoami pour confirmer que vous êtes bien dans votre répertoire home :

Créer une clé SSH pour se connecter à PlanetHoster​

À l'étape précédente, nous avons confirmé que la connexion au serveur fonctionne avec nos identifiants. Améliorons maintenant la connexion en mettant en place une authentification par clé SSH. Cela permettra de se connecter sans mot de passe par la suite.

Créer une clé SSH​

Sur votre machine locale, lancez dans votre terminal une commande du type ssh-keygen -t ed25519 -C "john_doe" -f ~/.ssh/id_ed25519_hosting. Le même mécanisme de clé est utilisé pour dialoguer avec GitHub, comme décrit dans GitHub - Connectez votre compte en SSH et travaillez avec le protocole git@. Cela crée une clé SSH privée nommée ~/.ssh/id_ed25519_hosting (et la clé publique associée ~/.ssh/id_ed25519_hosting.pub).

Une passphrase vous sera demandée. Vous pouvez en définir une pour plus de sécurité, ou la laisser vide par confort (dans cet article, je n'utilise pas de passphrase).

Copier votre clé sur le serveur​

Pour pouvoir vous connecter sans mot de passe, vous devez copier votre clé publique sur le serveur.

Lancez ssh-copy-id -i ~/.ssh/id_ed25519_hosting -p 5022 john_doe@node30-eu.n0c.com pour copier votre clé publique sur le serveur d'hébergement.

Votre mot de passe vous sera demandé une dernière fois.

$ ssh-copy-id -i ~/.ssh/id_ed25519_hosting -p 5022 john_doe@node30-eu.n0c.com

/usr/bin/ssh-copy-id: INFO: Source of key(s) to be installed: "/home/john_doe/.ssh/id_ed25519_hosting.pub"
/usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that are already installed
/usr/bin/ssh-copy-id: INFO: 1 key(s) remain to be installed -- if you are prompted now it is to install the new keys

john_doe@node30-eu.n0c.com's password:

Number of key(s) added: 1
▋

Vérifiez que vous voyez bien un message indiquant que la ou les clés ont été ajoutées avec succès.

Dès à présent, vous pourrez vous connecter sans fournir de mot de passe.

Lancez la commande ci-dessous pour tester :

$ ssh -i ~/.ssh/id_ed25519_hosting -p 5022 john_doe@node30-eu.n0c.com▋

Comme prévu, vous serez connecté immédiatement, sans demande de mot de passe, grâce à notre clé SSH.

Simplifier la commande avec un fichier de configuration SSH​

La commande précédente est assez longue, non ? Peut-on la simplifier ? Oui !

Simplifions-la pour n'avoir qu'à taper ssh planethoster.

Pour cela, lancez vi ~/.ssh/config (ou votre éditeur préféré) pour ouvrir votre fichier de configuration SSH. Si le fichier n'existe pas encore, créez-le.

Ajoutez le bloc ci-dessous à la fin du fichier (pensez à adapter les valeurs à votre configuration) :

Host planethoster?
    HostName node30-eu.n0c.com?
    User john_doe
    Port 5022?
    IdentityFile ~/.ssh/id_ed25519_hosting?

Enregistrez et fermez le fichier (astuce : c'est :w! dans vi).

Ensuite, définissez les bonnes permissions sur votre clé en lançant chmod 0600 ~/.ssh/id_ed25519_hosting*. Les fichiers de clés (privée et publique) ne seront ainsi accessibles que par vous.

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@         WARNING: UNPROTECTED PRIVATE KEY FILE!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/john_doe/.ssh/id_ed25519_hosting' are too open.

Établir une connexion SSH simplifiée​

Désormais, pour démarrer une connexion SSH vers votre host, ouvrez un terminal et lancez ssh planethoster (ou l'alias que vous avez défini). Si tout est bien configuré, vous serez connecté immédiatement et sans demande de mot de passe — exactement le résultat montré en début d'article.

Autres démos​

Dépannage et astuces​

• Si une connexion échoue, lancez le client SSH en mode verbeux pour voir la sortie de debug : ssh -vvv -p 5022 john_doe@node30-eu.n0c.com (autrement dit, ajoutez -vvv comme option supplémentaire).
• Si vous voyez une erreur WARNING: UNPROTECTED PRIVATE KEY FILE!, vérifiez les permissions locales de votre clé privée et utilisez chmod 600 comme montré plus haut.
• Si besoin, connectez-vous au serveur et vérifiez que votre clé est bien présente dans ~/.ssh/authorized_keys et que ~/.ssh et authorized_keys ont les bonnes permissions (lancez simplement vi ~/.ssh/authorized_keys pour ouvrir le fichier, l'éditer et supprimer les clés indésirables).

Conclusion​

Ce guide a montré comment mettre en place un accès SSH par clé vers un serveur d'hébergement et créer un raccourci ssh planethoster.

Une fois que vous aurez accumulé une dizaine d'alias dans ~/.ssh/config, les retenir deviendra le nouveau problème ; Maîtrisez votre commande ssh et choisissez l'host dans une liste les transforme en un sélecteur interactif.