Conceptos y arquitectura

Riversoft® STCP DirectLink es el producto de transferencia gestionada de archivos (MFT) de Riversoft para personas, sistemas y socios:

• Personas: portal web, en el navegador.
• Sistemas: API REST.
• Socios: SFTP, AS2 y Webhook.
• Otros destinos: WhatsApp y almacenamiento en la nube (Amazon S3, Azure Blob Storage, Google Cloud Storage y Oracle Cloud Object Storage).

Para intercambios por el protocolo OFTP, use Riversoft STCP Gemini. Ambos productos pueden usarse juntos o por separado y comparten la gestión mediante el Riversoft Console Portal y los buzones.

Arquitectura

Riversoft STCP Gemini y Riversoft STCP DirectLink son productos independientes, que pueden usarse juntos o por separado. Ambos se configuran y supervisan mediante el Riversoft Console Portal y la Riversoft STCP Gemini API, y la configuración, los registros y el historial de las transferencias quedan en la base de datos de su empresa.

    flowchart LR
    ADM[Administrador] -->|HTTPS| PORTAL[Riversoft Console Portal]
    SIS[Sistemas externos] -->|HTTPS / REST| API[Riversoft STCP Gemini API]
    PORTAL --> API
    API --> DB[(Base de configuración<br/>y base de log)]
    SRV[Riversoft STCP Gemini Server] --> DB
    DL[Riversoft STCP DirectLink] --> DB
    REN[Riversoft STCP Gemini Rename] --> DB
    SRV <-->|OFTP| PARC[Socios]
    DL <-->|SFTP, AS2, HTTPS, Webhook,<br/>S3, Azure Blob, GCS, OCI| PARC
    SRV -->|eventos| REN
  

Componentes

Protocolos y conectores

Riversoft STCP DirectLink atiende a personas, sistemas y socios, cada uno por el medio más adecuado:

    flowchart LR
    U[Usuario en el navegador] -->|HTTPS| P[Riversoft STCP DirectLink Portal]
    S[Sistema integrado] -->|HTTPS / API REST| A[Riversoft STCP DirectLink]
    PS[Portal de servicios] -->|Token exchange JWT| A
    IdP[Proveedor de identidad] -.->|SSO OAuth 2.0 / SAML 2.0| A
    P --> A
    PARC[Socios] <-->|SFTP, AS2, Webhook| A
    A <-->|S3, Azure, GCS, OCI| N[Almacenamiento en la nube]
    A -.->|correo, SMS, WhatsApp| D[Destinatario externo]
    G[Riversoft Console Portal y<br/>Riversoft STCP Gemini API] -->|configura y supervisa| A
  

La tabla siguiente muestra qué producto atiende cada protocolo o conector. Los detalles están en Protocolos y conectores.

Cómo funciona una transferencia

Envío y recepción por la API

Las rutas protegidas exigen un token Bearer. La contraseña se presenta una sola vez, al obtener el token.

    sequenceDiagram
    autonumber
    participant App as Aplicación cliente
    participant DL as API Riversoft STCP DirectLink
    App->>DL: POST /oauth2/token (password grant o token exchange)
    DL-->>App: access_token (Bearer)
    App->>DL: POST /upload (Authorization: Bearer)
    DL-->>App: Carga confirmada
    App->>DL: GET /download/list (Authorization: Bearer)
    DL-->>App: Lista de archivos con linkURL (enlace seguro)
    App->>DL: GET linkURL (/download/file?...) con token Bearer
    DL-->>App: Contenido del archivo y header X-STCPDIRECTLINK-HASH
    Note over DL: El archivo pasa al área de backup
  

El destino de un archivo cargado depende de lo que se indique en la carga:

La lista de descarga muestra los archivos del directorio saida. Después de la descarga, el archivo pasa al área de backup (saida/backup).

Enlace seguro para destinatarios externos

Al enviar un archivo, es posible indicar el correo electrónico o el celular de un destinatario. Este recibe un enlace seguro para la descarga, que identifica el correo electrónico o celular vinculado al archivo y solo libera la descarga con un código de seguridad (PIN).

    sequenceDiagram
    autonumber
    participant R as Remitente
    participant DL as Riversoft STCP DirectLink
    participant D as Destinatario
    R->>DL: Carga con el correo o celular del destinatario
    DL->>D: Enlace seguro (correo, SMS o WhatsApp)
    D->>DL: Abre el enlace
    DL->>D: Código de seguridad (solo al correo o celular vinculado)
    D->>DL: Informa el código dentro del plazo de vigencia
    DL-->>D: Descarga del archivo
  

Autenticación por JWT de confianza

Los portales de servicios pueden autenticar a sus usuarios en Riversoft STCP DirectLink intercambiando un token JWT, firmado con la clave privada del portal, por un token Bearer de Riversoft STCP DirectLink (token exchange). Riversoft STCP DirectLink valida el JWT con la configuración del proveedor JWT registrada por el administrador. El flujo completo está en Seguridad.

Conexiones de entrada y de salida

Buzón y directorios

Cada usuario tiene un buzón en el directorio de datos (DataDirectory, por defecto /usr/local/stcp/data), en la ruta <DataDirectory>/<instancia>/<usuario>/. Riversoft STCP Gemini y Riversoft STCP DirectLink usan exactamente la misma estructura de buzones:

<DataDirectory>/<instancia>/<usuario>/
├── entrada/
│   └── restart/
├── saida/
│   ├── backup/
│   ├── pendente/
│   └── link/
├── controle/
├── formato/
└── temp/

    flowchart LR
    SIS[Sistema de la empresa] -->|graba| SAI[saida]
    SAI -->|transmitido o descargado| BKP[saida/backup]
    BKP -.->|retransmisión| SAI
    PARC[Socio o usuario] -->|envía| ENT[entrada]
    ENT -->|leído por| SIS
  

Los nombres de los directorios son configurables en la instancia. Vea Directorios de datos.

Áreas de archivos

En la interfaz de Riversoft STCP DirectLink, cada usuario ve tres áreas de su buzón:

Reglas aplicadas a cada transferencia

Antes de aceptar un envío o liberar una descarga, Riversoft STCP DirectLink valida la operación contra las reglas del usuario:

Cada operación, aceptada o rechazada, queda registrada. Vea Seguridad.

Enrutamiento y automatización

Con el enrutamiento habilitado, Riversoft STCP DirectLink examina periódicamente los directorios configurados y encamina cada archivo encontrado según una tabla de distribución (CSV), que relaciona el origen del archivo con los destinos y los destinatarios.

    flowchart LR
    ARQ[Archivo encontrado<br/>en el directorio] --> TAB{Tabla de<br/>distribución}
    TAB -->|copia| DEST[Directorio de destino]
    TAB -->|enlace| LINK[Enlace seguro para<br/>los destinatarios]
    TAB -->|comando externo| CMD[Programa de la empresa]
    TAB --> BKP[Backup del original]
  

Para reglas más elaboradas de renombrar, copiar, mover y distribuir, use Riversoft STCP Gemini Rename. Los parámetros están en Configuración › Enrutamiento y distribución.

Registro y monitoreo

Vea Monitoreo y auditoría.

Conceptos clave

Otros términos están en el Glosario.