Requisitos

Antes de instalar Riversoft® STCP DirectLink, confirme que el entorno cumple los requisitos de software, sistema operativo, base de datos y red.

Requisitos de software

Elemento	Obligatorio	Observación
Licencia de Riversoft STCP DirectLink	Sí	Archivo indicado en `applLicense`.
Base de configuración de la plataforma STCP	Sí	Accesible desde el servidor de la aplicación.
Base de log	No	Necesaria cuando `logDbEnable` es `true`.
Certificado TLS del servicio de la API	Sí, en producción	El portal y la API deben publicarse por HTTPS; la cookie de sesión exige `Secure`.
Proveedor de secretos (KMS)	No	AWS Secrets Manager, Azure Key Vault, GCP Secret Manager u OCI Vault. Vea KMS y secretos.
Collector OpenTelemetry	No	Necesario cuando la telemetría está habilitada.

Matriz de compatibilidad

Los sistemas operativos y las bases de datos siguientes valen para Riversoft STCP Gemini y para Riversoft STCP DirectLink.

Sistemas operativos compatibles

Sistema operativo	Versiones compatibles
Red Hat Enterprise Linux (RHEL)	8.x, 9.x y 10.x
Oracle Linux	8.x, 9.x y 10.x
Rocky Linux	8.x, 9.x y 10.x
AlmaLinux	8.x, 9.x y 10.x
Amazon Linux	Amazon Linux 2023
Otras distribuciones Linux	Sujeto a validación de compatibilidad

Consejo

Use la versión más reciente de cada versión principal compatible y mantenga el sistema actualizado con las correcciones de seguridad del fabricante.

Bases de datos compatibles

SGBD	Versión compatible
Microsoft SQL Server	2019 o superior
Oracle Database	19c o superior
MySQL	8.4 LTS o superior
MariaDB	10.11 o superior

Nota

Con Riversoft STCP Enterprise Server (Windows), se aplican los requisitos de sistema operativo de Enterprise Server.

Conexión con TLS (MySQL y MariaDB)

Con MySQL y MariaDB, la comunicación con la base de configuración y con la base de log puede protegerse con TLS mediante opciones incluidas en la propia cadena de conexión (cfgDbName), con el formato:

nombre-de-la-base?parametro1=valor1&parametro2=valor2

Las opciones las interpreta la capa de configuración de la plataforma STCP y también se aplican a la base de log cuando usa la misma forma de conexión.

Parámetro	Descripción	Valores
`tls`	Habilita TLS y define el nivel de verificación.	`true`, `skip-verify`, `verify-ca`, `verify-identity`
`tls-ca`	Archivo con el certificado de la CA.	Ruta del archivo
`tls-capath`	Directorio con los certificados de la CA (solo Riversoft STCP Gemini Server).	Ruta del directorio
`tls-cert`	Certificado local para autenticación mTLS.	Ruta del archivo
`tls-key`	Clave local para autenticación mTLS.	Ruta del archivo
`tls-cipher`	Cifrados permitidos, con la nomenclatura de OpenSSL, separados por `:`.	Vea la lista más abajo
`tls-min-version`	Versión mínima de TLS.	`TLSv1.2`, `TLSv1.3`
`tls-max-version`	Versión máxima de TLS.	`TLSv1.2`, `TLSv1.3`
`tls-server-name`	Nombre del servidor usado en la validación del certificado.	Hostname

Valor de `tls`	Verificación
`true`	CA y hostname del servidor.
`verify-identity`	CA y hostname del servidor.
`verify-ca`	Solo CA.
`skip-verify`	Ninguna. Úselo solo en laboratorio.

Cifrados aceptados en tls-cipher, separados por : (por ejemplo, tls-cipher=ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384): AES128-SHA, AES256-SHA, AES128-SHA256, AES128-GCM-SHA256, AES256-GCM-SHA384, ECDHE-RSA-AES128-SHA, ECDHE-RSA-AES256-SHA, ECDHE-RSA-AES128-SHA256, ECDHE-RSA-AES128-GCM-SHA256, ECDHE-RSA-AES256-GCM-SHA384, ECDHE-ECDSA-AES128-SHA, ECDHE-ECDSA-AES256-SHA, ECDHE-ECDSA-AES128-GCM-SHA256, ECDHE-ECDSA-AES256-GCM-SHA384, ECDHE-RSA-CHACHA20-POLY1305 y ECDHE-ECDSA-CHACHA20-POLY1305.

"cfgProvider": "stcpgeminidb",
"cfgInstanceName": "MiInstancia",
"cfgDbName": "stcpcfg?tls=verify-identity&tls-ca=/ruta/ca.pem&tls-server-name=db.ejemplo.com"

Atención

tls=skip-verify no valida la CA ni la identidad del servidor. En producción, use verify-identity con una CA de confianza y el hostname correspondiente al certificado.

Requisitos de red

Origen	Destino	Protocolo	Finalidad
Usuarios y sistemas	Servicio de la API de Riversoft STCP DirectLink	HTTPS	Riversoft STCP DirectLink Portal y API REST. El host usado debe ser exactamente el configurado para la API.
Socios	Servicios SFTP, AS2 y Webhook de Riversoft STCP DirectLink	SSH/SFTP, HTTPS	Recepción de archivos, cuando los servicios están habilitados.
Riversoft STCP Gemini API	Riversoft STCP DirectLink, servicio Supervisión (directlink) (puerto predeterminado `33060`)	TCP, con TLS opcional	Supervisión mediante el Riversoft Console Portal. Vea Servicios de supervisión.
Servidor de la aplicación	Base de configuración y base de log	MySQL/MariaDB, con TLS recomendado	Configuración y logs.
Servidor de la aplicación	Servidor SMTP y proveedores de SMS/WhatsApp	SMTP, HTTPS	Notificaciones y envío de PIN.
Servidor de la aplicación	`challenges.cloudflare.com`	HTTPS	Validación de Cloudflare Turnstile, cuando está habilitado.
Servidor de la aplicación	Proveedores de identidad (SSO) y KMS	HTTPS	SSO y resolución de secretos, cuando están configurados.
Servidor de la aplicación	Socios y almacenamiento en la nube	Según el conector	Envío de archivos por SFTP, FTP/FTPS, AS2, Webhook, Amazon S3, Azure Blob Storage, Google Cloud Storage y Oracle Cloud Object Storage.
Servidor de la aplicación	Collector OpenTelemetry	HTTP/HTTPS	Telemetría, cuando está habilitada.

Los puertos de los servicios se definen en los servicios de red de la instancia, en el Riversoft Console Portal. Libérelos en el firewall antes de iniciar la instalación.

Checklist previo a la instalación

Instancia de Riversoft STCP Gemini Server o Riversoft STCP Enterprise Server disponible.
Base de configuración accesible desde el servidor de la aplicación, con TLS configurado.
Archivo de licencia disponible.
Certificado TLS del servicio de la API disponible.
Puertos de los servicios liberados y salidas de red necesarias permitidas.
Secretos disponibles en el proveedor de secretos adoptado por el entorno.

Conceptos y arquitectura Instalación