Como conectar um servidor SFTP ou FTP
Este tutorial mostra como dar à Dattos acesso a um servidor SFTP ou FTP, para que os processos busquem arquivos de entrada e entreguem arquivos exportados nele. É o caminho mais comum para receber extratos de banco, arquivos de adquirente e relatórios de sistemas que geram arquivo. Para entender a integração como um todo, veja Repositórios de arquivos: quais a Dattos conecta e como cadastrar.
Qual tipo escolher
Tipo de credencial | Quando usar |
|---|---|
SFTP - Senha | O servidor SFTP autentica com usuário e senha |
SFTP - Chave SSH | O servidor SFTP autentica com chave SSH. É a opção mais segura e a que a maioria dos bancos exige |
FTP | Só quando o servidor não oferece SFTP |
FTP não é criptografado. Usuário, senha e o conteúdo dos arquivos trafegam sem proteção. Sempre que o servidor oferecer SFTP, prefira SFTP.
O que você precisa
Servidor acessível pela internet. A Dattos não se conecta a endereços de rede interna (por exemplo,
10.x.x.x,172.16.x.xa172.31.x.x,192.168.x.x), alocalhostnem a servidores que só existem dentro da VPN da empresa.Firewall liberado para a Dattos. Se o servidor só aceita conexões de endereços conhecidos, peça ao suporte da Dattos os endereços que devem ser liberados.
Um usuário exclusivo para a Dattos, com permissão nas pastas que ela vai usar para listar, ler, gravar, renomear e mover arquivos e para criar pastas. A Dattos cria as subpastas de controle
.processing,.processede.errordentro da pasta de origem.As pastas já criadas no servidor.
1. Prepare a chave SSH (só para SFTP - Chave SSH)
Pule este passo se o servidor usa senha.
Gere um par de chaves (por exemplo, com
ssh-keygenou PuTTYgen). Você pode proteger a chave com uma senha (passphrase).Envie a chave pública ao administrador do servidor SFTP, para ele autorizar o usuário da Dattos.
Guarde a chave privada: é ela que vai para a Dattos, colada como texto.
A Dattos aceita chaves RSA, ECDSA ou Ed25519, nos formatos OpenSSH (o texto começa com -----BEGIN OPENSSH PRIVATE KEY-----), PEM (-----BEGIN RSA PRIVATE KEY----- ou -----BEGIN PRIVATE KEY-----) ou PuTTY (.ppk, aberto num editor de texto). Chaves DSA não são aceitas.
Se o banco ou parceiro é quem gera a chave e manda para você, confira se ela está num desses formatos.
2. Cadastre a credencial na Dattos
Clique no ícone de engrenagem e abra Geral › Credenciais.
Clique em + Nova credencial e, na aba Armazenamento, escolha SFTP - Senha, SFTP - Chave SSH ou FTP.
Preencha os campos:
Campo | O que informar | Tipos |
|---|---|---|
Nome da credencial | Um nome que identifique o servidor, como "SFTP Banco X - extratos" | Todos |
Host / URL | Só o endereço do servidor (por exemplo, | Todos |
Porta |
| Todos |
Usuário | O usuário criado para a Dattos | Todos |
Senha | A senha do usuário | SFTP - Senha e FTP |
Chave Privada | O texto inteiro do arquivo da chave privada, da primeira à última linha | SFTP - Chave SSH |
Senha da Chave | A senha (passphrase) da chave, se você criou uma. Deixe em branco se a chave não tem senha | SFTP - Chave SSH |
Caminho Remoto | Opcional. A pasta a partir da qual a Dattos lista as pastas, por exemplo | Todos |
Perfis de privacidade | Quem pode usar esta credencial nos processos | Todos |
Clique em Salvar.
3. Teste a conexão (só SFTP)
Depois de salvar, abra a credencial de novo e clique em Testar conexão.
O teste confirma que o servidor responde no endereço e na porta informados. Ele não confere usuário, senha nem chave: um teste com sucesso quer dizer que a Dattos alcança o servidor, não que o login vai funcionar. O FTP não tem o botão Testar conexão. Para os dois, a confirmação completa é o próximo passo.
4. Confira e ligue o servidor a um processo
Abra um processo Turbo AI com o fluxo publicado e vá em Diretório de Origem.
Clique em Editar na fonte desejada, depois em Adicionar destino.
Em Integração de Armazenamento, escolha a credencial que você criou.
Se as pastas do servidor aparecerem em Pastas de Importação, o login e a permissão de leitura estão certos. Escolha a pasta e salve.
O passo a passo completo, inclusive da saída, está em Integração com repositórios de arquivos: diretórios de origem e de saída.
Dica: use o FileZilla para ver e testar as pastas
A Dattos mostra as pastas do servidor, mas não os arquivos. Para conferir se o arquivo chegou, se ele foi para .processed ou para .error, ou se a exportação foi entregue, use um programa de transferência de arquivos como o FileZilla Client, gratuito, para Windows, macOS e Linux.
O FileZilla também ajuda a testar o login antes de cadastrar a credencial, o que o Testar conexão da Dattos não faz:
Abra Arquivo › Gerenciador de sites e clique em Novo site.
Em Protocolo, escolha SFTP – SSH File Transfer Protocol (ou a opção de FTP).
Preencha Host e Porta com os mesmos valores que você vai usar na Dattos.
Em Tipo de login, escolha Normal para usuário e senha, ou Arquivo de chave para chave SSH. Informe o Usuário criado para a Dattos e, no caso da chave, clique em Buscar e escolha o arquivo da chave privada (no Windows, mude o filtro para Todos os arquivos se a chave não aparecer). Se a chave não estiver no formato que o FileZilla usa, ele oferece converter e salvar uma cópia convertida; aceite. Na Dattos, continue colando a chave original.
Clique em Conectar.
Se o FileZilla entra com esse usuário e mostra as pastas, os dados de acesso estão certos. Leve em conta que o FileZilla conecta a partir da rede da sua empresa: um servidor que responde de dentro da empresa pode continuar bloqueado para a Dattos, se o firewall não liberar o acesso de fora.
As subpastas de controle começam com ponto (.processing, .processed, .error) e, por isso, muitos servidores as tratam como ocultas. Se não aparecerem no FileZilla, abra o menu Servidor e ative a opção de forçar a exibição de arquivos ocultos (em inglês, Force showing hidden files).
Problemas comuns
O que você vê | Causa provável |
|---|---|
Testar conexão falha por tempo esgotado | Firewall do servidor bloqueando a Dattos, porta errada ou servidor fora do ar |
Erro no teste ou ao carregar as pastas, mesmo com o servidor no ar | O Host / URL aponta para um endereço de rede interna ou foi preenchido com |
Testar conexão dá certo, mas as pastas não carregam | Usuário, senha ou chave errados, ou a chave pública não foi autorizada no servidor |
As pastas aparecem, mas a execução termina com erro ao mover o arquivo | O usuário não tem permissão para renomear arquivos ou criar pastas |
A lista de pastas está vazia ou incompleta | O Caminho Remoto aponta para outra pasta, ou o usuário não tem permissão de listar as pastas esperadas |