Skip to main content

Unix Check Port

  • Task type: ssh_checkport

Descrizione​

Il Task Unix Check Port consente di verificare se una specifica porta è aperta su un host di destinazione, eseguendo il controllo dalla macchina locale (modalità Default) o da un server remoto tramite SSH.

A differenza del task Unix Check Connection, che verifica la raggiungibilità dell’host, questo Task controlla se una specifica porta è aperta e raggiungibile sul sistema di destinazione.

Configurazione

La configurazione è molto simile a quella del Task "Unix Check Connection", ma con l'aggiunta della porta da verificare. I campi di configurazione del Task possono essere valorizzati manualmente o tramite parametri e variabili del workflow.

Connessione al Server​

  • Modalità connessione: Definisce l’origine delle credenziali utilizzate per la connessione. Può assumere tre modalità operative:
  • Default: il controllo viene eseguito dalla macchina locale.
  • Manuale: Consente l’inserimento manuale dei parametri di connessione.
  • Environment: Utilizza un ambiente di connessione preconfigurato. In questa modalità viene visualizzato un menu che elenca le connessioni disponibili in base al ruolo associato al Workflow.
  • Indirizzo IP: Indirizzo IP del server remoto.
  • Hostname: Nome host del server remoto.
  • Utente: Nome utente utilizzato per stabilire la connessione SSH.
  • Password: Password associata all'utente di connessione.
  • Porta: Porta utilizzata per la connessione SSH (il valore predefinito è 22).

Esegui comando come altro utente​

Attivando questa checkbox, è possibile eseguire la ricerca con un utente diverso da quello utilizzato per la connessione SSH.

  • Utente: Nome dell'utente con cui verrà eseguito il comando.
  • Password: Password dell’utente utilizzato per l’esecuzione del comando.

Parametri di Controllo (Host di Destinazione)​

  • Host: L'indirizzo IP o il nome host della macchina di destinazione su cui si vuole verificare la porta.
  • Porta: Il numero di porta che si desidera controllare sull'host di destinazione.

Parametri di Output

Al completamento dell’esecuzione, il task rende disponibili i seguenti Parametri di Output, utilizzabili come input nei task successivi del Workflow.

  • result: Contiene un messaggio testuale che descrive l'esito dell'operazione o un messaggio di errore (es. “Missing server address”).
  • resultJson: Rappresenta il risultato dell’esecuzione del task in formato JSON, includendo informazioni generali, configurazioni e dettagli sull’esecuzione.
  • exitStatus: Restituisce il codice di uscita del comando di rete eseguito (probabilmente netcat, telnet o simile). Un valore di 0 indica che la porta è aperta e la connessione è stata stabilita con successo.

Esempio parametro resutlJson​

{
 "id": 19862,
 "name": "Unix Check Port",
 "description": "",
 "type": "ssh_checkport",
 "type_name": "Unix Check Port",
 "type_description": "Verifica Porta",
 "config": {
 "operation": "checkport",
 "host": "example_host",
 "port": "7001",
 "connection": {
 "connection_mode": "default",
 "env_connection_name": "---",
 "ip": "",
 "hostname": "",
 "port": "",
 "user": "",
 "use_password": "N",
 "password": "",
 "hidden_task_pwd": "0"
 }
 },
 "run_info": {
 "run_id": 1504180,
 "start_datetime": "2026-04-22 12:06:40",
 "end_datetime": "2026-04-22 12:06:46",
 "start_epoch": 1776859600.883013,
 "end_epoch": 1776859606.02932,
 "duration": 5,
 "status": "Completed",
 "cmd_text": "",
 "run_result": "Failed",
 "result_text": "Ncat: Version 7.92 ( https://nmap.org/ncat )\nNcat: TIMEOUT.",
 "full_result_text": "Ncat: Version 7.92 ( https://nmap.org/ncat )\nNcat: TIMEOUT."
 },
 "output_parameters": {
 "exitStatus": "1"
 }
}

Note​

Il task stabilisce una connessione SSH con il server remoto e verifica se la porta specificata sull’host target è aperta. Se l’opzione “Esegui comando come altro utente” è abilitata, il controllo viene eseguito con un utente diverso da quello della connessione SSH principale.