Secure Shell-Connector-Methoden (SSH).

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Die SSH-Connector-Methoden (Secure Shell) stellen eine SSH-Verbindung her, führen Befehle über die hergestellte Verbindung aus und trennen die Sitzung.

    Verbinden

    Stellt eine SSH-Verbindung her. Geben Sie die Informationen an, die zum Herstellen einer Verbindung mit einem Remotecomputer erforderlich sind.

    Wählen Sie das Einstellungssymbol ( Einstellungssymbol), um den Authentifizierungstyp auszuwählen.

    Unterstützte Authentifizierungstypen sind Passwort, Tastatur-Interaktion und KeyFileAuthentication.Das Fenster zur Konfiguration des Authentifizierungstyps, in dem Passwort, Tastatur-Interaktion und KeyFileAuthentication als Authentifizierungstypen angezeigt werden.

    Der Standardauthentifizierungstyp ist „Passwort“.

    Tabelle : 1. Verbindungsmethodenparameter
    Parameter Beschreibung Datenporttyp Datentyp
    HostName Hostname des Remote-Servers oder IP-Adresse. Dateneingang Zeichenfolge
    Anwendername Anwendername des SSH-Accounts. Dateneingang Zeichenfolge
    Passwort

    Sichere Zeichenfolgendarstellung des Passworts. Passwort des SSH-Accounts.

    Sie können die SecureStringEncode-Komponente verwenden, um das sichere Zeichenfolgenpasswort zu verschlüsseln, wie im folgenden Beispiel erwähnt. Weitere Informationen finden Sie unter Verwenden Sie die SecureStringEncode-Komponente.
    Abbildung : 1. Verbindungsmethode mit Passwortparametern
    Die SecureStringEncode-Komponente ist mit der Connect-Methode verbunden, um das codierte Passwort zu übergeben.

    Nachdem Sie diese Aufgabe ausgeführt haben, können Sie eine Verbindung zum Remote-Server herstellen.

    Dateneingang SecureString
    Port Optional. Die Portnummer für die SSH-Verbindung. Der Standardwert ist 22. Dateneingang Ganzzahl
    CreateShell Optional. Bei „Wahr“ wird bei erfolgreicher Verbindung ein Shell-Stream erstellt. Jeder Befehl, der über diese Verbindung ausgeführt wird, verwendet die Shell.

    Bei „falsch“ gilt, dass jeder Befehl, der über diese Verbindung ausgeführt wird, die Shell nicht unterstützt.

    Der Standardwert ist „Wahr“.

    Dateneingang Boolean
    KeyboardInteractiveAuth Passwort als Abfrage.

    Bei „Wahr“ fordert der Server den Client zur Eingabe eines Passworts auf, um die Identität des Benutzers zu überprüfen. Der im Passwortparameter angegebene Wert wird als Antwort vom Client freigegeben.

    Dieser Parameter wird nur angezeigt, wenn „KeyboardInteractive“ als Authentifizierungstyp ausgewählt ist.

    Dateneingang Boolean
    KeyFilePfad Pfad des privaten Schlüssels.

    Dieser Parameter wird nur angezeigt, wenn KeyFileAuthentication als Authentifizierungstyp ausgewählt wird.

    Dateneingang Zeichenfolge
    Passphrase Optional. Wenn der private Schlüssel mit Passphrase verschlüsselt wird, wird derselbe Wert innerhalb des Passphrase-Parameters angegeben, um den privaten Schlüssel zu verwenden.

    Dieser Parameter wird nur angezeigt, wenn KeyFileAuthentication als Authentifizierungstyp ausgewählt wird.

    Dateneingang Zeichenfolge

    RunCommand

    Führen Sie nach dem Herstellen einer SSH-Verbindung mithilfe der RunCommand-Methode Befehle über die hergestellte Verbindung aus.

    Tabelle : 2. Parameter der RunCommand-Methode
    Parameter Beschreibung Datenporttyp Datentyp
    Befehl Befehle, die auf dem Remote-SSH-Server ausgeführt werden müssen, z. B. Nachrichten oder Skripts, können gültige Shell-Befehle oder ausführbare Befehle sein, die der Remote-Server verstehen kann.

    Beispiel: „echo hello“.

    Abbildung : 2. RunCommand-Methode: Befehlsparameter
    Befehl als „Echo Hello“ in der RunCommand-Methode des Befehlsparameters eingegeben
    Dateneingang Zeichenfolge
    Zeitüberschreitung Optional. Der Parameter, der die maximale Zeit (in Sekunden) angibt, die auf die Ausgabe des Befehls vom SSH-Server gewartet wird, wenn eine interaktive Shell verwendet wird.

    Der Standardwert ist 30.

    Dateneingang Ganzzahl
    Zurück Das Ergebnis des ausgeführten Befehls.

    Beispiel: Nach dem Ausführen der Automatisierung wird im Parameter „Datenvorschau der Rückgabe“ „Halle“ angezeigt.

    Abbildung : 3. Rückgabeparameter der RunCommand-Methode
    Datenvorschauen als „Halloween“, nachdem der Befehl ausgeführt wurde
    Daten aus Zeichenfolge

    Trennen

    Trennen Sie nach dem Ausführen von Befehlen die hergestellte Verbindung mit der Methode Trennen.

    Das folgende Beispiel zeigt die gesamte Automatisierung nach dem Hinzufügen der Methode Disconnect.

    Abbildung : 4. Trennmethode
    Beispiel für den Automatisierungs-Workflow des SSH-Connectors.