Métodos do conector Secure Shell (SSH)

Os métodos do conector Secure Shell (SSH) estabelecem uma conexão SSH, executam comandos na 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, TecladoInterativoe KeyFileAuthentication.

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

Tabela 1. Parâmetros do método 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.	Entrada de dados	Cadeia de caracteres
Nome do usuário	Nome de usuário da conta SSH.	Entrada de dados	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 Usar o componente SecureStringEncode. Figura 1. Método Connect com parâmetro Password Depois de executar esta tarefa, você pode se conectar ao servidor remoto.	Entrada de dados	SecureString
Porta	Opcional. O número da porta da conexão SSH. O valor padrão é 22.	Entrada de dados	Números inteiros
CriarShell	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 for falso, qualquer comando em execução nesta conexão não será compatível com o shell. O valor padrão é Verdadeiro.	Entrada de dados	Booliano
TecladoInterativoAuth	Senha como um desafio. Se for 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 TecladoInterativo é selecionado em Tipo de autenticação.	Entrada de dados	Booliano
KeyFilepath	Caminho da chave privada. Este parâmetro aparece somente quando KeyFileAuthentication é selecionado em Tipo de autenticação.	Entrada de dados	Cadeia de caracteres
Senha	Opcional. Se a chave privada for criptografada usando a senha, o mesmo valor será fornecido dentro do parâmetro de senha para usar a chave privada. Este parâmetro aparece somente quando KeyFileAuthentication é selecionado em Tipo de autenticação.	Entrada de dados	Cadeia de caracteres

ExecutarComando

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	Comandos que devem ser executados no servidor SSH remoto, como mensagens ou scripts, podem ser comandos de shell válidos ou comandos executáveis que o servidor remoto pode entender. Por exemplo, echo Olá. Figura 2. Método RunCommand - Parâmetro de comando	Entrada de dados	Cadeia de caracteres
Tempo limite	Opcional. O parâmetro que especifica o tempo máximo (em segundos) de espera pela saída do comando do servidor SSH ao usar um shell interativo. O valor padrão é 30.	Entrada de dados	Números inteiros
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. Retornar parâmetro do método RunCommand	Saída de dados	Cadeia de caracteres

Desconectar

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

O exemplo a seguir mostra a automação inteira depois de adicionar o método Disconnect.

Figura 4. Método de desconexão