Conceitos e arquitetura

O Riversoft® STCP DirectLink é o produto de transferência gerenciada de arquivos (MFT) da Riversoft para pessoas, sistemas e parceiros:

• Pessoas: portal web, pelo navegador.
• Sistemas: API REST.
• Parceiros: SFTP, AS2 e Webhook.
• Outros destinos: WhatsApp e armazenamento em nuvem (Amazon S3, Azure Blob Storage, Google Cloud Storage e Oracle Cloud Object Storage).

Para trocas pelo protocolo OFTP, use o Riversoft STCP Gemini. 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 DirectLink atende pessoas, sistemas e parceiros, cada um pelo meio mais adequado:

    flowchart LR
    U[Usuário no navegador] -->|HTTPS| P[Riversoft STCP DirectLink Portal]
    S[Sistema integrado] -->|HTTPS / API REST| A[Riversoft STCP DirectLink]
    PS[Portal de serviços] -->|Token exchange JWT| A
    IdP[Provedor de identidade] -.->|SSO OAuth 2.0 / SAML 2.0| A
    P --> A
    PARC[Parceiros] <-->|SFTP, AS2, Webhook| A
    A <-->|S3, Azure, GCS, OCI| N[Armazenamento em nuvem]
    A -.->|e-mail, SMS, WhatsApp| D[Destinatário externo]
    G[Riversoft Console Portal e<br/>Riversoft STCP Gemini API] -->|configura e monitora| A
  

A tabela abaixo mostra qual produto atende cada protocolo ou conector. Os detalhes estão em Protocolos e conectores.

Como funciona uma transferência

Envio e recebimento pela API

As rotas protegidas exigem um token Bearer. A senha é apresentada uma única vez, na obtenção do token.

    sequenceDiagram
    autonumber
    participant App as Aplicação cliente
    participant DL as API Riversoft STCP DirectLink
    App->>DL: POST /oauth2/token (password grant ou token exchange)
    DL-->>App: access_token (Bearer)
    App->>DL: POST /upload (Authorization: Bearer)
    DL-->>App: Upload confirmado
    App->>DL: GET /download/list (Authorization: Bearer)
    DL-->>App: Lista de arquivos com linkURL (link seguro)
    App->>DL: GET linkURL (/download/file?...) com token Bearer
    DL-->>App: Conteúdo do arquivo e header X-STCPDIRECTLINK-HASH
    Note over DL: O arquivo é movido para a área de backup
  

O destino de um arquivo enviado depende do que é informado no upload:

A lista de download mostra os arquivos do diretório saida. Depois do download, o arquivo é movido para a área de backup (saida/backup).

Link seguro para destinatários externos

Ao enviar um arquivo, é possível informar o e-mail ou o celular de um destinatário. Ele recebe um link seguro para download, que identifica o e-mail ou celular vinculado ao arquivo e só libera o download com um código de segurança (PIN).

    sequenceDiagram
    autonumber
    participant R as Remetente
    participant DL as Riversoft STCP DirectLink
    participant D as Destinatário
    R->>DL: Upload com e-mail ou celular do destinatário
    DL->>D: Link seguro (e-mail, SMS ou WhatsApp)
    D->>DL: Abre o link
    DL->>D: Código de segurança (somente para o e-mail ou celular vinculado)
    D->>DL: Informa o código dentro do prazo de validade
    DL-->>D: Download do arquivo
  

Autenticação por JWT de confiança

Portais de serviços podem autenticar seus usuários no Riversoft STCP DirectLink trocando um token JWT, assinado pela chave privada do portal, por um token Bearer do Riversoft STCP DirectLink (token exchange). O Riversoft STCP DirectLink valida o JWT com a configuração do provedor JWT cadastrada pelo administrador. O fluxo completo está em Segurança.

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.

Áreas de arquivos

Na interface do Riversoft STCP DirectLink, cada usuário vê três áreas da sua caixa postal:

Regras aplicadas a cada transferência

Antes de aceitar um envio ou liberar um download, o Riversoft STCP DirectLink valida a operação contra as regras do usuário:

Cada operação, aceita ou recusada, é registrada. Veja Segurança.

Roteamento e automação

Com o roteamento habilitado, o Riversoft STCP DirectLink examina periodicamente os diretórios configurados e encaminha cada arquivo encontrado conforme uma tabela de distribuição (CSV), que relaciona a origem do arquivo aos destinos e aos destinatários.

    flowchart LR
    ARQ[Arquivo encontrado<br/>no diretório] --> TAB{Tabela de<br/>distribuição}
    TAB -->|cópia| DEST[Diretório de destino]
    TAB -->|link| LINK[Link seguro para<br/>os destinatários]
    TAB -->|comando externo| CMD[Programa da empresa]
    TAB --> BKP[Backup do original]
  

Para regras de renomear, copiar, mover e distribuir mais elaboradas, use o Riversoft STCP Gemini Rename. Os parâmetros estão em Configuração › Roteamento e distribuição.

Registro e monitoramento

Veja Monitoramento e auditoria.

Conceitos-chave

Outros termos estão no Glossário.