Conceitos e arquitetura

O Riversoft® STCP Gemini é o produto de transferência gerenciada de arquivos (MFT) da Riversoft para o protocolo OFTP, usado na troca de arquivos entre empresas, como no setor automotivo e em bancos:

• Versões: OFTP 1.x e OFTP 2.0, com TLS também no OFTP 1.x.
• Papéis: servidor, recebendo as conexões dos parceiros, e cliente, conectando aos parceiros por agendamento.
• Entrega confirmada: confirmação por EERP e retomada de transferências interrompidas.

Para portal web, API REST, SFTP, AS2, Webhook, WhatsApp e armazenamento em nuvem, use o Riversoft STCP DirectLink. Os dois produtos podem ser usados juntos ou separadamente e compartilham a gestão pelo Riversoft Console Portal e as caixas postais.

Arquitetura

O Riversoft STCP Gemini e o Riversoft STCP DirectLink são produtos independentes, que podem ser usados juntos ou separadamente. Os dois são configurados e monitorados pelo Riversoft Console Portal e pela Riversoft STCP Gemini API, e a configuração, os registros e o histórico das transferências ficam no banco de dados da sua empresa.

    flowchart LR
    ADM[Administrador] -->|HTTPS| PORTAL[Riversoft Console Portal]
    SIS[Sistemas externos] -->|HTTPS / REST| API[Riversoft STCP Gemini API]
    PORTAL --> API
    API --> DB[(Banco de configuração<br/>e banco de log)]
    SRV[Riversoft STCP Gemini Server] --> DB
    DL[Riversoft STCP DirectLink] --> DB
    REN[Riversoft STCP Gemini Rename] --> DB
    SRV <-->|OFTP| PARC[Parceiros]
    DL <-->|SFTP, AS2, HTTPS, Webhook,<br/>S3, Azure Blob, GCS, OCI| PARC
    SRV -->|eventos| REN
  

Componentes

Protocolos e conectores

O Riversoft STCP Gemini transfere arquivos somente pelo OFTP, como servidor e como cliente. A tabela mostra qual produto atende cada protocolo ou conector:

Como funciona uma transferência

Sessão OFTP

No OFTP, os dois lados de uma conexão podem enviar e receber arquivos na mesma sessão. Cada arquivo recebido é confirmado ao remetente, e uma transferência interrompida é retomada do ponto em que parou.

    sequenceDiagram
    autonumber
    participant P as Parceiro
    participant G as Riversoft STCP Gemini Server
    P->>G: Abre a conexão (TLS, quando configurado)
    P->>G: Identifica-se com as credenciais OFTP
    G-->>P: Aceita a sessão (credenciais e regras do usuário válidas)
    P->>G: Envia o arquivo
    Note over P,G: Se a conexão cair, a próxima sessão retoma do ponto de parada
    G-->>P: Confirma com EERP (ou recusa com NERP, informando o motivo)
    G->>P: Envia os arquivos de saída do usuário
    P-->>G: Confirma com EERP
    P->>G: Encerra a sessão
    Note over G: Sessão, arquivos e confirmações ficam registrados no banco de log
  

Conexões de entrada e de saída

Caixa postal e diretórios

Cada usuário tem uma caixa postal no diretório de dados (DataDirectory, por padrão /usr/local/stcp/data), no caminho <DataDirectory>/<instância>/<usuário>/. O Riversoft STCP Gemini e o Riversoft STCP DirectLink usam exatamente a mesma estrutura de caixas postais:

<DataDirectory>/<instância>/<usuário>/
├── entrada/
│   └── restart/
├── saida/
│   ├── backup/
│   ├── pendente/
│   └── link/
├── controle/
├── formato/
└── temp/

    flowchart LR
    SIS[Sistema da empresa] -->|grava| SAI[saida]
    SAI -->|transmitido ou baixado| BKP[saida/backup]
    BKP -.->|retransmissão| SAI
    PARC[Parceiro ou usuário] -->|envia| ENT[entrada]
    ENT -->|lido por| SIS
  

Os nomes dos diretórios são configuráveis na instância. Veja Diretórios de dados.

Regras aplicadas a cada transferência

Em qualquer direção, a conexão e cada arquivo são validados contra as regras do usuário e da instância:

Cada recusa é registrada com o motivo. Veja Segurança.

Roteamento e automação

O Riversoft STCP Gemini Server gera um evento a cada transferência. Com o Riversoft STCP Gemini Rename instalado, esses eventos acionam as regras de roteamento configuradas no Riversoft Console Portal, que renomeiam, copiam, movem e distribuem os arquivos entre as caixas postais e outros diretórios, sem intervenção manual.

Registro e monitoramento

Conceitos-chave

Outros termos estão no Glossário.