Métodos de conector SSH (Secure Shell)

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

Conecte-se

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 Password, KeyboardInteractive e KeyFileAuthentication.

Senha é o tipo de autenticação padrão.

Tabela 1. Parâmetros do método do Connect

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 da 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
CreateShell	Opcional. Se verdadeiro, um fluxo de shell será criado na conexão bem-sucedida. Qualquer comando em execução nesta conexão usa o shell. Se Falso, qualquer comando que esteja sendo executado nesta conexão não fará 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 de senha é compartilhado como uma resposta do cliente. Este parâmetro aparece somente quando KeyboardInterativo Selecionado no Tipo de autenticação.	Dados em	Booliano
KeyFilePath	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

Executar Comando

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 comandos 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

Depois de executar os comandos, desconecte a conexão estabelecida usando o método Desconectar.

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

Figura 4. Método de desconexão