Saltar para o conteúdo
Riversoft STCP DirectLink
Integração
SFTP

SFTP

O Riversoft® STCP DirectLink troca arquivos com parceiros por SFTP (SSH File Transfer Protocol) nos dois sentidos de conexão: ele pode se conectar ao servidor do parceiro ou receber a conexão do parceiro. Nos dois casos, os arquivos vão e voltam na mesma conexão.

ComponenteQuem inicia a conexãoFunção
Conector SFTPO Riversoft STCP DirectLink (conexão de saída)Conecta-se ao servidor SFTP do parceiro para enviar e buscar arquivos.
Serviço SFTP DirectLinkO parceiro (conexão de entrada)Recebe a conexão do parceiro, que envia e baixa arquivos da própria caixa postal.

Conexões de saída (conector SFTP)

Envio

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      SA["Diretório saida"] --> C[Conector SFTP]
    end
    C -->|envio| P[Servidor SFTP do parceiro]

Busca

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      C[Conector SFTP] --> EN["Diretório entrada"]
    end
    P[Servidor SFTP do parceiro] -->|busca| C

Nota

O envio e a busca podem acontecer na mesma conexão: primeiro o Riversoft STCP DirectLink envia os arquivos, depois busca os do parceiro. Conforme o modo configurado no usuário, a conexão pode também só enviar ou só buscar.

O Riversoft STCP DirectLink se conecta ao servidor do parceiro por agendamento, ou quando o operador inicia a conexão no Riversoft Console Portal. Na mesma conexão, ele:

  1. envia os arquivos disponíveis para o parceiro na caixa postal do usuário (diretório saida);
  2. busca os arquivos do parceiro no diretório combinado e os grava no diretório entrada da caixa postal.
EtapaComportamento
EnvioO arquivo é gravado com um nome temporário (diretório ou extensão temporária, quando configurados) e renomeado ao final. Se o servidor do parceiro já tiver um arquivo com o mesmo nome, ele pode recusar a renomeação: o Riversoft STCP DirectLink não sobrescreve arquivos do parceiro.
BuscaSomente os arquivos que atendem à máscara configurada são buscados.
Depois da buscaO arquivo pode ser copiado para um diretório de backup no servidor do parceiro e, se configurado, removido do diretório de origem.
RedeA conexão pode sair por um proxy HTTP, HTTPS, SOCKS4 ou SOCKS5, e por um endereço local específico.

O que combinar com o parceiro

ItemDescrição
ServidorEndereço e porta do servidor SFTP.
CredencialUsuário e senha, ou o par de chaves: a chave privada fica no Riversoft STCP DirectLink e a chave pública é entregue ao parceiro.
Identidade do servidorFingerprint da chave do servidor, para confirmar que a conexão é com o parceiro certo.
DiretóriosOnde entregar os arquivos e de onde buscá-los, com a máscara dos arquivos a buscar.
Pós-processamentoSe os arquivos buscados devem ser removidos ou movidos para backup no servidor do parceiro.

Esses dados são cadastrados no usuário, no Riversoft Console Portal, junto com o agendamento das conexões.

Conexões de entrada (serviço SFTP DirectLink)

Envio pelo parceiro

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      S[Serviço SFTP DirectLink] --> EN["Diretório entrada"]
    end
    Q[Cliente SFTP do parceiro] -->|envio do parceiro| S

Download pelo parceiro

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      SA["Diretório saida"] --> S[Serviço SFTP DirectLink]
    end
    S -->|download do parceiro| Q[Cliente SFTP do parceiro]

Nota

O envio e o download podem acontecer na mesma sessão: o parceiro decide quais operações faz enquanto está conectado.

O parceiro se conecta ao Riversoft STCP DirectLink com um cliente SFTP e o usuário cadastrado para ele. Na mesma sessão, ele pode:

  • enviar arquivos, que chegam ao diretório entrada da caixa postal;
  • baixar os arquivos disponibilizados para ele no diretório saida.

O parceiro vê somente a própria caixa postal.

AutenticaçãoComo funciona
Chave públicaA chave pública do parceiro é cadastrada no usuário. É a opção recomendada.
SenhaUsuário e senha do Riversoft STCP DirectLink, com as políticas de senha e MFA do usuário.

O serviço SFTP DirectLink é cadastrado nos serviços de rede da instância, no Riversoft Console Portal: endereço, porta, chave do servidor e limites de conexões e de arquivos abertos.

Segurança

  • Prefira autenticação por chave a autenticação por senha, nos dois sentidos.
  • Confirme o fingerprint do servidor do parceiro antes da primeira troca.
  • Libere a porta do serviço SFTP somente para os endereços dos parceiros.
  • Veja os algoritmos suportados em Segurança: SFTP.
FTP e FTPSWebhook