Skip to main content

Unix Check Connection

  • Task type: ssh_checkconnection

Descrizione​

Il Task Unix Check Connection permette al Workflow di verificare la raggiungibilitatà di un host di destinazione, sia dalla macchina locale (modalità Default) sia da un server remoto tramite SSH.

In modalità remota, il Task opera in due passaggi:

  • si connette a un server di origine tramite SSH
  • dal server di origine verifica se un secondo host è raggiungibile

È utile per verificare la connettività tra sistemi all'interno di reti private o protette.

Configurazione​

La configurazione si divide in due parti: la modalità di esecuzione/connessione e l'indirizzo dell'host di destinazione. I campi 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 SSH.
  • 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.

Host di Destinazione​

  • Host: L'indirizzo IP o il nome host della macchina di destinazione di cui si vuole verificare la raggiungibilità.

Parametri di Output

I parametri di output per questo Task sono:

  • result: Contiene un messaggio testuale che descrive l'esito del controllo (es. “PING www.google.com (216.58.204.132) 56(84) bytes of data. 64 bytes from etc...”) o un messaggio di errore.
  • 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. Un valore di 0 indica che l'host è stato raggiunto con successo, mentre un valore diverso da zero indica che non è raggiungibile.

Esempio Parametro resultJson​

{
 "id": 19861,
 "name": "Unix Check Connection",
 "description": "",
 "type": "ssh_checkconnection",
 "type_name": "Unix Check Connection",
 "type_description": "Verifica Connessione",
 "config": {
 "host": "8.8.8.8",
 "operation": "checkconnection",
 "connection": {
 "ip": "",
 "port": "",
 "user": "",
 "hostname": "",
 "password": "",
 "use_password": "N",
 "connection_mode": "default",
 "hidden_task_pwd": "0",
 "env_connection_name": "---"
 },
 "output_links": []
 },
 "run_info": {
 "run_id": 1504143,
 "start_datetime": "2026-04-22 10:02:30",
 "end_datetime": "2026-04-22 10:02:31",
 "start_epoch": 1776852150.849703,
 "end_epoch": 1776852151.985916,
 "duration": 1,
 "status": "Completed",
 "cmd_text": "",
 "run_result": "Success",
 "result_text": "PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.\n64 bytes from 8.8.8.8: icmp_seq=1 ttl=108 time=11.2 ms\n...",
 "full_result_text": "PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.\n64 bytes from 8.8.8.8: icmp_seq=1 ttl=108 time=11.2 ms\n64 bytes from 8.8.8.8: icmp_seq=2 ttl=108 time=11.3 ms\n\n--- 8.8.8.8 ping statistics ---\n2 packets transmitted, 2 received, 0% packet loss, time 1001ms\nrtt min/avg/max/mdev = 11.156/11.227/11.298/0.071 ms"
 },
 "output_parameters": {
 "exitStatus": "0"
 }
}

Note​

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