Configuración

Visión general

Cada componente tiene su propio archivo de configuración. La configuración de Riversoft® STCP DirectLink y de los componentes de gestión se crea a partir de una plantilla instalada con el paquete:

Componente	Archivo	Plantilla
Riversoft STCP Gemini API	`/usr/local/stcpgemini-api/configs/config.json`	`example-config.json`
Riversoft Console Portal	`/usr/local/stcpgemini-api/portal/app/configs/config.json`	`example-config.json`
Riversoft STCP DirectLink	`/usr/local/stcpdirectlink/configs/config.json`	`example-config.json`
Riversoft STCP DirectLink Portal	`/usr/local/stcpdirectlink/static/portal/assets/configs/config.json`	`example-config.json`

Los parámetros de cada archivo se describen en la Referencia de parámetros.

Atención

Los archivos contienen contraseñas de base de datos, claves y secretos. Sustituya todos los valores de ejemplo, restrinja el acceso al usuario y al grupo del servicio y no versione archivos con secretos.

Clave de cifrado de las contraseñas

Las contraseñas y los demás datos sensibles guardados en la base de configuración (por ejemplo, las contraseñas de los usuarios, de las bases de datos y de las credenciales de supervisión) están cifrados. Todos los módulos que leen o graban esos datos deben usar la misma clave. De lo contrario, un módulo no puede leer las contraseñas guardadas por otro.

Módulo	Archivo	Parámetro
Riversoft STCP Gemini Server	`/usr/local/stcp/configs/stcpserver.config.json`	`ApplConfigPassPhrase` (sección `STCPCore`)
Riversoft STCP DirectLink	`configs/config.json` de la instalación	`applConfigPassPhrase`
Riversoft STCP Gemini Rename	`/usr/local/stcpren/configs/config.json`	`applConfigPassPhrase` (sección `General`)
Riversoft STCP Gemini API	`/usr/local/stcpgemini-api/configs/config.json`	`api_secret` (sección `general`)

    flowchart LR
    K[Misma clave] --> G[Gemini Server]
    K --> D[DirectLink]
    K --> R[Gemini Rename]
    K --> A[Gemini API]
    G --> DB[(Base de configuración<br/>contraseñas cifradas)]
    D --> DB
    R --> DB
    A --> DB

Importante

Defina la clave antes del primer registro y use el mismo valor en todos los módulos del entorno. Para cambiarla después, los datos sensibles ya guardados deben cifrarse de nuevo con la nueva clave, mediante un procedimiento realizado con una aplicación propia. Contacte al soporte de Riversoft antes de cambiar la clave.

Use un valor fuerte y aleatorio, guardado fuera del código.
En Riversoft STCP DirectLink, el parámetro acepta referencia a secreto (env:, file: o kms:). Prefiera leer el valor de una variable de entorno, de un archivo protegido o de un almacén de secretos.
En Riversoft STCP Gemini API, el api_secret también firma los tokens de acceso.
Guarde la clave en el backup seguro del entorno: sin ella, las contraseñas de una base restaurada no se pueden leer.

Orígenes de la configuración

Además de los archivos, Riversoft STCP DirectLink usa la configuración mantenida en la instancia:

Origen	Contenido
Archivo `config.json`	Configuración propia de Riversoft STCP DirectLink: secciones `General`, `Kms`, `Telemetry` y `Service`. Vea Riversoft STCP DirectLink.
Archivo `config.json` de Riversoft STCP DirectLink Portal	Dirección de la API, idioma, apariencia, funciones y botones de SSO del portal. Vea Riversoft STCP DirectLink Portal.
Base de configuración de la instancia	JWT, SSO y bloqueo externo, administrados en el Riversoft Console Portal. Vea Actualización y migración.
Configuración de la instancia	Usuarios, agendas, directorios, servicios (dirección, puerto y TLS), conectores y parámetros de la API, mantenidos en el Riversoft Console Portal o, en Windows, en Riversoft STCP Enterprise Server.

El config.json no sustituye la configuración de la instancia.

Riversoft STCP Gemini API

Archivo config.json de la Riversoft STCP Gemini API: servidor HTTP, TLS y bases de datos.

Riversoft Console Portal

Archivo config.json del Riversoft Console Portal: dirección de la API y varios entornos.

Riversoft STCP DirectLink

Archivo config.json de Riversoft STCP DirectLink: parámetros generales, notificaciones, Turnstile, bases de datos, secretos (KMS), telemetría y servicio.

Riversoft STCP DirectLink Portal

Archivo config.json de Riversoft STCP DirectLink Portal: dirección de la API, idioma, apariencia, funciones e inicio de sesión SSO.

Checklist de producción

El JSON se validó con jq empty.
La licencia existe, es válida y tiene permisos restringidos.
applDir y applLockDir existen y son escribibles por el usuario del servicio.
applSecret y applConfigPassPhrase se sustituyeron por los valores reales.
applConfigPassPhrase es igual en los demás módulos del entorno (Riversoft STCP Gemini Server, Riversoft STCP Gemini Rename y el api_secret de Riversoft STCP Gemini API). Vea Clave de cifrado de las contraseñas.
Las contraseñas y los tokens se sustituyeron por referencias a secretos.
Se probaron la base de configuración y la base de log.
La configuración de la instancia contiene los usuarios, agendas y directorios necesarios.
TLS, host de la API y certificados se configuraron en el servicio de la API.
Se probaron la carga, la descarga, los enlaces, las notificaciones y la recuperación de contraseña.
El backup y la retención se validaron antes de habilitar la eliminación automática.
La telemetría y los logs no exponen secretos.
Con turnstileEnable activo, la secret key está protegida y el servidor alcanza challenges.cloudflare.com.
El proceso se ejecutó en primer plano antes de instalarse como servicio.
El config.json de Riversoft STCP DirectLink Portal apunta url a la API del entorno y lista solo proveedores SSO configurados en la instancia.

Próximos pasos

Inicie los servicios: Operación.
Cree la instancia y cambie la contraseña del operador administrador (stcpadmin): Administración.