Variables de entorno

Variables de entorno de despliegue distintivas de Lerian SLC: transporte Núclea/RSFN, el bus entrante SFN, el sidecar de firma y el calendario de liquidación.

Lerian SLC es el rail de liquidación propiedad de Lerian que compensa y liquida sobre el SLC de Núclea a través de la RSFN. Defines estas variables en el momento del despliegue. Un reinicio del servicio las aplica. Cada servicio Go de Lerian comparte un backbone universal — servidor, almacenes de datos, multi-tenancy, telemetría, autenticación de plugins y licenciamiento. La referencia de configuración BYOC documenta ese backbone una sola vez. Esta página cubre solo las variables distintivas de Lerian SLC.

En las tablas siguientes, la columna Valor por defecto / Requerida muestra el valor por defecto. Un calificador en negrita (por ejemplo Requerida, Requerida en producción) marca una variable que debes definir. — significa que no hay valor por defecto. Una variable marcada como Sensible contiene material de credenciales o claves. Inyéctala desde tu gestor de secretos en el momento del despliegue. Nunca guardes un valor en el repositorio.

​

Servicio y runtime

Variable	Valor por defecto / Requerida	Descripción
SERVER_ADDRESS	:4111	Dirección de escucha HTTP principal. Las sondas de liveness, readiness, métricas y versión se enlazan a este mismo puerto.
SYSTEMPLANE_ENABLED	false	Habilita la API de administración de configuración en tiempo de ejecución de Systemplane bajo el prefijo /system en el puerto principal. Desactivada por defecto (modo solo variables de entorno).
TENANT_RUNTIME_CONFIG_ENABLED	false	Habilita el almacén de configuración en tiempo de ejecución por tenant y su superficie de administración, resolviendo el transporte de conectividad de cada tenant desde un registro por tenant en lugar de la configuración compartida. Solo selección y política.

Lerian SLC expone /health (liveness) y /readyz (readiness) en el puerto principal, además de /version y /metrics. Cuando habilitas la multi-tenancy, también expone GET /readyz/tenant/{id}. Consulta Salud y readiness para el contrato de las sondas.

​

Transporte REST de Núclea

Este canal envía a Núclea en línea a través de TLS mutuo. Deja NUCLEA_REST_BASE_URL vacío para mantener el transporte sin cablear.

Variable	Valor por defecto / Requerida	Descripción
NUCLEA_REST_BASE_URL	—	URL base del nodo de Núclea. Vacío desactiva el emisor en línea. En producción apunta al endpoint de Núclea; localmente apunta a un simulador.
NUCLEA_REST_TIMEOUT_SEC	30	Tiempo de espera por petición en segundos.
NUCLEA_REST_CB_CONSECUTIVE_FAILURES	5	Fallos consecutivos que abren el circuit breaker.
NUCLEA_REST_CB_OPEN_TIMEOUT_SEC	30	Cuánto tiempo permanece abierto el breaker antes de pasar a semiabierto.
NUCLEA_REST_ALLOW_INSECURE_TLS	false	Relaja la verificación TLS de Núclea solo para desarrollo local. El arranque se rechaza cuando esto es true bajo ENV_NAME=production o DEPLOYMENT_MODE=saas.
NUCLEA_REST_CLIENT_CERT_PATH	Requerida en producción/SaaS	Ruta al certificado de cliente PEM presentado a Núclea para el TLS mutuo.
NUCLEA_REST_CLIENT_KEY_PATH	Requerida en producción/SaaS	Ruta a la clave privada de cliente PEM para el TLS mutuo. Sensible: el archivo contiene material de clave privada.

​

Consumidor entrante RSFN

Este canal recibe los mensajes RSFN entrantes. También observa la conformidad XSD.

Variable	Valor por defecto / Requerida	Descripción
RSFN_CONSUMER_TRANSPORT	stub	Transporte entrante detrás del puerto del consumidor RSFN: stub (un canal REST de desarrollo) o mq (el transporte de red RSFN, cableado en homologación).
MQ_BRIDGE_URL	Requerida si el transporte es mq	URL base del puente MQ. Debes declararla explícitamente cuando RSFN_CONSUMER_TRANSPORT=mq; no puede heredar http://localhost:9121, porque la dirección correcta depende de tu topología de despliegue.
RSFN_CONSUMER_BASE_URL	—	URL base para el transporte stub. Vacío deja el consumidor sin cablear.
RSFN_CONSUMER_TIMEOUT_SEC	30	Tiempo de espera por petición en segundos.
RSFN_CONSUMER_CB_CONSECUTIVE_FAILURES	5	Fallos consecutivos que abren el circuit breaker.
RSFN_CONSUMER_CB_OPEN_TIMEOUT_SEC	30	Cuánto tiempo permanece abierto el breaker antes de pasar a semiabierto.
RSFN_CONSUMER_ALLOW_INSECURE_TLS	false	Relaja la verificación TLS del canal stub solo para desarrollo local. Forzada a false bajo ENV_NAME=production o DEPLOYMENT_MODE=saas.
RSFN_INBOUND_XSD_VALIDATION_ENABLED	true	Validación XSD de solo observación de los mensajes RSFN/SILOC entrantes contra los esquemas oficiales. Registra y mide la no conformidad sin alterar el despacho.
ASLC_INBOUND_XSD_VALIDATION_ENABLED	true	Validación XSD de solo observación de los mensajes de devolución ASLC entrantes. Registra y mide la no conformidad sin alterar la vía de devolución.
XSD_VALIDATOR_URL	http://localhost:9091	URL base del sidecar de validación XSD al que llaman los observadores.
XSD_VALIDATOR_TIMEOUT_SEC	10	Tiempo de espera por petición en segundos para las llamadas de validación XSD.

​

Bus entrante SFN

El bus SFN retransmite los mensajes SILOC. Esta vía los ingiere. Toda la familia permanece inerte salvo que definas SFN_INGEST_ENABLED=true.

Variable	Valor por defecto / Requerida	Descripción
SFN_INGEST_ENABLED	false	Interruptor maestro de la vía de ingesta SFN (consumidor del bus y driver).
SFN_BUS_PROVIDER	kafka	Adaptador de consumidor: kafka o stub (desarrollo/CI).
SFN_KAFKA_BROKERS	Requerida si la ingesta está activada y el proveedor es kafka	Lista de brokers de arranque Kafka/RedPanda separada por comas.
SFN_KAFKA_TOPIC	siloc.inbound	Topic al que publica el relay de SILOC.
SFN_KAFKA_GROUP_ID	valor por defecto propio del servicio	Id del grupo de consumidores de Kafka; sobrescríbelo por despliegue cuando haga falta.
SFN_KAFKA_BATCH_SIZE	100	Registros leídos por lote.
SFN_STUB_TIMEOUT_SEC	30	Tiempo de espera por petición en segundos para el adaptador stub.

​

Sidecar de firma

Lerian SLC firma el sobre de seguridad SPB a través de un sidecar de firma sin estado. La clave privada nunca entra en el proceso del servicio. Seleccionas el backend de custodia por despliegue.

Variable	Valor por defecto / Requerida	Descripción
SIGNER_URL	http://localhost:9101	URL base del sidecar de firma.
SIGNER_TIMEOUT_SEC	10	Tiempo de espera por petición en segundos para las llamadas de firma.
SIGNER_SOFTKEY_PFX_PASSPHRASE	—	Frase de contraseña para el adaptador de custodia de clave por software. Sensible. La postura de clave por software se rechaza bajo ENV_NAME=production salvo que se permita de forma explícita.
SIGNER_SOFTKEY_ALLOW_IN_PRODUCTION	false	Permite la postura de clave por software en proceso en producción. Déjala en false: una vía de custodia por hardware o KMS en la nube es la postura de producción.
SIGNER_AWSKMS_DEFAULT_KEY_REF	—	Referencia de clave de reserva opcional para el adaptador de custodia por KMS en la nube, usada solo cuando una petición no aporta ninguna. El material de clave nunca entra en el proceso: solo se pasa la referencia. El adaptador de KMS en la nube necesita SIGNER_AWSKMS_REGION, la región AWS de la clave KMS, que el despliegue estándar deriva del AWS_REGION compartido.

​

Calendario de liquidación

Lerian SLC controla el despacho a las ventanas de liquidación de Núclea y ejecuta un worker de calendario por tenant.

Variable	Valor por defecto / Requerida	Descripción
SCHEDULE_CREDIT_WINDOW_OPEN	Requerida en todos los entornos	Apertura de la ventana de aceptación de créditos, como hora local de São Paulo HH:MM (intervalo semiabierto, límite de apertura inclusivo). Declárala explícitamente para la malla vigente.
SCHEDULE_CREDIT_WINDOW_CLOSE	Requerida en todos los entornos	Cierre de la ventana de aceptación de créditos, como hora local de São Paulo HH:MM (exclusivo). Declárala explícitamente para la malla vigente.
SCHEDULE_WORKER_ENABLED	true	Habilita el worker de calendario recurrente por tenant (alertas de corte y, cuando están habilitados, los drivers de despacho y devolución).
SCHEDULE_WORKER_INTERVAL_SEC	30	Período de tick del worker de calendario en segundos.
SCHEDULE_GRID_GATE_ENABLED	false	Controla el despacho según la malla STR respaldada por calendario en lugar de la única ventana de crédito.
SCHEDULE_CUTOFF_ALERT_LEAD_MIN	30	Minutos antes de un corte STR en los que la ventana entra en pre-corte y se emite una alerta.
SCHEDULE_DISPATCH_MAX_TRANSMIT_ATTEMPTS	20	Intentos de transmisión que un envío puede consumir antes de que la operación quede aparcada para revisión del operador en lugar de reintentar para siempre. Con el tick por defecto de 30 segundos, 20 intentos son unos diez minutos antes de la primera alerta.
SCHEDULE_HOLIDAYS	—	Feriados bancarios YYYY-MM-DD separados por comas en hora local de São Paulo; la malla nunca abre una ventana en un feriado.

Debes declarar las dos variables de la ventana de crédito, incluso si usas el calendario estándar. El servicio rechaza el arranque si omites algún valor o lo dejas vacío; nunca asume una ventana de crédito a partir de un valor por defecto.

Lerian SLC incluye una familia de conmutadores de runtime por driver. Cada conmutador suscribe un flujo al worker de calendario: despacho y reenvío de crédito y débito, anticipación, cancelación, retransmisión de estado, confirmación D+1 y alertas de operaciones atascadas. Cada uno es un conmutador SCHEDULE_*_ENABLED que por defecto es false. Suscribes cada uno durante la homologación, una vez que el material de Núclea por tenant está listo. La cadencia y los ajustes de lote siguen el patrón *_INTERVAL_SEC / *_BATCH_SIZE / *_PAGE_SIZE.

​

Webhooks

Lerian SLC puede entregar eventos de liquidación a un endpoint suscriptor. En BYOC el cliente aporta el material de credenciales a través de su propio secreto de Kubernetes.

Variable	Valor por defecto / Requerida	Descripción
WEBHOOK_WORKER_ENABLED	false	Habilita el worker de entrega de webhooks por tenant.
WEBHOOK_DELIVERY_PROVIDER	direct	Adaptador de entrega: direct (HTTP con HMAC en BYOC) o notifications (SaaS).
WEBHOOK_API_KEY	Requerida si hay entrega	Clave de API definida por el cliente enviada en el encabezado de clave de API del webhook. Sensible.
WEBHOOK_API_KEY_FILE	—	Ruta a un archivo que contiene la clave de API (un volumen de secreto montado). Cuando se define, se ignora el valor en línea.
WEBHOOK_HMAC_SECRET	Requerida si hay entrega	Secreto compartido definido por el cliente usado para firmar cada webhook. Sensible. Nunca proviene del plano de configuración en tiempo de ejecución ni de la base de datos.
WEBHOOK_HMAC_SECRET_FILE	—	Ruta a un archivo que contiene el secreto HMAC (un volumen de secreto montado). Cuando se define, se ignora el valor en línea.
WEBHOOK_MAX_ATTEMPTS	6	Presupuesto de reintentos por suscripción antes de aparcar una entrega en la cola de mensajes muertos.
WEBHOOK_ALLOW_PRIVATE_NETWORK	false	Relajación solo de desarrollo del bloqueo SSRF de entrega. Debe permanecer en false en producción/SaaS: de lo contrario el arranque falla de forma cerrada.
WEBHOOK_NOTIFICATIONS_BASE_URL	Requerida si el proveedor es notifications	URL base del servicio de notificaciones usado por el proveedor SaaS.