Pular para o conteúdo principal

Verificar Porta Unix

Configuração atual da tarefa Unix Check Port no Workflow Designer
  • Tipo de tarefa: ssh_checkport

Descrição​

A tarefa Unix Check Port permite verificar se uma porta específica está aberta num host de destino, executando a verificação a partir da máquina local (modo Padrão) ou de um servidor remoto através de SSH.

Diferente da tarefa Unix Check Connection, que verifica a alcançabilidade do host, esta Tarefa verifica se uma porta específica está aberta e acessível no sistema de destino.

Configuração​

A configuração é muito semelhante à da Tarefa "Unix Check Connection", mas com a adição da porta a verificar. Os campos de configuração da Tarefa 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.
  • 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.

Parâmetros de Verificação (Host de Destino)​

  • Host: O endereço IP ou o nome do host da máquina de destino onde se deseja verificar a porta.
  • Porta: O número de porta que se deseja verificar no host de destino.

Parâmetros de Saída​

Após a conclusão da execução, a tarefa disponibiliza os seguintes Parâmetros de Saída, utilizáveis como entrada em tarefas subsequentes do Workflow.

  • result: Contém uma mensagem de texto que descreve o resultado da operação ou uma mensagem de erro (ex: “Missing server address”).
  • 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 (provavelmente netcat, telnet ou similar). Um valor de 0 indica que a porta está aberta e a conexão foi estabelecida com sucesso.

Exemplo 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 a porta especificada no host alvo está aberta. Se a opção “Executar comando como outro utilizador” estiver ativada, a verificação é executada com um utilizador diferente da conexão SSH principal.