Zum Hauptinhalt springen

Unix Check Port

Aktuelle Konfiguration des Tasks „Unix Check Port“ im Workflow Designer
  • Aufgabentyp: ssh_checkport

Beschreibung​

Die Aufgabe Unix Check Port ermöglicht die Überprüfung, ob ein bestimmter Port auf einem Zielhost geöffnet ist, indem die Überprüfung vom lokalen Gerät (Standardmodus) oder von einem entfernten Server über SSH durchgeführt wird.

Im Gegensatz zur Aufgabe Unix Check Connection, die die Erreichbarkeit des Hosts überprüft, prüft diese Aufgabe, ob ein bestimmter Port auf dem Zielsystem geöffnet und erreichbar ist.

Konfiguration​

Die Konfiguration ist sehr ähnlich zu der der Aufgabe „Unix Check Connection“, jedoch mit der zusätzlichen Angabe des zu prüfenden Ports. Die Konfigurationsfelder der Aufgabe können manuell oder über Workflow-Parameter und -Variablen. ausgefüllt werden.

Verbindung zum Server​

  • Verbindungsmodus: Definiert die Quelle der für die Verbindung verwendeten Anmeldeinformationen. Es können drei Betriebsmodi gewählt werden:
  • Standard: Die Überprüfung wird vom lokalen Gerät durchgeführt.
  • Manuell: Ermöglicht die manuelle Eingabe der Verbindungsparameter.
  • Umgebung: Verwendet eine vordefinierte Verbindungsumgebung. In diesem Modus wird ein Menü angezeigt, das die verfügbaren Verbindungen basierend auf der dem Workflow zugeordneten Rolle auflistet.
  • IP-Adresse: IP-Adresse des entfernten Servers.
  • Hostname: Hostname des entfernten Servers.
  • Benutzer: Benutzername, der zur Herstellung der SSH-Verbindung verwendet wird.
  • Passwort: Passwort, das mit dem Verbindungskonto verknüpft ist.
  • Port: Port, der für die SSH-Verbindung verwendet wird (Standardwert ist 22).

Befehl als anderer Benutzer ausführen​

Durch Aktivieren dieser Checkbox kann die Suche mit einem Benutzer durchgeführt werden, der von dem für die SSH-Verbindung verwendeten Benutzer abweicht.

  • Benutzer: Name des Benutzers, unter dem der Befehl ausgeführt wird.
  • Passwort: Passwort des Benutzers, der für die Ausführung des Befehls verwendet wird.

Prüfparameter (Zielhost)​

  • Host: Die IP-Adresse oder der Hostname des Zielgeräts, für das der Port überprüft werden soll.
  • Port: Die Portnummer, die auf dem Zielhost überprüft werden soll.

Ausgabe-Parameter​

Nach Abschluss der Ausführung stehen die folgenden Ausgabe-Parameter zur Verfügung, die als Eingabe in nachfolgende Aufgaben des Workflows verwendet werden können.

  • result: Enthält eine Textnachricht, die das Ergebnis der Operation oder eine Fehlermeldung beschreibt (z. B. “Missing server address”).
  • resultJson: Stellt das Ergebnis der Aufgaben-Ausführung im JSON-Format dar und enthält allgemeine Informationen, Konfigurationen und Details zur Ausführung.
  • exitStatus: Gibt den Exit-Code des ausgeführten Netzwerkbefehls zurück (wahrscheinlich netcat, telnet oder ähnlich). Ein Wert von 0 gibt an, dass der Port geöffnet ist und die Verbindung erfolgreich hergestellt wurde.

Beispiel-Parameter resultJson​

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Anmerkung​

Die Aufgabe stellt eine SSH-Verbindung mit dem entfernten Server her und überprüft, ob der auf dem Zielhost angegebene Port geöffnet ist. Ist die Option „Befehl als anderer Benutzer ausführen“ aktiviert, wird die Überprüfung mit einem Benutzer durchgeführt, der von dem Haupt-SSH-Verbindungsbenutzer abweicht.