SSH / SFTP

Comandos remotos e transferência de arquivos via SSH

Conectar SSH

ssh.connect

Conecta a servidor via SSH

Como usar

Conecta a um servidor por SSH com senha ou chave privada (ambas do cofre) e guarda a conexão, usada para comandos remotos e SFTP. "strict" só aceita servidores já conhecidos.

Exemplo: Conecte a sftp.banco.com.br porta 22 com a chave C:\Chaves\robo.pem em {ssh}.

Campos

Campo	Tipo	Padrão	Detalhes
Servidor *	Texto
Porta	Número	`22`
Usuário *	Texto
Autenticação	Opção	`Senha`	Opções: Senha, Chave privada
Senha (cofre) *	Credencial do cofre		Só quando «Autenticação» = «Senha»
Arquivo da chave privada *	Arquivo		Só quando «Autenticação» = «Chave privada»
Senha da chave (cofre)	Credencial do cofre		Só quando «Autenticação» = «Chave privada»
Salvar a conexão na variável *	Variável de saída	`ssh`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Servidor desconhecido	Opção	`Aceitar e registrar a impressão digital no log`	Opções: Aceitar e registrar a impressão digital no log, Recusar (precisa estar no known_hosts)
Tempo limite de conexão	Número	`30 s`

Resultado: guardado na variável ssh (Objeto).

Executar Comando

ssh.execute

Executa comando remoto

Como usar

Executa um comando no servidor e guarda a saída e o código de saída. Por padrão um código diferente de 0 falha o robô.

Exemplo: Execute ls /retorno/*.ret no servidor e guarde em {arquivos_retorno}.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão *	Variável	`ssh`
Comando *	Texto		Ex.: `ls -la /var/log`
Salvar a saída na variável *	Variável de saída	`output`

+ Avançado (3)

Campo	Tipo	Padrão
Tempo limite (0 = sem limite)	Número	`300 s`
Falhar o robô se retornar erro	Sim/Não	`Sim`
Salvar o código de saída na variável	Variável de saída

Resultado: guardado na variável output (Texto).

Enviar Arquivo (SFTP)

ssh.sftp_upload

Faz upload via SFTP

Como usar

Envia um arquivo local para o servidor por SFTP, numa pasta ou com um nome.

Exemplo: Envie remessa_{data}.rem para /remessa no servidor do banco.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão *	Variável	`ssh`
Arquivo local *	Arquivo
Destino remoto (pasta ou arquivo) *	Texto		Ex.: `/home/usuario/entrada/`
Salvar o caminho remoto na variável	Variável de saída

Resultado: guardado na variável escolhida (Texto).

Baixar Arquivo (SFTP)

ssh.sftp_download

Faz download via SFTP

Como usar

Baixa um arquivo do servidor por SFTP para uma pasta ou caminho local.

Exemplo: Baixe /retorno/{arquivo} para C:\Robos\retornos.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão *	Variável	`ssh`
Arquivo remoto *	Texto		Ex.: `/home/usuario/saida/relatorio.csv`
Destino local (pasta ou arquivo) *	Pasta
Salvar o caminho local na variável	Variável de saída

Resultado: guardado na variável escolhida (Texto).

Listar Diretório Remoto

ssh.list_remote_dir

Lista arquivos no servidor

Como usar

Lista os arquivos de uma pasta do servidor, opcionalmente filtrando pelo nome (como *.ret).

Exemplo: Liste *.ret em /retorno e baixe cada um com Baixar Arquivo (SFTP).

Campos

Campo	Tipo	Padrão	Detalhes
Conexão *	Variável	`ssh`
Pasta remota	Texto	`.`
Só nomes como (vazio = todos)	Texto		Ex.: `*.csv`
Salvar resultado na variável *	Variável de saída	`remote_files`	Lista de {name, path, size, modified, is_dir}

Resultado: guardado na variável remote_files (Lista).

Fechar Conexão

ssh.close

Encerra sessão SSH

Como usar

Encerra a conexão SSH/SFTP. O robô também fecha ao terminar.

Exemplo: Feche {ssh} depois de baixar os retornos.

Campos

Campo	Tipo	Padrão	Detalhes
Conexão *	Variável	`ssh`