Configuración

Visión general

Cada componente tiene su propio archivo de configuración, creado 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 Gemini Server	`/usr/local/stcp/configs/stcpserver.config.json`	`example-stcpserver.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.

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 Gemini Server

Archivo stcpserver.config.json de Riversoft STCP Gemini Server: instancia, base de configuración y biblioteca de acceso.

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.

Próximos pasos

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