Variables de entorno

Variables de entorno de despliegue para Lerian SILOC: runtime, conectividad con la cola de liquidación SILOC, persistencia, autenticación y certificados.

Lerian SILOC es la integración de mensajería nativa de Lerian para SILOC, el sistema de liquidación diferida neta que Núclea opera para los flujos de boletos y tarjetas. Defines estas variables en el momento del despliegue. Un cambio surte efecto solo después de que reinicies el servicio. Para los ajustes que se comportan igual en todos los servicios Go de Lerian —postura de despliegue, telemetría y convenciones de almacenes de datos— consulta la referencia de configuración BYOC.

Lerian SILOC es un servicio en fase temprana. Esta página documenta la superficie de configuración verificada actual. Espera que crezca a medida que el rail madure. Por ejemplo, Lerian planea un plano de configuración en tiempo de ejecución de systemplane pero aún no lo expone. Trata la propia referencia de entorno del servicio como la fuente de verdad para una versión dada.

En las tablas siguientes, Requerida marca una variable que debes definir, de forma global o bajo la condición indicada. — significa que no hay valor por defecto.

​

Runtime y servidor

Variable	Descripción	Valor por defecto	Requerida
SERVICE_NAME	Identificador del servicio usado en los logs y la telemetría.	Valor por defecto del servicio	No
ENV_NAME	Etiqueta del entorno de runtime. production activa los controles de autenticación y TLS más estrictos de abajo.	development	No
DEPLOYMENT_MODE	Postura de imposición de TLS (local, byoc, saas). saas hace obligatorio el TLS y se niega a arrancar sin él. Consulta Modo de despliegue y TLS.	—	No
LOG_LEVEL	Verbosidad de los logs (debug, info, warn, error).	info	No
SERVER_PORT	Puerto de escucha HTTP. Las sondas de liveness y readiness se enlazan a este mismo puerto.	9820	No

​

Autenticación

Lerian SILOC autoriza las rutas protegidas a través de Access Manager. Funciona cerrado por defecto: la autenticación permanece activada salvo que la deshabilites.

Variable	Descripción	Valor por defecto	Requerida
AUTH_ENABLED	Exige autenticación de Access Manager en las rutas protegidas. Debe ser true en producción y SaaS.	true	En producción
AUTH_ADDRESS	Dirección del servicio Access Manager. Debe ser una URL https:// válida en producción y SaaS.	—	En producción

​

PostgreSQL

La réplica recurre al host primario cuando dejas DB_REPLICA_HOST vacío (valor por defecto de un solo nodo).

Variable	Descripción	Valor por defecto	Requerida
DB_HOST	Host de PostgreSQL.	—	Sí (en vivo)
DB_PORT	Puerto de PostgreSQL.	5432	No
DB_USER	Usuario de la base de datos.	—	Sí (en vivo)
DB_PASSWORD	Contraseña de la base de datos. Sensible: inyéctala en el momento del despliegue; nunca la guardes en el repositorio.	—	Sí (en vivo)
DB_NAME	Nombre de la base de datos.	—	Sí (en vivo)
DB_SSLMODE	Modo TLS de libpq. Usa require o más estricto en producción.	disable	No
DB_REPLICA_HOST	Host de réplica de lectura opcional. Recurre a DB_HOST cuando no se define.	—	No

​

Redis

Variable	Descripción	Valor por defecto	Requerida
REDIS_ADDRESS	Host y puerto de Redis/Valkey.	—	No
REDIS_PASSWORD	Contraseña de Redis. Sensible.	—	No
REDIS_DB	Número de base de datos de Redis.	0	No
REDIS_TLS	Define la postura TLS que informa la comprobación de readiness de Redis. No configura TLS para el transporte Redis.	false	No

​

Conectividad de liquidación SILOC

Lerian SILOC mantiene una única conexión IBM MQ al gestor de colas de liquidación SILOC de Núclea. Si defines MQ_HOST, MQ_CHANNEL, MQ_QUEUE_MANAGER, MQ_SEND_QUEUE o MQ_RECEIVE_QUEUE, el servicio valida todo el descriptor de conexión de forma cerrada al arrancar. MQ_PORT, MQ_TLS_ENABLED y MQ_SSL_KEY_REPOSITORY por sí solas no activan esa validación.

Variable	Descripción	Valor por defecto	Requerida
MQ_HOST	Host del gestor de colas.	—	Sí (SILOC en vivo)
MQ_PORT	Puerto de escucha del gestor de colas.	—	Sí (SILOC en vivo)
MQ_QUEUE_MANAGER	Nombre del gestor de colas. Debe ser el gestor de colas de liquidación SILOC de Núclea.	—	Sí (SILOC en vivo)
MQ_CHANNEL	Canal de conexión de servidor. Debe coincidir con el patrón de canal SILOC de Núclea C02992335.<ISPB>.1, donde <ISPB> es el ISPB de 8 dígitos del participante.	—	Sí (SILOC en vivo)
MQ_SEND_QUEUE	Cola de envío saliente.	—	Sí (SILOC en vivo)
MQ_RECEIVE_QUEUE	Cola de recepción entrante.	—	Sí (SILOC en vivo)
MQ_TLS_ENABLED	Habilita el TLS mutuo en el canal MQ. Debe ser true en producción.	false	En producción
MQ_SSL_KEY_REPOSITORY	Ruta al repositorio de claves GSKit (MQSSLKEYR) que respalda el TLS de MQ. La clave privada reside aquí, nunca en una variable de entorno. Requerida cuando MQ_TLS_ENABLED=true.	—	Si TLS está habilitado
CAMARA_PAG_ISPB	El ISPB de 8 dígitos de la câmara SILOC. Cada mensaje de liquidación entrante se autoriza contra este emisor antes de tener cualquier efecto semántico. Coincide con el prefijo del canal de liquidación, así que solo la sobrescribes para una câmara de prueba. Un valor que no sea de 8 dígitos impide el arranque.	02992335	No

​

Certificados

Variable	Descripción	Valor por defecto	Requerida
CERT_READINESS_MIN_DAYS	Umbral de días hasta la expiración que registra una advertencia para un certificado actualmente válido. No degrada el readiness solo porque el certificado esté próximo a expirar. Debe ser mayor que 0.	30	No

​

Confianza y custodia

Variable	Descripción	Valor por defecto	Requerida
SFN_TRUST_MANIFEST_PATH	Ruta al manifiesto de confianza SFN utilizado para validar el material de confianza de los mensajes regulados.	—	No
SFN_CUSTODY_CONFIG_PATH	Ruta a la configuración del proveedor de custodia.	—	No
SFN_CUSTODY_CACHE_ENTRIES	Número máximo de entradas de custodia conservadas en la caché en memoria.	16	No

​

Observabilidad

Variable	Descripción	Valor por defecto	Requerida
ENABLE_TELEMETRY	Habilita la instrumentación de OpenTelemetry.	false	No
OTEL_EXPORTER_OTLP_ENDPOINT	Endpoint del colector OTLP.	—	Si la telemetría está habilitada
STREAMING_BROKERS	Direcciones de broker para el dispatcher obligatorio de hechos SILOC. El streaming no tiene un modo deshabilitado: una configuración de broker ausente o inválida impide el inicio en lugar de dejar hechos como PENDING. Configura los ajustes compartidos STREAMING_* como se describe en Streaming y outbox.	—	Sí
LDL_FACT_CONSUMER_ENABLED	Habilita el consumidor de los hechos autoritativos de liquidación LDL de SPB. Cada hecho completa la instrucción SILOC que autoriza. Con true, STREAMING_BROKERS y el almacén PostgreSQL son obligatorios, y el servicio se niega a arrancar sin ellos. Deshabilitado, su comprobación de readiness informa skipped; en ejecución, la comprobación no bloquea el readiness.	false	No

​

Salud y readiness

Lerian SILOC expone GET /health (liveness), GET /readyz (readiness) y GET /version en el puerto HTTP principal. El servicio arranca y sirve estas sondas incluso antes de que sus almacenes de datos y la conexión de liquidación sean accesibles. /readyz informa la salud de cada dependencia. Consulta Salud y readiness para el contrato de las sondas.