2024-05-13
Ces derniers temps je travaille sur pas mal de portage d'applications sous Windows (et macOS, mais c'est pas le sujet du jour). Quand je développe des applications pour des OS différents de Linux, le workflow le plus confortable pour moi est le suivant :
Bon dans les faits j'ai un petit script qui reprend toutes ces étapes pour pas avoir à me taper les diverses commandes à la main. 😉️
Aujourd'hui on va donc voir comment installer et configurer un serveur OpenSSH sous Windows.
Vous l'aurez compris, cet article est avant tout un mémo pour moi-même, par ce que j'en ai marre de faire les mêmes recherches en boucle, et de tomber à chaque fois sur plein de sites douteux et plein de pubs avec la moitié des infos manquantes... 😅️
--------------------------------------------------------------------------------
📝️ Note:
--------------------------------------------------------------------------------
NOTE : Cet article n'est pas une introduction à OpenSSH : je pars du principe que vous êtes déjà un minimum familiers avec SSH.
Je vais par exemple aborder la connexion par clef, mais je n'expliquerai pas comment générer une paire de clefs. Vous trouverez en bas de l'article des liens vers des documentations complémentaires si vous avez besoin de plus de précisions sur certains points. 🙂️
--------------------------------------------------------------------------------
Pour installer OpenSSH sous Windows, il faut commencer par ouvrir un terminal PowerShell en tant qu'administrateur.
Normalement quand vous avez un terminal administrateur, c'est écrit dessus, mais ça peut également être vérifié à l'aide de la commande à rallonge (merci PowerShell 🙃️) suivante :
(New-Object Security.Principal.WindowsPrincipal([Security.Principal.WindowsIdentity]::GetCurrent())).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
Si vous êtes administrateur, la commande retournera "True", et dans le cas contraire elle retournera "False". En pratique cette vérification est surtout utile si vous développez un script. 🙂️
On peut ensuite vérifier si OpenSSH est déjà installé sur la machine ou pas à l'aide de cette commande :
Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*'
Ce qui vous donnera un résultat similaire à celui-ci :
Name : OpenSSH.Client~~~~0.0.1.0 State : NotPresent Name : OpenSSH.Server~~~~0.0.1.0 State : NotPresent
Ici on peut voir que je n'ai ni le serveur ni le client OpenSSH d'installés ("State: NotPresent"). Si ça avait été le cas, l'état serait "Installed".
Et maintenant, il ne nous reste plus qu'à installer le serveur OpenSSH à l'aide de la commande suivante (oui oui, il faut bien taper 4 tildes dans la commande... 🙃️) :
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
Installation du serveur OpenSSH en cours dans un terminal PowerShell
Vous pouvez également installer le client si vous en avez besoin avec la commande :
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
Maintenant que le service est installé, il ne nous reste plus qu'à le lancer. En effet le serveur OpenSSH ne se lance pas tout seul après l'installation, et il n'est d'ailleurs pas configuré pour se lancer automatiquement au démarrage de la machine non plus.
Pour démarrer le service, entrez la commande suivante dans votre terminal PowerShell administrateur :
Start-Service sshd
Et si vous souhaitez qu'il se lance automatiquement au démarrage, vous pouvez le configurer à l'aide de la commande suivante :
Set-Service -Name sshd -StartupType 'Automatic'
Vous pouvez également faire tout ça de manière graphique via le gestionnaire de service de Windows :
À présent vous pouvez vous connecter à la machine de manière classique :
ssh <USER>@<MACHINE> # Utilisateur local ssh <DOMAIN>\\<USER>@<MACHINE> # Machine faisant parti d'un domaine
Par exemple :
ssh User@192.168.1.42
Si tout s'est bien passé, SSH devrait vous demander de confirmer que vous faites bien confiance à la machine (à la première connexion uniquement), répondez-lui « yes », puis il vous demandera ensuite votre mot de passe (celui de l'utilisateur Windows).
--------------------------------------------------------------------------------
📝️ Note:
--------------------------------------------------------------------------------
NOTE : Le nom d'utilisateur n'est pas sensible à la case sous Windows.
--------------------------------------------------------------------------------
À présent que tout fonctionne, on va voir comment configurer sa clef SSH pour se connecter à la machine sans avoir à taper son mot de passe à chaque fois.
La procédure diffère un peu suivant que l'utilisateur avec lequel vous vous connectez est administrateur de la machine ou non, mais pas de panique, je vais aborder les deux situations ! 😉️
Si vous souhaitez vous connecter avec un utilisateur standard (qui n'est pas administrateur), ouvrez un terminal PowerShell en tant que cet utilisateur.
Il faut ensuite créer le dossier "C:\Users\<USER>\.ssh" s'il n'existe pas déjà. Cela peut être fait à l'aide de la commande suivante :
New-Item -Force -ItemType Directory -Path $env:USERPROFILE\.ssh
Puis on va créer un fichier "authorized_keys" dans ce dossier à l'aide de la commande suivante :
New-Item -ItemType File -Path $env:USERPROFILE\.ssh\authorized_keys
Et enfin on va l'ouvrir avec un éditeur de texte et y coller notre clef SSH publique :
notepad.exe $env:USERPROFILE\.ssh\authorized_keys
Enregistrez le fichier.
À présent vous devriez pouvoir vous connecter à la machine sans avoir à entrer le mot de passe.
Si l'utilisateur avec lequel vous souhaitez vous connecter est administrateur de la machine, la clef publique doit être configurée à un endroit différent, et il faudra également modifier les permissions du fichier pour que tout fonctionne.
Commencez par ouvrir un terminal PowerShell administrateur, puis créez le fichier "<PROGRAMDATA>\ssh\administrators_authorized_keys" à l'aide de la commande suivante :
New-Item -ItemType File -Path $env:ProgramData\ssh\administrators_authorized_keys
Éditez ensuite ce fichier à l'aide de Notepad.exe ou de votre éditeur favoris :
notepad.exe $env:ProgramData\ssh\administrators_authorized_keys
Et ajoutez-y votre clef SSH publique puis enregistrez le fichier.
Il ne reste plus qu'à définir correctement les permissions du fichier... Et c'est là que ça se complique (un peu). En effet, la commande exacte va dépendre de la langue du système.
Si votre système est en anglais, vous pouvez utiliser la commande suivante :
icacls.exe "$env:ProgramData\ssh\administrators_authorized_keys" /inheritance:r /grant "Administrators:F" /grant "SYSTEM:F"
Si comme moi, votre système a été installé en français, la commande devient :
icacls.exe "$env:ProgramData\ssh\administrators_authorized_keys" /inheritance:r /grant "Administrateurs:F" /grant "SYSTEM:F"
Et si votre système est dans une autre langue... Et bah faudra que vous adaptiez vous-même en replaçant le nom du groupe "Administators" par celui correspondant dans votre langue. 😅️
Si tout s'est bien déroulé, la commande devrait vous retourner quelque chose de similaire à ceci :
1 fichiers correctement traités ; échec du traitement de 0 fichiers
Dans le cas contraire, il indiquera que les fichiers n'ont pas pu être traités :
0 fichiers correctement traités ; échec du traitement de 1 fichiers
Vous devriez à présent être en mesure de vous connecter à la machine en utilisant votre clef SSH au lieu d'un mot de passe ! 😁️
Comme je l'ai évoqué en introduction, j'utilise SCP pour copier des fichiers entre ma machine Linux et ma machine Windows. Il n'y a rien de bien particulier à en dire par rapport à une utilisation classique de Linux à Linux ; il faut juste remplacer les backslashes ("\") des chemins Windows par des slashes ("/") pour que ça marche :
scp User@192.168.1.42:C:/Users/User/Desktop/hello.txt ./hello.txt
L'installation d'un serveur SSH sous Windows me facilite grandement la vie et me fait gagner pas mal de temps au quotidien. Cela me permet également de provisionner des machines Windows avec Ansible (je pourrai éventuellement aborder ce sujet dans un autre article si cela vous intéresse).
Pour terminer, je vous mets le lien de la doc officielle de Microsoft qui est assez complète ainsi que celle d'OpenSSH :
Documentation de Microsoft sur l'installation et la configuration d'OpenSSH sous Windows
Documentation officielle d'OpenSSH
En espérant que cet article ait pu vous être utiles, je vous souhaite une bonne journée ! 🙂️
--------------------------------------------------------------------------------
