Cette semaine, commencez par tester la connexion SSH ordinaire dans le terminal Windows avec le même compte, la même adresse et le même port que dans VS Code. Si ce test réussit, arrêtez de modifier le mot de passe du Mac : vérifiez plutôt la clé utilisée, le journal de Remote - SSH ou l’installation de VS Code Server. Remote - SSH ne conserve pas le mot de passe ; une nouvelle demande peut donc être normale.

Cet article s’adresse aux étudiants qui n’ont qu’un ordinateur Windows et doivent utiliser VS Code sur un Mac distant pour un cours de Python, de développement web ou d’iOS. Il convient aussi aux débutants dont le terminal se connecte, mais dont VS Code redemande un mot de passe ou une phrase secrète. Enfin, il aide ceux qui ont déjà réussi une connexion, puis restent bloqués sur « installation du serveur ».

01

Lire le symptôme avant de changer la configuration

Le même écran de mot de passe peut correspondre à trois situations différentes. La première est une nouvelle authentification normale. La deuxième indique que la clé privée n’est pas utilisée ou que sa phrase secrète est demandée. La troisième survient après une authentification réussie, lorsque VS Code tente encore de transférer ou de démarrer son composant serveur.

Une authentification désigne simplement le contrôle d’accès : le Mac vérifie que le compte présenté a le droit d’entrer. Nous pouvons la comparer au contrôle à l’entrée d’une salle de cours. Le mot de passe est la réponse donnée au surveillant, tandis que la clé SSH est un couple de pièces qui prouve l’identité sans envoyer le même secret à chaque connexion.

Observation Ce que cela signifie probablement Action prioritaire
Le terminal demande le mot de passe puis ouvre une invite sur le Mac Le compte, l’adresse et le port sont probablement corrects Reproduire les mêmes paramètres dans VS Code
VS Code demande une phrase secrète après le choix d’une clé La clé privée est utilisée, mais elle est protégée par un secret local Vérifier la clé et ssh-agent, sans partager la phrase secrète
La connexion est acceptée puis l’installation recommence Le problème se situe après l’authentification Lire le journal Remote - SSH et examiner le transfert
Le terminal expire ou refuse la connexion Adresse, port, réseau ou service SSH à contrôler Corriger la connexion de base avant VS Code
Une alerte signale une empreinte d’hôte différente L’identité présentée par le serveur a changé Vérifier avec le fournisseur avant toute suppression

Le service « Connexion à distance » de macOS peut fournir un accès SSH à un ordinateur autorisé. La procédure officielle décrit l’activation de cet accès dans les réglages de partage du Mac ; elle ne transforme toutefois pas une mauvaise adresse, un mauvais port ou un compte inexistant en connexion valide. Consultez les indications officielles sur la connexion à distance d’un Mac avant de demander une modification au propriétaire de la machine.

Attention. Ne désactivez pas la vérification de l’empreinte de l’hôte pour faire disparaître une alerte. Cette empreinte joue le rôle du badge présenté par la salle : si elle change, il faut demander une explication au fournisseur du Mac distant.

02

Première étape : valider SSH hors de VS Code

Ouvrez PowerShell ou le terminal configuré sur Windows. Reprenez exactement les valeurs fournies pour le Mac distant. La forme générale est la suivante :

ssh utilisateur@adresse-du-mac -p port

Remplacez chaque élément par la valeur réelle de votre environnement. N’inventez pas un utilisateur à partir de votre adresse électronique et ne supposez pas que le port est celui utilisé par une autre machine.

Le résultat attendu est une demande d’authentification suivie d’une invite de commande sur le Mac. Si vous voyez une invite distante, exécutez une commande sans risque, comme l’affichage du répertoire courant, puis quittez la session :

pwd
exit

Le but n’est pas encore de lancer le projet. Nous voulons seulement savoir si le chemin réseau et l’identité de base fonctionnent. La documentation officielle de Remote - SSH pour VS Code confirme que l’extension se connecte à un hôte distant compatible SSH ; le test en terminal isole donc la couche SSH avant d’ajouter le comportement de l’éditeur.

Résultat du test dans le terminal Diagnostic de travail Ne pas faire
Invite distante obtenue Passer à la configuration de VS Code Modifier le compte distant sans raison
« Permission denied » Identité, mot de passe ou clé à examiner Désactiver les contrôles d’accès
Délai d’attente Adresse, port, réseau ou service non joignable Publier un port supplémentaire soi-même
Empreinte d’hôte modifiée Vérification auprès du fournisseur nécessaire Effacer l’alerte à l’aveugle
Connexion correcte, puis fermeture immédiate Shell ou politique de session à examiner Conclure trop vite à une erreur de mot de passe

Si le terminal échoue, VS Code n’est pas encore le bon endroit pour chercher. Contrôlez d’abord les trois éléments fournis par l’environnement : nom du compte, adresse du Mac et port. Si l’accès à distance n’est pas activé ou si un réseau scolaire bloque la connexion, seul le responsable de l’environnement peut corriger le service.

03

Terminal connecté, VS Code bloqué : comparer les deux chemins

Lorsque le terminal ouvre bien une session mais que VS Code redemande un secret, nous devons vérifier ce que demande réellement la fenêtre. Il peut s’agir du mot de passe du compte distant, de la phrase secrète de la clé privée, d’une validation supplémentaire ou d’une nouvelle session créée après un échec de transfert.

Dans VS Code, ouvrez la sortie dédiée à Remote - SSH depuis le panneau de sortie, puis sélectionnez le canal correspondant à l’extension. Recherchez dans l’ordre :

  • l’hôte choisi ;
  • le compte et le port employés ;
  • la méthode d’authentification ;
  • la réussite ou l’échec de l’ouverture SSH ;
  • le moment où le serveur distant est téléchargé, transféré ou lancé.

Les noms exacts des commandes et des réglages peuvent évoluer avec les versions. La documentation officielle de dépannage Remote - SSH reste la référence pour les journaux et les étapes de diagnostic. Nous ne devons pas traiter chaque nouvelle demande comme une preuve que le compte est faux.

Remote - SSH appelle le client SSH local et ne conserve pas le mot de passe ni les autres jetons d’authentification. Cette limite explique qu’une reconnexion puisse provoquer une nouvelle demande, surtout après la fermeture de VS Code, un changement de session Windows ou l’ouverture d’un second projet. Cela ne signifie pas que le mot de passe est rejeté.

La bonne action dépend donc du point d’arrêt :

  • Avant l’ouverture de la session distante : reprendre l’utilisateur, l’adresse, le port et la clé.
  • Après l’ouverture de la session : lire les lignes concernant le serveur distant.
  • Après le démarrage du serveur : vérifier l’extension, le dossier de projet et les droits sur ce dossier.

À ce stade, si le terminal et VS Code parviennent tous deux à ouvrir le Mac, cessez de réinitialiser le compte distant. Une succession de changements de mot de passe peut créer un nouveau problème sans résoudre celui du transfert.

04

Clé SSH : vérifier la chaîne complète sous Windows

Une clé SSH comporte une partie privée et une partie publique. La partie privée reste sur l’ordinateur Windows ; la partie publique est autorisée sur le Mac distant. Dans notre comparaison, la clé privée est la clé de la salle, la clé publique est l’exemplaire enregistré à l’accueil, et ssh-agent est le casier local qui peut présenter la clé sans la rechercher à chaque fois.

Nous suivons cet ordre, sans sauter directement à une réinstallation :

  • Vérifiez que le fichier privé existe réellement sur l’ordinateur Windows.
  • Vérifiez que la configuration SSH pointe vers ce fichier avec IdentityFile.
  • Vérifiez que l’agent SSH est disponible et que la clé y est chargée.
  • Vérifiez que la partie publique correspondante est bien autorisée sur le compte distant.
  • Refaites le test dans PowerShell avec le même alias que celui choisi par VS Code.

Un exemple de bloc de configuration peut ressembler à ceci :

Host mac-cours
    HostName adresse-du-mac
    User utilisateur
    Port port
    IdentityFile C:\Users\Etudiant\.ssh\id_ed25519

Le chemin n’est qu’un exemple : utilisez le fichier réellement créé sur votre ordinateur. Dans VS Code, choisissez ensuite l’hôte mac-cours plutôt que de recréer manuellement une autre combinaison de paramètres. Une différence minime entre deux configurations peut donner l’impression que la clé « ne marche pas », alors que le terminal et l’éditeur ne ciblent pas le même compte.

Pour contrôler l’agent dans PowerShell, utilisez les commandes documentées par la gestion des clés OpenSSH sous Windows. L’objectif est de confirmer la présence de la clé, pas de copier sa partie privée dans un dossier de cours.

Rappel de sécurité. Une clé privée équivaut à un justificatif d’accès. Ne l’envoyez jamais dans un dépôt de code, une conversation, une capture d’écran ou un dossier partagé avec la classe. Si l’ordinateur appartient à une école, ne contournez pas sa gestion des logiciels pour lancer un agent non autorisé ; demandez la procédure à l’administrateur.

Sur une machine scolaire, ssh-agent peut être bloqué par les règles de session. Dans ce cas, une connexion par mot de passe peut rester le choix le plus réaliste pour la durée du cours, à condition que le compte et le fournisseur l’autorisent. Une clé n’est pas une obligation universelle ; elle devient surtout intéressante lorsque les reconnexions sont fréquentes et que l’environnement autorise son usage.

05

Installation répétée de VS Code Server : changer de diagnostic

Un message indiquant que VS Code installe ou démarre son serveur distant ne prouve pas que le mot de passe est faux. L’authentification peut déjà être terminée. Le blocage peut ensuite concerner le téléchargement du composant, son transfert depuis Windows, sa décompression, son lancement ou l’accès au répertoire distant.

Dans le journal, notez l’étape précise qui se répète. Cherchez notamment :

  • une authentification refusée avant toute installation ;
  • un téléchargement qui n’aboutit pas ;
  • un transfert interrompu ;
  • un répertoire distant inaccessible ;
  • un serveur lancé puis immédiatement arrêté.

La documentation officielle de Remote Development avec SSH explique que le composant serveur est géré par VS Code sur l’hôte distant. Nous déconseillons donc de récupérer un programme trouvé sur un forum ou un script dont l’origine est inconnue. Le fait qu’un tutoriel promette de « réparer » l’installation ne garantit ni sa compatibilité ni sa sécurité.

Dans ce scénario, essayez une seule reconnexion après avoir relevé le journal. Si l’authentification est explicitement réussie, poursuivez l’analyse du réseau de téléchargement et du transfert. Si l’authentification échoue avant l’installation, revenez à la clé, au compte et au port. Cette séparation évite de modifier les clés alors que le véritable problème se trouve dans la connectivité sortante du Mac.

Les extensions qui ne se chargent pas, la fermeture de la connexion au milieu de l’ouverture d’un dossier et la simple demande répétée de mot de passe sont trois symptômes différents. Ils peuvent apparaître dans la même session, mais ils ne doivent pas recevoir automatiquement le même correctif.

06

FAQ pour les étudiants qui débutent

Pourquoi Remote - SSH redemande-t-il le mot de passe ?

Le mot de passe n’est pas conservé par Remote - SSH. Une nouvelle session peut donc demander de nouveau le secret, même si la précédente était correcte. Commencez par confirmer que le terminal ouvre bien le même hôte. Si oui, lisez le journal pour savoir si la demande concerne le compte, la phrase secrète de la clé ou une étape qui suit déjà l’authentification.

Comment faire utiliser une clé déjà configurée sous Windows 11 ?

Vérifiez le fichier privé local, la ligne IdentityFile, l’agent SSH et la clé publique autorisée sur le Mac. Testez l’alias dans PowerShell avant de le sélectionner dans VS Code. Si le terminal fonctionne avec une clé mais que VS Code en utilise une autre, corrigez la configuration commune plutôt que de générer plusieurs nouvelles clés.

Que faire quand SSH fonctionne mais que VS Code ne se connecte pas au Mac ?

Comparez l’utilisateur, l’adresse et le port, puis ouvrez la sortie Remote - SSH. Le point de divergence indique la suite : authentification, transfert ou serveur. Un terminal connecté ne garantit pas que le serveur de VS Code puisse être installé, mais il élimine déjà une partie importante du diagnostic réseau et des identifiants.

L’installation du serveur qui recommence signifie-t-elle que le mot de passe est faux ?

Non. Si le journal indique que la session SSH est authentifiée, examinez le téléchargement, le transfert et le démarrage du serveur. Vérifiez aussi le dossier distant et la connectivité nécessaire. Ne supprimez pas des fichiers au hasard et ne téléchargez pas un installateur non vérifié pour remplacer le composant géré par VS Code.

07

Valider la réparation avant de reprendre le devoir

Une connexion qui affiche le dossier distant n’est pas encore une validation complète. Nous recommandons cette séquence, dans l’ordre :

  • [ ] Fermer complètement VS Code.
  • [ ] Le rouvrir sans modifier le compte distant.
  • [ ] Sélectionner le même hôte Remote - SSH.
  • [ ] Observer si la demande concerne le mot de passe ou la phrase secrète de clé.
  • [ ] Ouvrir le dossier de travail sur le Mac.
  • [ ] Ouvrir un terminal intégré distant.
  • [ ] Exécuter une commande simple comme pwd.
  • [ ] Créer un petit fichier de test dans le dossier du projet.
  • [ ] Enregistrer le fichier, le fermer, puis le rouvrir.
  • [ ] Relancer le programme ou le serveur local prévu par le cours.
  • [ ] Fermer et rouvrir la session une dernière fois.

Le test est réussi si le bon dossier s’ouvre, si le terminal intégré indique bien l’environnement distant et si le fichier reste présent après reconnexion. Si le fichier disparaît ou si le projet s’ouvre dans un autre répertoire, le problème concerne probablement le chemin de travail ou les droits, pas la mémorisation du mot de passe.

À la fin, choisissez une seule des trois voies suivantes :

  • Continuer avec le mot de passe si l’agent SSH est interdit ou indisponible sur l’ordinateur scolaire.
  • Utiliser une clé autorisée si l’environnement permet ssh-agent et si la clé publique a été installée par le responsable.
  • Demander une intervention si le Mac n’offre pas de compte indépendant, de connexion SSH stable ou de dossier de projet contrôlable.

Pour un usage de cours, ces trois éléments comptent davantage qu’une configuration compliquée. Nous vous conseillons de noter le mode d’accès autorisé, le dossier de sauvegarde et la personne à contacter avant la prochaine séance. Si la machine actuelle ne fournit pas de compte indépendant ou de connexion SSH stable, consultez la présentation d’un Mac distant pour les travaux de programmation afin de comparer l’environnement disponible, sans confondre cette solution avec une réparation du compte actuel.

Si l’accès doit rester disponible pendant une courte période, un Mac distant loué peut éviter l’achat d’une machine et fournir un environnement macOS séparé. En revanche, une solution distante dépend toujours de la qualité du réseau, de la latence d’affichage et des autorisations du compte. Une machine Windows avec une installation locale reste préférable lorsque le cours n’utilise aucun outil macOS exclusif. Pour comparer une autre disponibilité régionale, vous pouvez aussi consulter les options de Mac distant proposées par MESHLAUNCH.

Le choix est donc simple : ne changez pas de solution tant que le terminal, l’identité SSH et le journal VS Code n’ont pas été distingués. Si l’hôte actuel oblige à partager un compte, ne permet pas une clé contrôlée ou boucle systématiquement pendant l’installation du serveur, une location MESHLAUNCH peut constituer un environnement d’apprentissage plus propre pour un besoin temporaire. Ce n’est pas un remplacement universel d’un Mac local, mais c’est une option à examiner lorsque l’objectif est de suivre un cours, tester un projet ou travailler sur un environnement macOS sans acheter immédiatement la machine.