SSH dans votre navigateur

Vous pouvez vous connecter à des instances de machine virtuelle (VM) Compute Engine à partir de la console Google Cloud à l'aide de l'outil SSH dans votre navigateur. Le protocole SSH dans le navigateur ne nécessite aucune extension ou logiciel supplémentaire. SSH dans le navigateur est compatible avec les connexions à des VM qui stockent des clés SSH dans les métadonnées, ainsi que les VM qui utilisent OS Login et les VM qui utilisent IAP pour le transfert TCP.

Chaque fois que vous vous connectez à une VM à l'aide de SSH dans le navigateur, Compute Engine crée une paire de clés éphémère et définit un nom d'utilisateur pour votre connexion. Votre nom d'utilisateur et l'emplacement où Compute Engine stocke vos clés SSH varient selon que vous utilisez des clés SSH stockées dans les métadonnées ou sur OS Login. Pour en savoir plus, consultez la section À propos des connexions SSH.

Conditions requises

Pour utiliser la fonctionnalité SSH dans le navigateur, votre environnement doit répondre aux exigences suivantes :

  • La console Google Cloud doit s'exécuter dans un navigateur Web compatible.
  • L'environnement invité doit être installé et en cours d'exécution sur la VM à laquelle vous vous connectez. L'environnement invité est préinstallé sur les VM que vous créez à partir d'images publiques fournies par Google.

  • Votre réseau doit répondre aux exigences suivantes :

    • Les proxys HTTPS et les appareils de sécurité ne doivent pas déchiffrer et rechiffrer le trafic à l'aide de leur propre certificat TLS, par exemple pour effectuer une inspection TLS.
    • Le réseau doit autoriser le trafic en provenance et à destination des noms d'hôte se terminant par google.com, gstatic.com ou googleapis.com.
    • Le réseau doit autoriser l'envoi de paquets aux adresses IP pour les domaines par défaut.
    • Pour se connecter aux VM via leur adresse IP externe, le cloud privé virtuel (VPC) doit autoriser le trafic entrant TCP pour la plage d'adresses IP 0.0.0.0/0.
    • Pour se connecter aux VM via leur adresse IP interne, le VPC doit utiliser IAP.

Utiliser SSH dans votre navigateur

Se connecter à des VM

Pour savoir comment utiliser SSH dans votre navigateur pour vous connecter à une VM, consultez la page Se connecter à des VM Linux.

Pour apprendre à utiliser SSH dans votre navigateur pour vous connecter à un Cloud TPU, consultez la page Se connecter à une VM Cloud TPU.

Se connecter à des VM sans adresse IP publique

Pour vous connecter à des VM ne disposant que d'adresses IP internes, suivez la procédure Choisir une option de connexion pour les VM internes uniquement.

Se connecter à des VM avec des clés SSH importées par l'utilisateur

SSH dans votre navigateur est compatible avec les connexions avec des clés SSH importées par l'utilisateur pour les VM qui utilisent OS Login.

Pour vous connecter à une VM avec une clé SSH importée par l'utilisateur, procédez comme suit :

  1. Dans Google Cloud Console, accédez à la page Instances de VM.

    Accéder à la page "Instances de VM"

  2. Dans la liste des VM, cliquez sur la liste déroulante en regard du bouton SSH de la VM à laquelle vous souhaitez vous connecter.

  3. Cliquez sur Ouvrir dans une fenêtre de navigateur à l'aide de la clé SSH privée fournie

    La fenêtre "SSH dans le navigateur" s'affiche.

  4. Cliquez sur Se connecter avec un fichier de clé SSH et choisissez le fichier de clé privée associé à la clé publique dans votre profil OS Login.

Se déconnecter des VM

Pour vous déconnecter d'une VM et terminer une session SSH dans le navigateur, exécutez la commande exit.

Faire défiler le terminal

Vous pouvez faire défiler le terminal en utilisant la molette de la souris ou le pavé tactile. Vous pouvez également utiliser les raccourcis clavier du système d'exploitation de votre poste de travail.

Windows et Linux

Pour faire défiler la page vers le haut, utilisez Ctrl+Shift+PageUp. Pour faire défiler la page vers le bas, utilisez Ctrl+Shift+PageDn.

macOS

Pour faire défiler la page vers le haut, utilisez Fn+Shift+Up. Pour faire défiler la page vers le bas, utilisez Fn+Shift+Down.

ChromeOS

Pour faire défiler la page vers le haut, utilisez Alt+Shift+Up. Pour faire défiler la page vers le bas, utilisez Alt+Shift+Down.

Copier et coller du texte

L'option de copie par défaut pour SSH dans le navigateur est Copier lors de la sélection. Tout texte que vous mettez en surbrillance dans SSH dans le navigateur est copié. Vous pouvez également copier et coller le texte à l'aide des raccourcis clavier correspondant au système d'exploitation de votre poste de travail.

Windows et Linux

Pour copier du texte, utilisez Ctrl+C. Pour coller du texte, utilisez Ctrl+V.

macOS

Pour copier du texte, utilisez Cmd+C. Pour coller du texte, utilisez Cmd+V.

ChromeOS

Il n'existe pas de raccourci clavier pour copier des fichiers. Pour coller du texte, utilisez Ctrl+Shift+V.

Si vous rencontrez des problèmes pour effectuer des copier-coller de blocs de texte volumineux, utilisez plutôt le transfert de fichiers.

Transférer des fichiers

Pour savoir comment transférer des fichiers vers et depuis des VM à l'aide de SSH dans la navigateur, consultez la page Transférer des fichiers à l'aide de SSH dans le navigateur.

Problèmes connus

  • Lenteur du transfert de clé SSH. Les temps de transfert de clé SSH dans le navigateur sont compris entre 2 et 25 secondes.
  • Interruptions intermittentes. À ce jour, nous n'offrons pas de contrat de niveau de service spécifique aux durées de vie des connexions. Si vous souhaitez que la fenêtre du terminal reste ouverte pendant une période prolongée, utilisez des multiplexeurs de terminaux comme tmux ou screen.
  • Les raccourcis clavier ferment la fenêtre. Les raccourcis clavier suivants ferment la fenêtre SSH dans le navigateur :
    • Sur les postes de travail Windows et Linux : Ctrl+W
    • Sur les postes de travail macOS : Cmd+W
    • Sur les postes de travail ChromeOS : Ctrl+Shift+W
  • Le transfert de fichiers volumineux peut être lent. Si vous rencontrez des temps de transfert de fichiers lents, utilisez la commande gcloud compute scp au lieu de SSH dans votre navigateur.

Résoudre les problèmes

Pour connaître les méthodes et outils permettant de diagnostiquer et de résoudre les échecs de connexion SSH, consultez la page Résoudre les problèmes liés à SSH.