Métodos de conector SSH (Secure Shell)

Os métodos de conector SSH (Secure Shell) estabelecem uma conexão SSH, executam comandos pela conexão estabelecida e desconectam a sessão.

Conectar

Estabelece uma conexão SSH. Forneça as informações necessárias para se conectar a uma máquina remota.

Selecione o ícone de configurações ( ) para escolher o tipo de autenticação.

Os tipos de autenticação compatíveis são Senha, KeyboardInteractive e KeyFileAuthentication.

A senha é o tipo de autenticação padrão.

Tabela 1. Parâmetros do método de conexão

Parâmetro	Descrição	Tipo de porta de dados	Tipo de dados
Nome do host	Nome do host do servidor remoto ou endereço IP.	Dados em	Cadeia de caracteres
Nome do usuário	Nome de usuário da conta SSH.	Dados em	Cadeia de caracteres
Senha	Representação de cadeia de caracteres segura da senha. Senha da conta SSH. Você pode usar o componente SecureStringEncode para codificar a senha de cadeia de caracteres segura, conforme mencionado no exemplo a seguir. Para obter mais informações, consulte Use o componente SecureStringEncode. Figura 1. Método de conexão com parâmetro de senha Depois de executar esta tarefa, você pode se conectar ao servidor remoto.	Dados em	Cadeia de caracteres segura
Porta	Opcional. O número da porta da conexão SSH. O valor padrão é 22.	Dados em	Inteiro
Criar Shell	Opcional. Se verdadeiro, um fluxo de shell será criado na conexão bem-sucedida. Qualquer comando que esteja sendo executado nesta conexão usa o shell. Se Falso, qualquer comando que esteja sendo executado nesta conexão não faz o shell. O valor padrão é verdadeiro.	Dados em	Booliano
KeyboardInteractiveAuth	Senha como desafio. Se verdadeiro, o servidor solicitará a senha do cliente para verificar a identidade do usuário. O valor fornecido no parâmetro password é compartilhado como uma resposta do cliente. Este parâmetro aparece somente quando KeyboardInterativo É selecionado no Tipo de autenticação.	Dados em	Booliano
Caminho do arquivo-chave	Caminho da chave privada. Este parâmetro aparece somente quando KeyFileAuthentication É selecionado no Tipo de autenticação.	Dados em	Cadeia de caracteres
Frase secreta	Opcional. Se a chave privada for criptografada usando senha, o mesmo valor será fornecido dentro do parâmetro Senha para usar a chave privada. Este parâmetro aparece somente quando KeyFileAuthentication É selecionado no Tipo de autenticação.	Dados em	Cadeia de caracteres

Comando de execução

Depois de estabelecer uma conexão SSH, execute comandos na conexão estabelecida usando o método RunCommand.

Tabela 2. Parâmetros do método RunCommand

Parâmetro	Descrição	Tipo de porta de dados	Tipo de dados
Comando	Os comandos que devem ser executados no servidor SSH remoto, como mensagens ou scripts, podem ser comandos shell válidos ou executáveis que o servidor remoto pode entender. Por exemplo, olá do eco . Figura 2. Método RunCommand - Parâmetro de comando	Dados em	Cadeia de caracteres
Tempo limite	Opcional. O parâmetro que especifica o tempo máximo (em segundos) para aguardar a saída do comando do servidor SSH ao usar um shell interativo. O valor padrão é 30.	Dados em	Inteiro
Retornar	O resultado do comando executado. Por exemplo, depois de executar a automação, na Visualização de dados do parâmetro de retorno, "Olá" é exibido. Figura 3. Parâmetro de retorno do método RunCommand	Saída de dados	Cadeia de caracteres

Desconectar

Após executar os comandos, desconecte a conexão estabelecida usando o método de desconexão.

O exemplo a seguir mostra toda a automação após adicionar o método de desconexão.

Figura 4. Método de desconexão