Méthodes du connecteur Secure Shell (SSH)

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture
  • Les méthodes de connecteur Secure Shell (SSH) établissent une connexion SSH, exécutent des commandes sur la connexion établie et déconnectent la session.

    Connect

    Établit une connexion SSH. Fournissez les informations nécessaires pour vous connecter à un ordinateur distant.

    Sélectionnez l’icône Paramètres (icône Paramètres) pour choisir le type d’authentification.

    Les types d’authentification pris en charge sont Password, KeyboardInteractive et KeyFileAuthentication.Fenêtre de configuration du type d’authentification affichant Password, KeyboardInteractive et KeyFileAuthentication comme types d’authentification.

    Le mot de passe est le type d’authentification par défaut.

    Tableau 1. Paramètres de la méthode de connexion
    Paramètre Description Type de port de données Type de données
    Nom d'hôte Nom d’hôte du serveur distant ou adresse IP. Données dans Chaîne
    Nom d'utilisateur Nom d’utilisateur du compte SSH. Données dans Chaîne
    Mot de passe

    Représentation de chaîne sécurisée du mot de passe. Mot de passe du compte SSH.

    Vous pouvez utiliser le composant SecureStringEncode pour coder le mot de passe de la chaîne sécurisée comme indiqué dans l’exemple suivant. Pour plus d'informations, consultez Utiliser le composant SecureStringEncode.
    Figure 1. Méthode de connexion avec le paramètre Mot de passe
    Le composant SecureStringEncode est connecté à la méthode Connect pour transmettre le mot de passe codé.

    Une fois que vous avez effectué cette tâche, vous pouvez vous connecter au serveur distant.

    Données dans Chaîne sécurisée
    Port Facultatif. Numéro de port de la connexion SSH. La valeur par défaut est 22. Données dans Entier
    Créer un shell Facultatif. Si vrai, un flux shell est créé en cas de connexion réussie. Toute commande exécutée sur cette connexion utilise le shell.

    Si la valeur est Faux, toute commande exécutée sur cette connexion n’est pas le shell.

    La valeur par défaut est Vrai.

    Données dans Booléen
    KeyboardInteractiveAuth Le mot de passe comme défi.

    Si la valeur est Vrai, le serveur demande au client de saisir le mot de passe pour vérifier l’identité de l’utilisateur. La valeur fournie dans le paramètre Mot de passe est partagée en tant que réponse du client.

    Ce paramètre s’affiche uniquement lorsque KeyboardInteractive est sélectionné à partir du type d’authentification.

    Données dans Booléen
    Chemin d’accès du fichier clé Chemin d’accès de la clé privée.

    Ce paramètre apparaît uniquement lorsque KeyFileAuthentication est sélectionné à partir du type d’authentification.

    Données dans Chaîne
    Phrase de sécurité Facultatif. Si la clé privée est chiffrée à l’aide d’une phrase de sécurité, la même valeur est fournie dans le paramètre de phrase de sécurité pour utiliser la clé privée.

    Ce paramètre apparaît uniquement lorsque KeyFileAuthentication est sélectionné à partir du type d’authentification.

    Données dans Chaîne

    Commande d’exécution

    Après avoir établi une connexion SSH, exécutez les commandes sur la connexion établie à l’aide de la méthode RunCommand.

    Tableau 2. Paramètres de la méthode RunCommand
    Paramètre Description Type de port de données Type de données
    Commande Les commandes qui doivent être exécutées sur le serveur SSH distant, telles que des messages ou des scripts, peuvent être des commandes shell valides ou des commandes exécutables que le serveur distant peut comprendre.

    Par exemple, echo hello.

    Figure 2. Méthode RunCommand : paramètre de commande
    Commande saisie comme « echo hello » dans le paramètre de commande Méthode RunCommand
    Données dans Chaîne
    Délai Facultatif. Paramètre qui spécifie le temps maximal (en secondes) d’attente de la sortie de la commande du serveur SSH lors de l’utilisation d’un shell interactif.

    La valeur par défaut est 30.

    Données dans Entier
    Retour Résultat de la commande exécutée.

    Par exemple, après l’exécution de l’automatisation, dans le paramètre Aperçu des données de Retour, « bonjour » s’affiche.

    Figure 3. Paramètre de retour de la méthode RunCommand
    Prévisualiser les données sous forme de bonjour, une fois la commande exécutée
    Sortie de données Chaîne

    Déconnecter

    Après avoir exécuté les commandes, déconnectez la connexion établie à l’aide de la méthode Déconnexion.

    L’exemple suivant montre l’ensemble de l’automatisation après l’ajout de la méthode Déconnecter.

    Figure 4. Méthode de déconnexion
    Exemple de workflow d’automatisation du connecteur SSH.