Aller au contenu

SSH

SSH, pour secure shell, ouvre un terminal sur une autre machine à travers le réseau. Tout ce qui passe est chiffré. C'est la façon normale d'administrer un serveur, qui n'a ni écran ni clavier.

Le problème

Le jour où le jeu a besoin d'un serveur, par exemple pour un classement en ligne, ce serveur est une machine distante : dans une machine virtuelle, ou louée chez un hébergeur. Il faut pouvoir y installer Python, y copier le code, lire ses journaux. Tout cela se fait par SSH.

On s'en sert aussi sans le savoir : envoyer du code sur GitHub avec une adresse en git@github.com:... passe par SSH.

La notion

Client et serveur

TerminalBash
ssh alice@192.168.1.20
MorceauSens
aliceLe compte utilisateur sur la machine distante
192.168.1.20L'adresse de la machine, ou son nom
-p 2222Le port, si ce n'est pas le port 22 habituel

Une fois connecté, l'invite change : chaque commande tapée s'exécute là-bas. On revient avec exit ou Ctrl + D.

La première connexion

Code
The authenticity of host '192.168.1.20' can't be established. ED25519 key fingerprint is SHA256:Xk3... Are you sure you want to continue connecting (yes/no)?

SSH demande de confirmer l'identité du serveur. Une fois acceptée, son empreinte est rangée dans ~/.ssh/known_hosts. Si elle change un jour, SSH refuse de se connecter et affiche un avertissement : soit le serveur a été réinstallé, soit quelqu'un se fait passer pour lui.

Mot de passe ou clés

On peut s'identifier avec le mot de passe du compte distant. C'est simple, mais un mot de passe se devine et se vole. La bonne méthode est la paire de clés.

CléOù elle estPeut-on la donner ?
Privée, ~/.ssh/id_ed25519Uniquement sur votre machineJamais
Publique, ~/.ssh/id_ed25519.pubCopiée sur chaque serveurOui, à tout le monde

L'image à garder : la clé publique est un cadenas qu'on distribue, la clé privée est la seule clé qui l'ouvre.

La clé privée ne quitte jamais la machine. Le serveur vérifie seulement qu'on la possède.

Mettre en place ses clés

  1. Créer la paire. Une seule fois par machine.

    TerminalBash
    ssh-keygen -t ed25519 -C "alice@portable"

    La commande demande où ranger la clé, on garde l'emplacement proposé, puis une phrase secrète qui protège la clé privée si le fichier est volé.

  2. Copier la clé publique sur le serveur. Le mot de passe du compte distant est demandé une dernière fois.

    TerminalBash
    ssh-copy-id alice@192.168.1.20

    La clé est ajoutée au fichier ~/.ssh/authorized_keys du compte distant.

  3. Vérifier. La connexion ne demande plus le mot de passe du compte.

    TerminalBash
    ssh alice@192.168.1.20

Se simplifier la vie avec un fichier de configuration

Le fichier ~/.ssh/config donne un nom court à chaque machine.

Code
Host vm-jeu HostName 127.0.0.1 Port 2222 User alice
TerminalBash
ssh vm-jeu # au lieu de : ssh -p 2222 alice@127.0.0.1

Copier des fichiers

CommandeEffet
scp fichier.py vm-jeu:~/Copie un fichier vers le dossier personnel distant
scp vm-jeu:~/scores.json .Rapatrie un fichier dans le dossier courant
scp -r server vm-jeu:~/Copie un dossier entier
rsync -av server/ vm-jeu:~/server/Synchronise : n'envoie que ce qui a changé

On peut aussi lancer une seule commande sans ouvrir de session :

TerminalBash
ssh vm-jeu "ls -la ~/server"

SSH et GitHub

GitHub accepte une clé SSH à la place du mot de passe. On colle le contenu de la clé publique dans les réglages du compte, puis on teste :

TerminalBash
cat ~/.ssh/id_ed25519.pub # le texte à coller ssh -T git@github.com # doit répondre par un message de bienvenue

Les erreurs fréquentes

MessageCause probable
Connection refusedAucun serveur SSH n'écoute sur ce port
Connection timed outMauvaise adresse, machine éteinte, ou pare-feu
Permission denied (publickey)Clé publique absente du serveur, ou mauvais nom d'utilisateur
REMOTE HOST IDENTIFICATION HAS CHANGEDL'empreinte du serveur a changé. Comprendre pourquoi avant de l'effacer

L'option -v affiche le détail de la connexion et montre à quelle étape elle échoue : ssh -v vm-jeu.

Les règles de sécurité

  • La clé privée ne se copie pas, ne s'envoie pas, ne va pas dans Git.
  • Une paire de clés par machine. Si un portable est perdu, on retire sa clé publique des serveurs, et les autres continuent de fonctionner.
  • Une phrase secrète sur la clé privée.
  • Sur un serveur exposé à Internet, on désactive la connexion par mot de passe une fois les clés en place.

À retenir

  • ssh utilisateur@machine ouvre un terminal distant.
  • Clé privée chez soi, clé publique sur les serveurs.
  • ~/.ssh/config pour nommer ses machines.
  • scp et rsync pour les fichiers.

Exercices

  1. Créer une paire de clés et afficher la clé publique. Vérifier les droits des deux fichiers avec ls -l ~/.ssh.
  2. Se connecter à la machine virtuelle du cours VirtualBox avec un mot de passe, puis installer sa clé et se reconnecter sans.
  3. Ajouter une entrée vm-jeu dans ~/.ssh/config.
  4. Copier le dossier src du jeu sur la machine virtuelle, puis compter ses lignes à distance en une seule commande.
  5. Ajouter sa clé publique à son compte GitHub et vérifier avec ssh -T git@github.com.