Referencia de parámetros
Esta página reúne los parámetros del archivo config.json de Riversoft® STCP DirectLink, con tipo y valor predeterminado. El uso de cada grupo se describe en Configuración.
Nota
El config.json se lee al iniciar. Después de cambiar cualquier parámetro, reinicie el servicio. En la columna Predeterminado, “—” indica que no hay valor predeterminado.
Transferencia y enlaces
Detalles: Configuración › Transferencia y enlaces.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
downloadEnable | booleano | — | Habilita la descarga. |
downloadExpireDays | entero | 1 | Vigencia del enlace de descarga, en días. 0 usa 24 horas. |
downloadPinExpireSeconds | entero | 180 | Vigencia del PIN de descarga. Los valores de hasta 60 usan 180 segundos; los mayores se ajustan a múltiplos de 60. |
uploadEnable | booleano | — | Habilita la carga. |
uploadMaxFileSize | entero | — | Tamaño máximo aceptado en la carga, en bytes. |
uploadValidateJSON | booleano | — | Habilita la validación de JSON en el flujo de carga. |
secureLinkPinMaxLen | entero | 6 | Longitud máxima del PIN de enlace seguro. Un valor menor o igual a cero usa 6. |
secureLinkPinExpireSeconds | entero | 180 | Vigencia del PIN de enlace seguro. Los valores de hasta 60 usan 180 segundos. |
reportMaxLines | entero | 100 | Líneas por página del informe. Los valores menores o iguales a cero o mayores que 1000 usan 100. |
Correo electrónico
Detalles: Configuración › Correo electrónico.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
emailEnable | booleano | — | Habilita las notificaciones por correo electrónico. |
emailServerAddress | texto | — | Host del servidor SMTP. |
emailServerPort | entero | — | Puerto SMTP, por ejemplo 587. |
emailAuthUser | texto | — | Usuario SMTP. |
emailAuthPswd | texto | — | Contraseña SMTP o referencia a secreto. |
emailAuthType | texto | — | Tipo de autenticación aceptado por el proveedor. |
emailTemplatesPath | texto | obligatorio con emailEnable | Directorio de las plantillas de correo. Obligatorio cuando emailEnable es true. |
emailSendFrom | texto | — | Remitente de los mensajes. |
emailReplyTo | texto | — | Dirección del encabezado Reply-To. |
emailFormatMimeFrom | texto | — | Formato del encabezado From. |
emailSendConfirmationEnable | booleano | — | Envía una confirmación después de la transferencia. |
emailSendConfirmationToSenderEnable | booleano | — | Envía la confirmación también al remitente. |
emailSendRetryMaximum | entero | — | Número máximo de intentos de envío. |
emailSendRetryWaitSeconds | entero | — | Intervalo entre intentos, en segundos. |
emailCheckValidMXDisable | booleano | — | Deshabilita la verificación del registro MX del dominio del destinatario. |
emailProvider | texto | vacío | Proveedor de envío de correo. Vacío usa SMTP, el único proveedor admitido. |
SMS y WhatsApp
Detalles: Configuración › SMS y WhatsApp.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
smsEnable | booleano | — | Habilita las notificaciones por SMS o WhatsApp. |
smsSendConfirmationEnable | booleano | — | Envía la confirmación de la transferencia. |
smsTemplatesPath | texto | obligatorio con smsEnable | Directorio de las plantillas. Obligatorio cuando el recurso está habilitado. |
smsProvider | texto | — | Proveedor, por ejemplo whatsapp. |
smsEndpoint | texto | — | Endpoint HTTP del proveedor. |
smsAuthUser | texto | — | Identificador de autenticación en el proveedor. |
smsAuthPswd | texto | — | Secreto del proveedor o referencia a secreto. |
smsSender | texto | — | Identificador del remitente, como el ID de WhatsApp Business. |
smsSendConfirmationToSenderEnable | booleano | — | Envía al remitente, por SMS, la confirmación de que el destinatario descargó el archivo. |
Enrutamiento y distribución
Detalles: Configuración › Enrutamiento y distribución.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
routeEnable | booleano | — | Habilita el enrutamiento de archivos. |
routeTableCSVFile | texto | — | Archivo CSV que relaciona origen, destino y destinatarios. |
routeCSVDelimiter | texto | — | Separador del CSV, normalmente ;. |
routeScanTimerMs | entero | — | Intervalo de barrido, en milisegundos. |
routeScanSplitFilenameRegex | texto | — | Expresión regular que separa origen y nombre del archivo (grupos origin y filename). |
routeExternalCmdEnable | booleano | — | Habilita un comando externo en el enrutamiento. |
routeExternalCmd | texto | — | Comando externo, con ruta absoluta. |
routeExternalCmdParams | texto | — | Parámetros del comando externo. |
routePath | lista de textos | — | Directorios adicionales examinados por el enrutamiento. |
routeCopyFileEnable | booleano | — | Copia el archivo a routeCopyPath. |
routeCopyPath | texto | — | Plantilla de la ruta de copia; acepta marcadores como <destination> y <filename>. |
routeDirectLinkEnable | booleano | — | Genera un enlace de Riversoft STCP DirectLink para el archivo enrutado. |
routeDirectLinkTableIndex | texto | — | Columna usada para localizar la ruta, por ejemplo destination. |
routeDirectLinkUrl | texto | — | URL base de la API de Riversoft STCP DirectLink. |
routeMoveFileEnable | booleano | — | Mueve el archivo a routeMovePath después del procesamiento. |
routeMovePath | texto | — | Plantilla de la ruta de backup; acepta <origin>, <filename> y <unixtime>. |
routeRemoveFile | booleano | — | Elimina el archivo original después del procesamiento. |
Acortador de URL
Detalles: Configuración › Acortador de URL.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
urlShortnerEnable | booleano | — | Habilita el acortamiento de URL. |
urlShortnerProvider | texto | — | Proveedor, por ejemplo bitly. |
urlShortnerEndpoint | texto | — | Endpoint de la API del proveedor. |
urlShortnerToken | texto | — | Token del proveedor o referencia a secreto. |
Cloudflare Turnstile
Detalles: Configuración › Cloudflare Turnstile.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
turnstileEnable | booleano | — | Exige el token Turnstile. Con false, el header se ignora. |
turnstileSecretKey | texto | obligatorio con turnstileEnable | Secret key del widget o referencia a secreto. Obligatoria cuando turnstileEnable es true; sin ella, el servicio no se inicia. |
turnstileEndpoint | texto | https://challenges.cloudflare.com/turnstile/v0/siteverify | Endpoint de validación. Cámbielo solo para un proxy de salida o pruebas. |
turnstileTimeoutSeconds | entero | 10 | Tiempo máximo de la validación. Los valores menores o iguales a 0 usan el predeterminado. |
Base de configuración de STCP
Detalles: Configuración › Base de configuración de STCP.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
cfgProvider | texto | — | stcpgeminidb para la base de Riversoft STCP Gemini Server o stcpwindows para la configuración de Riversoft STCP Enterprise Server. |
cfgInstanceName | texto | — | Nombre de la instancia STCP. |
cfgDbName | texto | — | Nombre de la base o ruta, según el proveedor. Acepta opciones de conexión, como las de TLS (vea Requisitos). |
cfgDbHost | texto | — | Host de la base de datos. |
cfgDbPort | entero | — | Puerto de la base de datos. |
cfgDbUser | texto | — | Usuario de la base de datos. |
cfgDbPswd | texto | — | Contraseña o referencia a secreto. |
cfgDbType | texto | — | Tipo de base de datos, por ejemplo mysql. |
cfgDbOptions | texto | — | Opciones adicionales añadidas al nombre de la base. |
Base de log
Detalles: Configuración › Base de log.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
logDbEnable | booleano | — | Habilita la grabación de logs en base de datos. |
logDbWindows | booleano | — | Usa el mecanismo de log de Windows, cuando corresponde. |
logDbType | texto | — | Tipo de la base de log. |
logDbHost | texto | — | Host de la base de log. |
logDbPort | entero | — | Puerto de la base de log. |
logDbUser | texto | — | Usuario de la base de log. |
logDbPswd | texto | — | Contraseña o referencia a secreto. |
logDbName | texto | — | Nombre de la base de log. |
Aplicación y seguridad
Detalles: Configuración › Aplicación y seguridad.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
applLicense | texto | obligatorio | Ruta del archivo de licencia. El archivo debe existir. |
applDir | texto | obligatorio | Directorio absoluto de la instalación. Debe existir. |
applLockDir | texto | — | Directorio de bloqueos. Debe existir y ser escribible por el usuario del servicio. |
applPidFile | texto | obligatorio | Ruta del archivo PID. |
applConfigPassPhrase | texto | — | Frase usada en la protección de valores de la configuración. Acepta referencia a secreto. Debe ser igual en los demás módulos del entorno. Vea Clave de cifrado de las contraseñas. |
applSecret | texto | — | Secreto usado en la protección de los enlaces. Use un valor fuerte, estable y privado. |
applUser | texto | stcp | Usuario de ejecución del servicio. Predeterminado: stcp. |
applGroup | texto | stcp | Grupo de ejecución del servicio. Predeterminado: stcp. |
applDebug | entero | — | Nivel de depuración. |
applUmask | texto | 0022 | Umask de los archivos creados. Predeterminado: 0022. |
applDebugPath | texto | — | Directorio de los archivos de debug. La opción -debugPath de la línea de comandos tiene prioridad. |
license | texto | — | Nombre antiguo de applLicense, aceptado por compatibilidad. Use applLicense. |
Telemetría
Detalles: Configuración › Telemetría.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
enable_traces, enable_logs, enable_metrics | booleano | — | Habilitan la exportación de trazas, logs y métricas. |
provider_type | texto | — | Tipo de exporter, por ejemplo otlphttp. |
provider_host | texto | — | Host y puerto del collector. |
provider_file_path | texto | — | Archivo usado por exporters basados en archivo. |
resource_mode | texto | — | Estrategia de creación de los recursos. |
service_namespace, service_env | texto | — | Namespace y entorno del servicio (por ejemplo, prod). |
connect_timeout, export_timeout | entero | — | Timeouts de conexión y de exportación. |
tls_enabled | booleano | — | Habilita TLS para el exporter. |
tls_min_version, tls_max_version | texto | — | Límites de versión TLS. |
tls_public_key_cert_file, tls_private_key_file, tls_private_key_file_pswd | texto | — | Certificado, clave privada y contraseña del cliente, cuando se exigen. |
tls_ca_file | texto | — | CA de confianza. |
tls_ciphers | texto | — | Cifrados permitidos. |
tls_verify_certs | booleano | — | Valida los certificados. Manténgalo en true en producción. |
Servicio
Detalles: Configuración › Servicio.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
serviceName | texto | — | Nombre interno usado por el gestor de servicios. |
serviceDescription | texto | — | Descripción del servicio. |
serviceDisplayedName | texto | — | Nombre de visualización del servicio. |
Proveedor de secretos (Kms)
Detalles: Configuración › KMS y secretos.
| Parámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
kmsEnable | booleano | — | Habilita el proveedor de secretos. |
kmsType | texto | — | Tipo de proveedor: aws:secretmanager, azure:keyvault, gcp:secretmanager u oci:keyvault. |
kmsName | texto | — | Nombre descriptivo del proveedor. |
kmsRegion | texto | — | Región del servicio (AWS y OCI). |
kmsEndpoint | texto | — | Dirección del almacén (Azure y OCI). |
kmsTenant | texto | — | Tenant (Azure) o tenancy (OCI). |
kmsVaultId | texto | — | Identificador del almacén (OCI). |
kmsClientId | texto | — | Identificador del cliente o de la cuenta de servicio. |
kmsClientSecret | texto | — | Secreto del cliente, cuando no se usa la identidad de la carga de trabajo. |
kmsClientPrivateKey | texto | — | Clave privada del cliente (OCI). |
kmsClientPrivateKeyPswd | texto | — | Contraseña de la clave privada del cliente (OCI). |
kmsClientFingerprint | texto | — | Fingerprint de la clave del cliente (OCI). |
KmsClientAccessToken | texto | — | Token de acceso del cliente (GCP). |
kmsConfigFile | texto | — | Archivo de credenciales (GCP). |
Riversoft STCP DirectLink Portal
Los parámetros del archivo de configuración de Riversoft STCP DirectLink Portal están en Configuración › Riversoft STCP DirectLink Portal.