Referencia de parámetros
Riversoft STCP Gemini API
Archivo: /usr/local/stcpgemini-api/configs/config.json.
databases.config y databases.log
| Parámetro | Descripción |
|---|---|
type_database | Tipo de base de datos (p. ej., mysql). |
host | Dirección del servidor de base de datos. |
port | Puerto de la base de datos. |
user | Usuario de la base de datos. |
password | Contraseña de la base de datos. |
database_name | Nombre de la base de datos. |
Los campos type_database, host, user, password y database_name aceptan los prefijos env: y file:, para leer el valor de una variable de entorno o de un archivo, sin dejarlo en el config.json. Ejemplo: "password": "env:STCP_DB_PASSWORD".
general
| Parámetro | Descripción |
|---|---|
ssl | Habilita HTTPS/TLS en la API. Con true, exige cert y key válidos. |
host | Interfaz en la que escucha la API. 0.0.0.0 escucha en todas las interfaces. |
port | Puerto de la API (p. ej., 33070). |
cert | Certificado TLS, usado cuando ssl está habilitado. |
key | Clave privada del certificado. |
key_password | Contraseña de la clave privada, si la tiene. |
api_secret | Secreto usado para firmar y validar los tokens y proteger las contraseñas. Obligatorio: con el valor vacío, la API no se inicia. Dato sensible. Debe ser igual en los demás módulos del entorno. Vea Clave de cifrado de las contraseñas. |
templates_dir | Carpeta de plantillas personalizadas. |
rest_name | Nombre del registro de la API (API/Supervisión) en el Riversoft Console Portal. Al iniciar, la API carga el registro con este nombre; si no existe, la API no se inicia. |
database_maintenance | Intervalo, en segundos, de la rutina de mantenimiento de la base de datos. 0 la deshabilita. |
auth_type | Mecanismo de autenticación. Valor predeterminado: native (autenticación nativa de STCP). Para el inicio de sesión LDAP, el operador indica el usuario en el formato dominio/operador. |
webapp_dir | Directorio del Riversoft Console Portal servido en el modo -lite. Tiene prioridad sobre la opción -webapp. |
sso_login_redirect | URL de retorno después del inicio de sesión SSO. Si se omite, usa el valor del registro de la API. |
sso_logout_end_session | true también cierra la sesión en el proveedor de identidad al cerrar sesión. |
session_duration | Validez de los tokens emitidos, en minutos. Predeterminado 60; máximo 720 (12 horas). |
appl_serialnumber | Número de serie de la licencia. |
appl_license | Clave de la licencia. Dato sensible. |
Los campos host, port, cert, key y key_password no indicados en el config.json se leen del registro de la API en la base.
La API verifica el número de serie y la licencia al iniciar: si son inválidos, no se inicia. Cuando la licencia vence, la API se detiene. La situación de la licencia se puede consultar en GET /info/license.
El 2FA de los operadores se habilita en el registro de la API. La variable de entorno DIRLMFA, con cualquier valor, también habilita el 2FA, aunque esté deshabilitado en el registro.
Riversoft Console Portal
Archivo: /usr/local/stcpgemini-api/portal/app/configs/config.json.
| Parámetro | Descripción |
|---|---|
EntryPoint[].name | Nombre del entorno mostrado en el Portal. |
EntryPoint[].address | Dirección de la Riversoft STCP Gemini API, con el formato esquema://host:puerto (p. ej., https://portal.ejemplo.com:33070). |
defaultLanguage | Idioma predeterminado de la interfaz (p. ej., pt). |
Riversoft STCP Gemini Server
Archivo: /usr/local/stcp/configs/stcpserver.config.json.
STCPCore
| Parámetro | Descripción |
|---|---|
ApplName | Nombre de la instancia ejecutada, igual al registrado en el Portal. |
ApplDescription | Descripción de la instancia. |
ApplUser | Usuario del sistema operativo de la aplicación. |
ApplGroup | Grupo del sistema operativo de la aplicación. |
ApplDir | Directorio de la aplicación. |
ApplLockDir | Directorio de control de bloqueo. |
ApplPidFile | Archivo con el número del proceso (PID). |
ApplUmask | Máscara de permisos para crear archivos y directorios. |
ApplDaemon | Ejecución en modo daemon. Use siempre "0". |
ApplMsgFileName | Archivo de mensajes de la aplicación. |
ApplMsgLanguage | Idioma de los mensajes (p. ej., ptb). |
ApplConfigPassPhrase | Frase usada para cifrar las contraseñas. Dato sensible. Debe ser igual en los demás módulos del entorno. Vea Clave de cifrado de las contraseñas. |
ApplDebug | Nivel de depuración para el análisis de errores. |
ApplMaximunConsoleMsgs | Número máximo de mensajes mostrados en la consola. |
ApplMaximunAsyncProcesses | Número máximo de procesos simultáneos. |
STCPCfg
| Parámetro | Descripción |
|---|---|
DLLName | Biblioteca de acceso a la configuración, según el SGBD: libstcpcfgodbc.so (Microsoft SQL Server), libstcpcfgoracle.so (Oracle Database) o libstcpcfgmysql.so (MySQL y MariaDB). |
DBName | Nombre de la base de configuración. |
DBHost | Dirección del servidor de base de datos. |
DBPort | Puerto de la base de datos. |
DBUser | Usuario de la base de datos. |
DBPswd | Contraseña de la base de datos. |
MaxConfigTxt | Tamaño máximo, en bytes, del campo de configuración. |
MaxExtraTxt | Tamaño máximo, en bytes, del campo extra. |