Passer au contenu principal
Afficher en Markdown

Se connecter avec Remote SSH

Remote SSH connecte Kiro IDE à un ordinateur Linux auquel vous pouvez déjà accéder par SSH. Vos fichiers, vos commandes de terminal et le travail de l'agent Kiro s'exécutent sur cet hôte, tandis que vous utilisez l'éditeur sur votre ordinateur.

Connectez-vous uniquement aux hôtes auxquels vous faites confiance. Vérifiez toute clé d'hôte nouvelle ou modifiée avant de vous connecter. Examinez toute configuration SSH locale pouvant exécuter des commandes sur votre ordinateur.

Prérequis

Votre ordinateur peut exécuter macOS, Windows ou Linux. L'hôte SSH doit disposer des éléments suivants :

  • Linux sur x64 ou ARM64 avec glibc 2.28 ou une version ultérieure
  • Au moins 4 Gio d'espace libre sur le système de fichiers qui contient votre répertoire personnel
  • Un répertoire personnel dans lequel les autres utilisateurs ne peuvent pas écrire
  • /bin/sh
  • stat, which, flock, tar, gzip, sha256sum, diff, find, id, sort et readlink
  • Un accès HTTPS aux points de terminaison de téléchargement, d'authentification et de service de Kiro

Confirmez que votre client SSH habituel peut se connecter avant d'utiliser Kiro.

Se connecter à un hôte

  1. Ouvrez la palette de commandes.
  2. Sélectionnez Kiro: Connect to Host….
  3. Sélectionnez un hôte configuré ou Enter SSH Destination….
  4. Pour enregistrer un hôte, sélectionnez Add New SSH Host…. Saisissez user@host ou une commande SSH complète, puis choisissez le fichier de configuration SSH.
  5. Vérifiez l'empreinte de l'hôte avant d'accepter une clé d'hôte nouvelle ou modifiée.
  6. Terminez l'authentification SSH.
  7. Dans la nouvelle fenêtre Kiro, ouvrez un dossier sur l'hôte.
  8. Approuvez l'espace de travail et connectez-vous à Kiro si vous y êtes invité.

Kiro installe les composants à distance correspondants sur l'hôte. Vous n'avez pas besoin d'y installer Kiro CLI ni Node.js.

Vérifier la connexion

Ouvrez le terminal intégré et exécutez :

bash
hostname pwd

Confirmez que le nom d'hôte et le chemin appartiennent à l'ordinateur distant. Créez et enregistrez un fichier de test, puis demandez à Kiro de le lire. Cela vérifie que l'éditeur, le terminal et l'agent utilisent le même espace de travail distant.

Utiliser SSH et la connexion Kiro en toute sécurité

L'authentification SSH vous donne accès à l'hôte. La connexion Kiro permet à l'agent d'utiliser les services Kiro depuis cet hôte. Il s'agit de connexions distinctes.

Remote SSH prend en charge les clés, les certificats, les agents SSH, les mots de passe et l'authentification interactive au clavier. Saisissez les secrets uniquement dans l'invite qui les demande. Ne collez jamais une clé privée, un mot de passe, un certificat ou un jeton d'accès dans le clavardage ou les fichiers du projet.

Kiro vérifie les clés d'hôte SSH. Arrêtez-vous si une clé d'hôte change de façon inattendue. Confirmez la nouvelle empreinte auprès du propriétaire de l'hôte avant de vous reconnecter.

Utiliser des hôtes relais et des commandes de proxy

Remote SSH prend en charge une chaîne ProxyJump comptant jusqu'à huit sauts. Il prend aussi en charge un ProxyCommand au premier saut.

Remote SSH ne prend pas en charge :

  • Un ProxyCommand après ProxyJump
  • Des chaînes ProxyJump mixtes avec certificats
  • Match exec
  • ProxyUseFdpass

Une configuration SSH locale fiable peut exécuter ProxyCommand sur votre ordinateur. Examinez cette commande avant de vous connecter.

Se déconnecter et revenir

Sélectionnez Kiro: Close Remote Connection pour déconnecter l'éditeur. Rouvrez l'hôte avec Kiro: Connect to Host…, ou choisissez le dossier distant dans File > Open Recent.

Vos fichiers de projet restent sur l'hôte. La fenêtre Kiro distante possède sa propre connexion et son propre historique de clavardage. Elle n'affiche pas les clavardages des fenêtres Kiro locales. Le clavardage distant enregistré et le travail accepté par l'agent peuvent rester disponibles tant que l'hôte et l'agent distant continuent de fonctionner. Un arrêt de l'hôte ou un agent distant non disponible peut interrompre ce travail.

Résoudre les problèmes liés à Remote SSH

  • Si un hôte est absent, sélectionnez Kiro: Add New SSH Host…, puis actualisez la liste.
  • Si l'installation échoue, vérifiez les exigences de l'hôte et l'espace disque libre.
  • Si un proxy bloque l'installation, définissez kiroRemote.httpProxy ou kiroRemote.httpsProxy, puis redémarrez l'environnement distant.
  • Si Kiro signale un paramètre SSH non pris en charge, utilisez une configuration prise en charge pour cet hôte.
  • Si l'inspection TLS réinitialise les services Kiro, suivez les étapes de compatibilité avec l'inspection TLS.

Documentation connexe

Page mise à jour : 20 novembre 2026