Aller au contenu principal

Vérification du Port Unix

Configuration actuelle de la tâche Unix Check Port dans le Workflow Designer
  • Type de tâche : ssh_checkport

Description​

La tâche Unix Check Port permet de vérifier si un port spécifique est ouvert sur un hôte cible, en exécutant le contrôle depuis la machine locale (mode Par défaut) ou depuis un serveur distant via SSH.

Contrairement à la tâche Unix Check Connection, qui vérifie la faisabilité de l'hôte, cette tâche vérifie si un port spécifique est ouvert et accessible sur le système cible.

Configuration​

La configuration est similaire à celle de la tâche "Unix Check Connection", mais avec l'ajout du port à vérifier. Les champs de configuration de la tâche peuvent être définis manuellement ou via paramètres et variables du flux de travail.

Connexion au Serveur​

  • Mode de connexion : Définit la source des identifiants utilisés pour la connexion. Il peut prendre trois modes d'opération :
  • Par défaut : le contrôle est exécuté depuis la machine locale.
  • Manuel : Permet d'entrer manuellement les paramètres de connexion.
  • Environnement : Utilise un environnement de connexion préconfiguré. Dans ce mode, un menu est affiché listant les connexions disponibles en fonction du rôle associé au Workflow.
  • Adresse IP : Adresse IP du serveur distant.
  • Nom d'hôte : Nom d'hôte du serveur distant.
  • Utilisateur : Nom d'utilisateur utilisé pour établir la connexion SSH.
  • Mot de passe : Mot de passe associé à l'utilisateur de connexion.
  • Port : Port utilisé pour la connexion SSH (la valeur par défaut est 22).

Exécuter la commande en tant qu'autre utilisateur​

En activant cette case à cocher, il est possible d'exécuter la recherche avec un utilisateur différent de celui utilisé pour la connexion SSH.

  • Utilisateur : Nom de l'utilisateur avec lequel la commande sera exécutée.
  • Mot de passe : Mot de passe de l'utilisateur utilisé pour l'exécution de la commande.

Paramètres de Contrôle (Hôte de Destination)​

  • Hôte : L'adresse IP ou le nom d'hôte de la machine de destination sur laquelle le port doit être vérifié.
  • Port : Le numéro de port que vous souhaitez vérifier sur l'hôte de destination.

Paramètres de Sortie​

À la complétion de l'exécution, la tâche rend disponibles les Paramètres de Sortie suivants, utilisables comme entrées dans les tâches suivantes du Workflow.

  • result : Contient un message textuel décrivant le résultat de l'opération ou un message d'erreur (par exemple, “Missing server address”).
  • resultJson : Représente le résultat de l'exécution de la tâche au format JSON, incluant des informations générales, les configurations et les détails sur l'exécution.
  • exitStatus : Renvoie le code de sortie de la commande réseau exécutée (probablement netcat, telnet ou similaire). Une valeur de 0 indique que le port est ouvert et la connexion a été établie avec succès.

Exemple de paramètre resultJson​

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

Notes​

La tâche établit une connexion SSH avec le serveur distant et vérifie si le port spécifié sur l'hôte cible est ouvert. Si l'option “Exécuter la commande en tant qu'autre utilisateur” est activée, le contrôle est exécuté avec un utilisateur différent de celui de la connexion SSH principale.