Pular para o conteúdo principal

Verificação de Conexão Unix

Configuração atual da tarefa Unix Check Connection no Workflow Designer
  • Tipo de Tarefa: ssh_checkconnection

Descrição​

A Tarefa Unix Check Connection permite que o Workflow verifique a alcançabilidade de um host de destino, tanto a partir da máquina local (modo Padrão) quanto de um servidor remoto através de SSH.

Em modo remoto, a Tarefa opera em duas etapas:

  • conecta-se a um servidor de origem através de SSH
  • a partir do servidor de origem, verifica se um segundo host é alcançável

É útil para verificar a conectividade entre sistemas dentro de redes privadas ou protegidas.

Configuração​

A configuração divide-se em duas partes: o modo de execução/conexão e o endereço do host de destino. Os campos podem ser preenchidos manualmente ou através de parâmetros e variáveis do fluxo de trabalho.

Conexão ao Servidor​

  • Modo de Conexão: Define a origem das credenciais utilizadas para a conexão. Pode assumir três modos operacionais:
  • Padrão: a verificação é executada a partir da máquina local
  • Manual: Permite o preenchimento manual dos parâmetros de conexão SSH.
  • Ambiente: Utiliza um ambiente de conexão pré-configurado. Neste modo, é exibido um menu que lista as conexões disponíveis com base no papel associado ao Workflow.
  • Endereço IP: Endereço IP do servidor remoto.
  • Hostname: Nome do host do servidor remoto.
  • Usuário: Nome de utilizador usado para estabelecer a conexão SSH.
  • Palavra-passe: Palavra-passe associada ao utilizador de conexão.
  • Porta: Porta utilizada para a conexão SSH (o valor padrão é 22).

Executar comando como outro utilizador​

Ao ativar esta caixa de seleção, é possível executar a pesquisa com um utilizador diferente daquele utilizado para a conexão SSH.

  • Utilizador: Nome do utilizador com quem o comando será executado.
  • Palavra-passe: Palavra-passe do utilizador usado para a execução do comando.

Host de Destino​

  • Host: O endereço IP ou o nome do host da máquina de destino cuja alcançabilidade se pretende verificar.

Parâmetros de Saída​

Os parâmetros de saída para esta Tarefa são:

  • result: Contém uma mensagem de texto que descreve o resultado da verificação (ex: “PING www.google.com (216.58.204.132) 56(84) bytes of data. 64 bytes from etc...”) ou uma mensagem de erro.
  • resultJson: Representa o resultado da execução da tarefa em formato JSON, incluindo informações gerais, configurações e detalhes da execução.
  • exitStatus: Retorna o código de saída do comando de rede executado. Um valor de 0 indica que o host foi alcançado com sucesso, enquanto um valor diferente de zero indica que não é alcançável.

Exemplo de Parâmetro resultJson​

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

Notas​

A tarefa estabelece uma conexão SSH com o servidor remoto e verifica se o host alvo é alcançável. Se a opção “Executar comando como outro utilizador” estiver ativada, a verificação é executada com um utilizador diferente da conexão SSH principal.