Saltar al contenido
Conceptos y arquitectura

Conceptos y arquitectura

Riversoft® STCP Gemini es el producto de transferencia gestionada de archivos (MFT) de Riversoft para el protocolo OFTP, usado en el intercambio de archivos entre empresas, como en el sector automotriz y en bancos:

  • Versiones: OFTP 1.x y OFTP 2.0, con TLS también en OFTP 1.x.
  • Funciones: servidor, que recibe las conexiones de los socios, y cliente, que se conecta a los socios por agendamiento.
  • Entrega confirmada: confirmación por EERP y reanudación de las transferencias interrumpidas.

Para portal web, API REST, SFTP, AS2, Webhook, WhatsApp y almacenamiento en la nube, use Riversoft STCP DirectLink. 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
  
ParteFunción
TransferenciaRiversoft STCP Gemini Server intercambia archivos con los socios por OFTP; Riversoft STCP DirectLink, por los demás protocolos y conectores.
GestiónEl Riversoft Console Portal y la Riversoft STCP Gemini API crean y modifican instancias, usuarios, servicios de red y agendamientos, y acompañan las transferencias.
Base de datosGuarda la configuración (base de configuración) y el historial de las transferencias (base de log).
BuzonesDirectorios de cada usuario, donde están los archivos por enviar y los recibidos. Vea Buzón y directorios.
AutomatizaciónRiversoft STCP Gemini Rename y el enrutamiento interno de Riversoft STCP DirectLink encaminan los archivos según las reglas.

Componentes

ComponenteFunciónPaquete
Riversoft STCP Gemini ServerTransfiere archivos por el protocolo OFTP, como servidor y cliente. También ofrece un cliente SFTP heredado, pero para SFTP se recomienda Riversoft STCP DirectLink.stcpgemini-server
Riversoft Console PortalInterfaz web de configuración y supervisión de Riversoft STCP Gemini y Riversoft STCP DirectLink. La sirve la propia Riversoft STCP Gemini API, sin servidor web adicional.stcpgemini-portal
Riversoft STCP Gemini APIAPI REST de gestión de Riversoft STCP Gemini y Riversoft STCP DirectLink: instancias, usuarios, servicios de red, agendamientos, tipos de archivo e informes. Vea Riversoft STCP Gemini API.stcpgemini-api
Riversoft STCP Gemini Rename (opcional)Enrutamiento y automatización de archivos, mediante reglas configuradas en el Riversoft Console Portal. Se instala en el mismo servidor que Riversoft STCP Gemini Server.stcpren
Riversoft STCP DirectLink (opcional)Transfiere archivos por todos los protocolos y conectores además de OFTP. Vea Riversoft STCP DirectLink.stcpdirectlink

Protocolos y conectores

Riversoft STCP Gemini transfiere archivos solo por OFTP, como servidor y como cliente. La tabla muestra qué producto atiende cada protocolo o conector:

Conector / protocoloServidorClienteProducto
OFTP 1.x y OFTP 2.0✓✓Riversoft STCP Gemini
SFTP✓✓Riversoft STCP DirectLink (cliente heredado también en Riversoft STCP Gemini Server)
AS2✓✓Riversoft STCP DirectLink
HTTPS (portal web y API REST)✓—Riversoft STCP DirectLink
Webhook✓✓Riversoft STCP DirectLink
WhatsApp—✓Riversoft STCP DirectLink
FTPS / FTP—✓Riversoft STCP DirectLink
Amazon S3, Azure Blob Storage, Google Cloud Storage, Oracle Cloud Object Storage—✓Riversoft STCP DirectLink

Nota

Puede haber otros conectores disponibles según la versión y la configuración. Vea Protocolos y conectores de Riversoft STCP DirectLink.

Cómo funciona una transferencia

Sesión OFTP

En OFTP, los dos lados de una conexión pueden enviar y recibir archivos en la misma sesión. Cada archivo recibido se confirma al remitente, y una transferencia interrumpida se reanuda desde el punto en que se detuvo.

    sequenceDiagram
    autonumber
    participant P as Socio
    participant G as Riversoft STCP Gemini Server
    P->>G: Abre la conexión (TLS, cuando está configurado)
    P->>G: Se identifica con las credenciales OFTP
    G-->>P: Acepta la sesión (credenciales y reglas del usuario válidas)
    P->>G: Envía el archivo
    Note over P,G: Si la conexión cae, la próxima sesión reanuda desde el punto de parada
    G-->>P: Confirma con EERP (o rechaza con NERP, indicando el motivo)
    G->>P: Envía los archivos de salida del usuario
    P-->>G: Confirma con EERP
    P->>G: Cierra la sesión
    Note over G: La sesión, los archivos y las confirmaciones quedan registrados en la base de log
  
EtapaQué ocurre
ConexiónEl socio se identifica con las credenciales OFTP registradas para el usuario. La sesión se rechaza si las credenciales, el modo de autenticación o el modo de conexión no corresponden a la configuración.
TransmisiónEl archivo se envía en bloques. En OFTP 2.0, puede cifrarse, firmarse y comprimirse.
ReanudaciónSi la conexión cae, la información de reanudación se guarda y la próxima sesión continúa desde el punto en que se detuvo, sin reenviar el archivo completo.
ConfirmaciónEl receptor confirma el archivo con EERP (End-to-End Response) o lo rechaza con NERP (Negative End Response), indicando el motivo. La confirmación puede enviarse en la misma sesión o en una sesión posterior.
RegistroLa sesión, los archivos, las confirmaciones y el resultado quedan en la base de log. Vea Registro y monitoreo.

Conexiones de entrada y de salida

ConexiónQuién la iniciaCuándo
EntradaEl socio se conecta al servicio de red de la instancia.Cuando el socio lo decida, dentro de las reglas del usuario.
SalidaRiversoft STCP Gemini Server se conecta al socio.Por agendamiento, en las fechas o intervalos definidos. Mediante el Riversoft Console Portal, el operador también puede ejecutar una agenda en el momento o iniciar una conexión de salida con un usuario. Vea Supervisión.
SupervisiónLa Riversoft STCP Gemini API se conecta al servicio Supervisión (gemini) de Riversoft STCP Gemini Server (puerto predeterminado 33050).Siempre que el Riversoft Console Portal acompaña u opera la instancia. Vea Servicios de supervisión.

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
  
DirectorioEn Riversoft STCP GeminiEn Riversoft STCP DirectLink
entradaArchivos recibidos del socio por OFTP.Archivos recibidos por carga en el portal o en la API y por los protocolos y conectores.
entrada/restartInformación de reanudación de las transferencias interrumpidas.Información de reanudación de las transferencias interrumpidas.
saidaArchivos por transmitir al socio.Archivos disponibles para descarga (área de descarga) y por transmitir por los conectores.
saida/backupArchivos ya transmitidos. Un archivo puede volver a saida para retransmitirse.Archivos ya descargados (área de backup).
saida/pendenteControl de EERP: confirmaciones de recepción pendientes de envío.—
saida/link—Archivos disponibles por enlace seguro para destinatarios externos.
controleArchivos de control de las transferencias, como EERP, NERP y locks.Archivos de control de las transferencias.
formato y tempDefiniciones de formato y archivos temporales.Definiciones de formato y archivos temporales.

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

Reglas aplicadas a cada transferencia

En cualquier dirección, la conexión y cada archivo se validan contra las reglas del usuario y de la instancia:

ReglaEfecto
Bloqueo del usuarioUn usuario bloqueado no intercambia archivos.
Autenticación y modo de conexiónLa sesión solo se acepta si las credenciales, el modo de autenticación y el modo de conexión corresponden a la configuración.
Límite de conexionesLimita las conexiones simultáneas del usuario.
Tiempo de sesiónCierra las sesiones que superan el tiempo máximo.
Límite de sesiones de la instanciaLimita el total de sesiones simultáneas de la instancia.
Filtros de archivoEl nombre y el tamaño del archivo deben cumplir los filtros del usuario.
Ventana horariaLas transferencias solo se aceptan en los días y horarios permitidos.

Cada rechazo queda registrado con el motivo. Vea Seguridad.

Enrutamiento y automatización

Riversoft STCP Gemini Server genera un evento en cada transferencia. Con Riversoft STCP Gemini Rename instalado, esos eventos activan las reglas de enrutamiento configuradas en el Riversoft Console Portal, que renombran, copian, mueven y distribuyen los archivos entre los buzones y otros directorios, sin intervención manual.

Registro y monitoreo

RecursoDescripción
Base de logCada sesión y cada transferencia quedan registradas con usuario, dirección, archivo, tamaño, tiempo, hash y resultado.
Eventos y mensajesCada ocurrencia genera un evento y un mensaje con código (MSGnnnn), en portugués, inglés y español. Vea Códigos.
Spool de contingenciaSi la base de log no está disponible, los eventos se graban en un archivo local de contingencia. Vea Spool de contingencia.
SupervisiónEl Riversoft Console Portal acompaña la instancia, los usuarios y los servicios, y puede iniciar agendas, detener y reiniciar la instancia y cambiar el nivel de debug. Vea Supervisión.

Conceptos clave

ConceptoDescripción
InstanciaConjunto de configuraciones ejecutado por un Riversoft STCP Gemini Server, identificado por ApplName. Se crea en el Riversoft Console Portal.
UsuarioSocio o sistema que intercambia archivos con la instancia. Cada usuario tiene un único buzón, que guarda los archivos y los datos de sus transferencias.
Servicio de redConfiguración de protocolo, dirección, puerto y seguridad usada en las conexiones.
AgendamientoEjecución de conexiones de salida o tareas en fechas o intervalos definidos. La agenda también puede ejecutarse en el momento mediante el Riversoft Console Portal.
Tipo de archivoReglas y tags aplicados a los archivos transferidos.
EERP y NERPConfirmación (EERP) o rechazo (NERP) de un archivo por el receptor, en el protocolo OFTP.
ReanudaciónContinuación de una transferencia interrumpida desde el punto en que se detuvo.
Evento y mensajeCada ocurrencia de la transferencia genera un evento y un mensaje con código (MSGnnnn).
Enrutamiento y reglaDefiniciones de Riversoft STCP Gemini Rename para renombrar, copiar, mover y distribuir archivos.

Otros términos están en el Glosario.