Variables de entorno

Lerian SLC es el riel propiedad de Lerian para la mensajería de liquidación de tarjetas con el SLC de Núclea. Configuras estas variables en tiempo de despliegue. Un reinicio del servicio las aplica. Todo servicio Go de Lerian comparte una base común: servidor, almacenes de datos, telemetría y autenticación de plugins. Fundamentos de configuración de BYOC documenta esa base común una sola vez. Esta página cubre las variables propias de Lerian SLC. En las tablas siguientes, la columna Predeterminado / Obligatorio muestra el valor predeterminado. Un calificador en negrita (p. ej. Obligatorio, Obligatorio en producción) marca una variable que debes configurar. — significa que no hay valor predeterminado. Una variable marcada como Sensible lleva material de credenciales o claves. Inyéctala desde tu gestor de secretos en tiempo de despliegue. Nunca hagas commit de un valor.

Servicio y runtime

Variable	Predeterminado / Obligatorio	Descripción
`SERVER_ADDRESS`	`:4111`	Dirección de escucha HTTP principal. Los probes 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. Desactivado de forma predeterminada (modo de 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, y resuelve el transporte de conectividad de cada tenant a partir de 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. Consulta Salud y readiness para conocer el contrato del probe. Una instalación atiende a una institución.

Licencia

Variable	Predeterminado / Obligatorio	Descripción
`LICENSE_KEY`	Obligatorio	Credencial de licencia emitida por Lerian. Sensible.
`ORGANIZATION_IDS`	Obligatorio	Ámbito de organización que cubre la licencia.

Recepción de operaciones

Variable	Predeterminado / Obligatorio	Descripción
`INTAKE_BATCH_MAX_LINES`	`50000`	Límite de líneas de la recepción por lotes. Un lote que lo supera responde `413` y no guarda nada.
`INTAKE_BATCH_SPOOL_MAX_BYTES`	`268435456`	Límite de bytes de la recepción por lotes. Un lote que lo supera responde `413` y no guarda nada.
`INTAKE_BATCH_SPOOL_DIR`	directorio temporal del sistema	Directorio donde la recepción por lotes almacena temporalmente el cuerpo mientras cuenta las líneas. Apúntalo a un volumen con permiso de escritura cuando el sistema de archivos raíz es de solo lectura.

Transporte REST de Núclea

Este canal envía a Núclea en línea mediante TLS mutuo. Deja NUCLEA_REST_BASE_URL vacío para mantener el transporte sin conectar.

Variable	Predeterminado / Obligatorio	Descripción
`NUCLEA_REST_BASE_URL`	—	URL base del nodo de Núclea. Vacío desactiva todo el transporte REST: el envío en línea, el sondeo de retornos, las consultas y el envío de archivos. Bajo `ENV_NAME=production` o `DEPLOYMENT_MODE=saas`, la URL debe usar `https`. Localmente apunta a un simulador.
`NUCLEA_REST_TIMEOUT_SEC`	`30`	Timeout por solicitud, 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 este valor es `true` bajo `ENV_NAME=production` o `DEPLOYMENT_MODE=saas`.
`NUCLEA_REST_RESPONSE_CERT_PATH`	Obligatorio a menos que la URL base sea un destino de desarrollo	Ruta al certificado público de Núclea, que verifica la firma de cada respuesta. El arranque falla cuando está vacía y la URL base apunta a cualquier otro destino.
`NUCLEA_REST_CLIENT_CERT_PATH`	Obligatorio en producción/SaaS cuando la URL base está configurada	Ruta al certificado de cliente PEM que se presenta a Núclea para el TLS mutuo.
`NUCLEA_REST_CLIENT_KEY_PATH`	Obligatorio en producción/SaaS cuando la URL base está configurada	Ruta a la clave privada de cliente PEM para el TLS mutuo. Sensible. El archivo lleva material de clave privada.

Consumidor entrante de RSFN

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

Variable	Predeterminado / Obligatorio	Descripción
`RSFN_CONSUMER_TRANSPORT`	`stub`	Transporte entrante detrás del puerto del consumidor de RSFN: `stub` (un canal REST de desarrollo) o `mq` (el transporte de red de RSFN a través del bridge de MQ). Otro valor hace que se rechace el arranque. El consumidor solo drena mensajes cuando `SCHEDULE_RSFN_INGEST_ENABLED=true`.
`MQ_BRIDGE_URL`	Obligatorio cuando se usa el transporte MQ	URL base del bridge de MQ. Debes declararla explícitamente con `RSFN_CONSUMER_TRANSPORT=mq`, o con la selección de transporte por tenant activada; no puede heredar `http://localhost:9121`, porque la dirección correcta depende de la topología de tu despliegue.
`MQ_BRIDGE_QUEUE_MANAGER`, `MQ_BRIDGE_CHANNEL`, `MQ_BRIDGE_CONN_NAME`, `MQ_BRIDGE_QUEUE`	Obligatorio cuando se usa el transporte MQ	Datos de conexión de IBM MQ que el transporte MQ entrega al bridge. Con una cola en blanco, cada drenaje falla de forma cerrada.
`RSFN_CONSUMER_BASE_URL`	—	URL base para el transporte `stub`. Vacío deja el consumidor sin conectar.
`RSFN_CONSUMER_TIMEOUT_SEC`	`30`	Timeout por solicitud, en segundos.
`CIRCUIT_BREAKER_ENABLED`	`false`	Habilita el gestor de circuit breaker compartido. El gestor protege más que a este consumidor: sin él, el arranque falla de forma cerrada cuando el canal `stub` tiene una URL base, cuando se usa el transporte MQ o cuando `NUCLEA_REST_BASE_URL` está configurado.
`RSFN_CONSUMER_CB_CONSECUTIVE_FAILURES`	`5`	Fallos consecutivos que abren el breaker del consumidor de RSFN cuando `CIRCUIT_BREAKER_ENABLED=true`.
`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. En producción o SaaS, el canal stub siempre verifica el TLS.
`RSFN_INBOUND_XSD_VALIDATION_ENABLED`	`true`	Validación XSD de solo observación de los mensajes entrantes de RSFN/SILOC 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 retorno entrantes de ASLC. Registra y mide la no conformidad sin alterar el pipeline de retorno.
`RSFN_INBOUND_XSD_FAIL_CLOSED_CODMSGS`	—	Tipos de mensaje de la RSFN y de Lerian SILOC, separados por comas, que salen del modo de solo observación: un fallo de XSD envía el mensaje a la cola dead-letter. Un tipo de mensaje que el servicio no enruta hace que se rechace el arranque.
`ASLC_INBOUND_XSD_FAIL_CLOSED_CODMSGS`	—	Tipos de retorno ASLC, separados por comas, que salen del modo de solo observación: un fallo de XSD deja el retorno sin confirmar para el próximo sondeo. Un tipo de retorno que el servicio no enruta hace que se rechace el arranque.
`XSD_VALIDATOR_URL`	`http://localhost:9091`	URL base del sidecar de validación XSD. Los observadores entrantes lo llaman, y también lo llama la construcción de archivos salientes, que falla de forma cerrada cuando el sidecar no responde.
`XSD_VALIDATOR_TIMEOUT_SEC`	`10`	Timeout por solicitud, en segundos, para las llamadas de validación XSD.

Bus entrante de SFN

Lerian SILOC retransmite sus mensajes a Lerian SLC en el bus de SFN. SFN_INGEST_ENABLED activa la ingesta de los mensajes retransmitidos. SFN_FACTS_INGEST_ENABLED activa la ingesta de los resultados de los comandos de liquidación que envía Lerian SLC. Ambos consumidores usan los mismos brokers y el mismo tamaño de lote.

Variable	Predeterminado / Obligatorio	Descripción
`SFN_INGEST_ENABLED`	`false`	Interruptor maestro de la ruta de ingesta de SFN (consumidor del bus y driver).
`SFN_BUS_PROVIDER`	`kafka`	Adaptador de consumidor: `kafka` o `stub` (desarrollo/CI).
`SFN_KAFKA_BROKERS`	Obligatorio si la ingesta está activada con el proveedor `kafka`, o si la ingesta de resultados está activada	Lista de brokers bootstrap de Kafka/RedPanda separados por comas.
`SFN_KAFKA_TOPIC`	`siloc.inbound`	Tema en el que publica el relay de SILOC.
`SFN_KAFKA_GROUP_ID`	predeterminado propio del servicio	Id del grupo de consumidores de Kafka; anúlalo por despliegue cuando lo necesites.
`SFN_KAFKA_BATCH_SIZE`	`100`	Registros leídos por lote.
`SFN_STUB_TIMEOUT_SEC`	`30`	Timeout por solicitud, en segundos, para el adaptador `stub`.
`SFN_FACTS_INGEST_ENABLED`	`false`	Interruptor maestro del consumidor de los resultados de los comandos de liquidación.
`SFN_FACTS_KAFKA_TOPIC`	`siloc.outbound.facts`	Tema en el que Lerian SILOC publica los resultados de los comandos.
`SFN_FACTS_KAFKA_GROUP_ID`	predeterminado propio del servicio	Id del grupo de consumidores de Kafka del consumidor de resultados, distinto de `SFN_KAFKA_GROUP_ID`.

Streaming

Lerian SLC y la librería de streaming de Lerian leen la familia STREAMING_. Lerian Streaming Hub entrega los eventos publicados.

Variable	Predeterminado / Obligatorio	Descripción
`STREAMING_ENABLED`	`false`	Interruptor maestro del productor de streaming. El productor publica eventos de negocio y entrega los comandos LBTR a Lerian SILOC. También necesita `OUTBOX_ENABLED=true`.
`STREAMING_BROKERS`	Obligatorio cuando el streaming está habilitado	Lista de arranque de brokers separada por comas. Una configuración habilitada con una lista vacía rechaza el arranque.
`STREAMING_CLOUDEVENTS_SOURCE`	Obligatorio cuando el streaming está habilitado	Fuente de CloudEvents de este servicio. Configúrala con el valor de `publisher.source` del manifiesto de eventos que devuelve `GET /v1/streaming/manifest`. El servicio sirve el manifiesto con el streaming desactivado. Un valor vacío o malformado rechaza el arranque cuando el streaming está habilitado.
`STREAMING_CLIENT_ID`	`primary`	Identificador de cliente del broker usado para diagnósticos del lado del broker.
`STREAMING_CLOSE_TIMEOUT_S`	`30`	Ventana máxima de drenaje y vaciado, en segundos, cuando el productor se cierra.
`STREAMING_TOPIC_AUTO_PROVISION`	`true`	Con el streaming habilitado, crea el topic de eventos `lerian.streaming.<source>` y el topic de dead-letter `lerian.streaming.<source>.dlq` cuando no existen en el arranque. `<source>` es el valor de `STREAMING_CLOUDEVENTS_SOURCE`. Una creación rechazada o fallida registra una advertencia, y el arranque continúa. Configúralo en `false` cuando aprovisionas los topics tú mismo.
`STREAMING_TOPIC_PARTITIONS`	Predeterminado del broker	Número de particiones de los topics que crea el servicio. Un valor sin configurar, cero o no válido usa el predeterminado del broker.
`STREAMING_TOPIC_REPLICATION_FACTOR`	Predeterminado del broker	Factor de replicación de los topics que crea el servicio. Un valor sin configurar, cero o no válido usa el predeterminado del broker.
`STREAMING_HEALTH_CHECK_TIMEOUT`	`2s`	Tiempo límite de la comprobación de streaming en la sonda de readiness.

Sidecar de firma

Lerian SLC firma el envelope de seguridad de SPB mediante un sidecar de firma sin estado. La clave privada de firma nunca entra al proceso del servicio. El registro de custodia activo de cada participante selecciona el adaptador de custodia y la clave que firman sus mensajes. El sidecar activa cada adaptador de custodia solo cuando están presentes los ajustes propios de ese adaptador.

Variable	Predeterminado / Obligatorio	Descripción
`SIGNING_CUSTODY_ADAPTER`	`softkey`	Adaptador de custodia que la verificación de arranque espera en el sidecar de firma: `softkey`, `pkcs11` o `awskms`. No selecciona la custodia de cada participante. Bajo `DEPLOYMENT_MODE=saas` siempre es `awskms`, y Lerian SLC rechaza un registro de custodia que apunta a otro adaptador.
`SIGNER_URL`	`http://localhost:9101`	URL base del sidecar de firma.
`SIGNER_TIMEOUT_SEC`	`10`	Timeout por solicitud, en segundos, para las llamadas de firma.
`SIGNER_SOFTKEY_PFX_PATH`	—	Ruta al archivo PKCS#12 del adaptador de clave de software. Configurarla activa el adaptador.
`SIGNER_SOFTKEY_PFX_PASSPHRASE`	—	Passphrase para el adaptador de custodia de clave de software. Sensible.
`SIGNER_SOFTKEY_ALLOW_IN_PRODUCTION`	`false`	Bajo `ENV_NAME=production`, el sidecar de firma arranca solo cuando este valor es `true`, sea cual sea el adaptador de custodia que uses.
`SIGNER_AWSKMS_REGION`	—	Región de AWS de las claves de KMS. Configurarla activa el adaptador de cloud KMS y la importación de claves de firma.
`SIGNER_PKCS11_MODULE`	predeterminado de la imagen	Ruta al módulo PKCS#11 del HSM.
`SIGNER_PKCS11_TOKEN_LABEL` o `SIGNER_PKCS11_SLOT`	—	Token del HSM, por etiqueta o por slot. Configurar uno activa el adaptador de HSM, que entonces exige el módulo, el PIN y la etiqueta de la clave.
`SIGNER_PKCS11_PIN`	Obligatorio con un token de HSM	PIN del token de HSM. Sensible.
`SIGNER_PKCS11_KEY_LABEL`	Obligatorio con un token de HSM	Etiqueta de la clave de firma dentro del token.

Calendario de liquidación

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

Variable	Predeterminado / Obligatorio	Descripción
`SCHEDULE_CREDIT_WINDOW_OPEN`	Obligatorio en todos los entornos	Apertura de la ventana de aceptación de crédito, como `HH:MM` hora local de São Paulo (intervalo semiabierto, el límite de apertura es inclusivo). Declárala explícitamente para la grade vigente.
`SCHEDULE_CREDIT_WINDOW_CLOSE`	Obligatorio en todos los entornos	Cierre de la ventana de aceptación de crédito, como `HH:MM` hora local de São Paulo (exclusivo). Declárala explícitamente para la grade vigente. `HH:MM+1` cruza la medianoche, y solo la grade `especial1` lo acepta.
`SCHEDULE_SPECIAL_GRADE`	`none`	Grade de Núclea que la ventana de crédito debe respetar: `none`, `especial1` o `especial2`. Otro valor hace que se rechace el arranque. Bajo `ENV_NAME=production` o `DEPLOYMENT_MODE=saas`, la ventana de crédito debe ajustarse a la grade.
`SCHEDULE_WORKER_ENABLED`	`true`	Habilita el worker de calendario recurrente (alertas de cutoff y, cuando están habilitados, los drivers de despacho y retorno).
`SCHEDULE_WORKER_INTERVAL_SEC`	`30`	Período del tick del worker de calendario, en segundos.
`SCHEDULE_GRID_GATE_ENABLED`	`false`	Condiciona el despacho a la grilla del STR respaldada por calendario en lugar de la única ventana de crédito.
`SCHEDULE_CUTOFF_ALERT_LEAD_MIN`	`30`	Minutos antes de un cutoff del STR en los que la ventana entra en pre-cutoff y se emite una alerta.
`SCHEDULE_DISPATCH_MAX_TRANSMIT_ATTEMPTS`	`20`	Rechazos consecutivos de la contraparte que un envío saliente puede recibir antes de que Lerian SLC retenga la operación para revisión del operador. Un fallo de transporte no cuenta, y un éxito reinicia el conteo. Con el tick predeterminado de 30 segundos, 20 rechazos 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; ninguna ventana abre en un feriado. Una fecha mal formada hace que se rechace el arranque.

Debes declarar ambas variables de ventana de crédito, incluso cuando uses la grade ordinaria. El servicio se rehúsa a arrancar si falta o está en blanco alguno de los valores. Nunca asume una grade de crédito a partir de un valor predeterminado.

Cada flujo se ejecuta en el worker de calendario solo cuando su toggle es true. Cada toggle es false de forma predeterminada: SCHEDULE_DISPATCH_ENABLED, SCHEDULE_FORWARD_ENABLED, SCHEDULE_DEBIT_DISPATCH_ENABLED, SCHEDULE_DEBIT_FORWARD_ENABLED, SCHEDULE_ANTICIPATION_DISPATCH_ENABLED, SCHEDULE_ANTICIPATION_FORWARD_ENABLED, SCHEDULE_ANTICIPATION_SETTLE_ENABLED, SCHEDULE_CANCELLATION_DISPATCH_ENABLED, SCHEDULE_CANCELLATION_FORWARD_ENABLED, SCHEDULE_RETURN_POLL_ENABLED, SCHEDULE_RELAY_STATUS_ENABLED, SCHEDULE_VARREDURA_ENABLED, SCHEDULE_RSFN_INGEST_ENABLED, SCHEDULE_D1_CONFIRMATION_ENABLED, SCHEDULE_CONFIRMATION_OVERDUE_ENABLED, SCHEDULE_OPERATION_STUCK_ENABLED, SCHEDULE_CERT_EXPIRY_ENABLED, SCHEDULE_SILOC_WINDOWS_ENABLED, SCHEDULE_STR_SETTLED_ENABLED y OP107_VERDICT_POLL_ENABLED.

Webhooks

Lerian SLC puede entregar eventos de liquidación a un endpoint suscriptor. En BYOC, el cliente aporta el material de credenciales mediante su propio secret de Kubernetes.

Variable	Predeterminado / Obligatorio	Descripción
`WEBHOOK_WORKER_ENABLED`	`false`	Habilita el worker de entrega de webhooks.
`WEBHOOK_DELIVERY_PROVIDER`	`direct`	Adaptador de entrega. `direct` entrega cada webhook por HTTP con una firma HMAC.
`WEBHOOK_API_KEY`	Obligatorio si se entrega	API key definida por el cliente, enviada en el header de API key del webhook. Sensible.
`WEBHOOK_API_KEY_FILE`	—	Ruta a un archivo que contiene la API key (un volumen de secret montado). Cuando está configurada, se ignora el valor en línea.
`WEBHOOK_HMAC_SECRET`	Obligatorio si se 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 secret montado). Cuando está configurada, se ignora el valor en línea.
`WEBHOOK_MAX_ATTEMPTS`	`6`	Presupuesto de reintentos por suscripción antes de que una entrega quede retenida en la cola dead-letter.
`WEBHOOK_ALLOW_PRIVATE_NETWORK`	`false`	Relajación solo para desarrollo del bloqueo SSRF de entrega. Debe permanecer en `false` en producción/SaaS. De lo contrario, el arranque falla de forma cerrada.

​Servicio y runtime

​Licencia

​Recepción de operaciones

​Transporte REST de Núclea

​Consumidor entrante de RSFN

​Bus entrante de SFN

​Streaming

​Sidecar de firma

​Calendario de liquidación

​Webhooks

Servicio y runtime

Licencia

Recepción de operaciones

Transporte REST de Núclea

Consumidor entrante de RSFN

Bus entrante de SFN

Streaming

Sidecar de firma

Calendario de liquidación

Webhooks