Variáveis de ambiente

O Lerian SLC é o rail de liquidação de propriedade da Lerian que compensa e liquida sobre o SLC da Núclea através da RSFN. Você define essas variáveis no momento do deploy. Uma reinicialização do serviço as aplica. Todo serviço Go da Lerian compartilha um backbone universal — servidor, datastores, multi-tenancy, telemetria, autenticação de plugin e licenciamento. A referência de configuração BYOC documenta esse backbone uma única vez. Esta página cobre apenas as variáveis distintivas do Lerian SLC. Nas tabelas abaixo, a coluna Padrão / Obrigatória mostra o valor padrão. Um qualificador em negrito (ex: Obrigatória, Obrigatória em produção) marca uma variável que você deve definir. — significa que não há padrão. Uma variável marcada como Sensível carrega material de credencial ou de chave. Injete-a a partir do seu gerenciador de segredos no momento do deploy. Nunca faça commit de um valor.

Serviço e runtime

Variável	Padrão / Obrigatória	Descrição
`SERVER_ADDRESS`	`:4111`	Endereço de escuta HTTP principal. As probes de liveness, readiness, metrics e version se vinculam a essa mesma porta.
`SYSTEMPLANE_ENABLED`	`false`	Habilita a API de administração de configuração de runtime do Systemplane sob o prefixo `/system` na porta principal. Desligada por padrão (modo apenas variáveis de ambiente).
`TENANT_RUNTIME_CONFIG_ENABLED`	`false`	Habilita o store de configuração de runtime por tenant e sua superfície de administração, resolvendo o transporte de conectividade de cada tenant a partir de um registro por tenant em vez da configuração compartilhada. Apenas seleção e política.

O Lerian SLC expõe /health (liveness) e /readyz (readiness) na porta principal, além de /version e /metrics. Quando você habilita a multi-tenancy, ele também expõe GET /readyz/tenant/{id}. Consulte Saúde e prontidão para o contrato das probes.

Transporte REST da Núclea

Este canal submete à Núclea online sobre TLS mútuo. Deixe NUCLEA_REST_BASE_URL vazio para manter o transporte não conectado.

Variável	Padrão / Obrigatória	Descrição
`NUCLEA_REST_BASE_URL`	—	URL base do nó da Núclea. Vazio desabilita o submitter online. Em produção isso aponta para o endpoint da Núclea; localmente aponta para um simulador.
`NUCLEA_REST_TIMEOUT_SEC`	`30`	Timeout por requisição em segundos.
`NUCLEA_REST_CB_CONSECUTIVE_FAILURES`	`5`	Falhas consecutivas que abrem o circuit breaker.
`NUCLEA_REST_CB_OPEN_TIMEOUT_SEC`	`30`	Por quanto tempo o breaker permanece aberto antes de meio-aberto.
`NUCLEA_REST_ALLOW_INSECURE_TLS`	`false`	Relaxa a verificação de TLS da Núclea apenas para desenvolvimento local. O boot é rejeitado quando isso é `true` sob `ENV_NAME=production` ou `DEPLOYMENT_MODE=saas`.
`NUCLEA_REST_CLIENT_CERT_PATH`	Obrigatória em produção/SaaS	Caminho para o certificado de cliente PEM apresentado à Núclea para TLS mútuo.
`NUCLEA_REST_CLIENT_KEY_PATH`	Obrigatória em produção/SaaS	Caminho para a chave privada de cliente PEM para TLS mútuo. Sensível — o arquivo contém material de chave privada.

Consumidor de entrada da RSFN

Este canal recebe as mensagens RSFN de entrada. Ele também observa a conformidade XSD.

Variável	Padrão / Obrigatória	Descrição
`RSFN_CONSUMER_TRANSPORT`	`stub`	Transporte de entrada por trás da porta do consumidor da RSFN: `stub` (um canal REST de desenvolvimento) ou `mq` (o transporte de rede da RSFN, conectado na homologação).
`MQ_BRIDGE_URL`	Obrigatória se o transporte for `mq`	URL base da bridge MQ. Você deve declará-la explicitamente quando `RSFN_CONSUMER_TRANSPORT=mq`; ela não pode herdar `http://localhost:9121`, porque o endereço correto depende da topologia do seu deploy.
`RSFN_CONSUMER_BASE_URL`	—	URL base para o transporte `stub`. Vazio deixa o consumidor não conectado.
`RSFN_CONSUMER_TIMEOUT_SEC`	`30`	Timeout por requisição em segundos.
`CIRCUIT_BREAKER_ENABLED`	`false`	Habilita o gerenciador compartilhado de circuit breaker. O gerenciador protege mais do que este consumidor: o boot falha fechado quando o consumidor RSFN (`stub` ou `mq`), o canal REST da Núclea (`NUCLEA_REST_BASE_URL` definido) ou o caminho Connect:Direct está configurado sem ele.
`RSFN_CONSUMER_CB_CONSECUTIVE_FAILURES`	`5`	Falhas consecutivas que abrem o circuit breaker do consumidor RSFN quando `CIRCUIT_BREAKER_ENABLED=true`.
`RSFN_CONSUMER_CB_OPEN_TIMEOUT_SEC`	`30`	Por quanto tempo o breaker permanece aberto antes de meio-aberto.
`RSFN_CONSUMER_ALLOW_INSECURE_TLS`	`false`	Relaxa a verificação de TLS do canal stub apenas para desenvolvimento local. Forçado a `false` sob `ENV_NAME=production` ou `DEPLOYMENT_MODE=saas`.
`RSFN_INBOUND_XSD_VALIDATION_ENABLED`	`true`	Validação XSD apenas observação das mensagens RSFN/SILOC de entrada contra os schemas oficiais. Registra em log e mede a não-conformidade sem alterar o dispatch.
`ASLC_INBOUND_XSD_VALIDATION_ENABLED`	`true`	Validação XSD apenas observação das mensagens de retorno ASLC de entrada. Registra em log e mede a não-conformidade sem alterar o pipeline de retorno.
`XSD_VALIDATOR_URL`	`http://localhost:9091`	URL base do sidecar de validação XSD que os observadores chamam.
`XSD_VALIDATOR_TIMEOUT_SEC`	`10`	Timeout por requisição em segundos para chamadas de validação XSD.

Barramento de entrada SFN

O barramento SFN retransmite mensagens SILOC. Este caminho as ingere. Toda a família permanece inerte a menos que você defina SFN_INGEST_ENABLED=true.

Variável	Padrão / Obrigatória	Descrição
`SFN_INGEST_ENABLED`	`false`	Chave mestra para o caminho de ingestão SFN (consumidor do barramento e driver).
`SFN_BUS_PROVIDER`	`kafka`	Adaptador de consumidor: `kafka` ou `stub` (desenvolvimento/CI).
`SFN_KAFKA_BROKERS`	Obrigatória se ingest ligado e provider `kafka`	Lista de brokers de bootstrap Kafka/RedPanda separados por vírgula.
`SFN_KAFKA_TOPIC`	`siloc.inbound`	Tópico no qual o relay do SILOC publica.
`SFN_KAFKA_GROUP_ID`	padrão próprio do serviço	Id do consumer group do Kafka; sobrescreva por deployment quando necessário.
`SFN_KAFKA_BATCH_SIZE`	`100`	Registros lidos por batch.
`SFN_STUB_TIMEOUT_SEC`	`30`	Timeout por requisição em segundos para o adaptador `stub`.

Sidecar de assinatura

O Lerian SLC assina o envelope de segurança do SPB através de um sidecar de assinatura stateless. A chave privada nunca entra no processo do serviço. Você seleciona o backend de custódia por deployment.

Variável	Padrão / Obrigatória	Descrição
`SIGNER_URL`	`http://localhost:9101`	URL base do sidecar de assinatura.
`SIGNER_TIMEOUT_SEC`	`10`	Timeout por requisição em segundos para chamadas de assinatura.
`SIGNER_SOFTKEY_PFX_PASSPHRASE`	—	Passphrase para o adaptador de custódia de chave em software. Sensível. A postura de chave em software é recusada sob `ENV_NAME=production` a menos que explicitamente permitida.
`SIGNER_SOFTKEY_ALLOW_IN_PRODUCTION`	`false`	Permite a postura de chave em software in-process em produção. Mantenha `false` — um caminho de custódia por hardware ou cloud-KMS é a postura de produção.
`SIGNER_AWSKMS_DEFAULT_KEY_REF`	—	Referência de chave de fallback opcional para o adaptador de custódia cloud-KMS, usada apenas quando uma requisição não fornece nenhuma. O material de chave nunca entra no processo — apenas a referência é passada. O adaptador cloud-KMS precisa da `SIGNER_AWSKMS_REGION`, a região AWS da chave KMS, que o deployment padrão deriva do `AWS_REGION` compartilhado.

Agenda de liquidação

O Lerian SLC controla o dispatch para as janelas de liquidação da Núclea e roda um worker de agenda por tenant.

Variável	Padrão / Obrigatória	Descrição
`SCHEDULE_CREDIT_WINDOW_OPEN`	Obrigatória em todos os ambientes	Abertura da janela de aceitação de crédito, como `HH:MM` no horário local de São Paulo (intervalo semiaberto, limite de abertura inclusivo). Declare-a explicitamente para a grade vigente.
`SCHEDULE_CREDIT_WINDOW_CLOSE`	Obrigatória em todos os ambientes	Fechamento da janela de aceitação de crédito, como `HH:MM` no horário local de São Paulo (exclusivo). Declare-a explicitamente para a grade vigente.
`SCHEDULE_WORKER_ENABLED`	`true`	Habilita o worker de agenda recorrente por tenant (alertas de cutoff e, quando habilitados, os drivers de dispatch e de retorno).
`SCHEDULE_WORKER_INTERVAL_SEC`	`30`	Período de tick do worker de agenda em segundos.
`SCHEDULE_GRID_GATE_ENABLED`	`false`	Controla o dispatch pela grade STR apoiada em calendário em vez da janela única de crédito.
`SCHEDULE_CUTOFF_ALERT_LEAD_MIN`	`30`	Minutos antes de um cutoff STR em que a janela entra em pré-cutoff e um alerta é emitido.
`SCHEDULE_DISPATCH_MAX_TRANSMIT_ATTEMPTS`	`20`	Tentativas de transmissão que um dispatch pode consumir antes de a operação ser estacionada para revisão do operador em vez de retentar para sempre. No tick padrão de 30 segundos, 20 tentativas são cerca de dez minutos antes do primeiro alerta.
`SCHEDULE_HOLIDAYS`	—	Feriados bancários `YYYY-MM-DD` separados por vírgula no horário local de São Paulo; a grade nunca abre uma janela em um feriado.

Você deve declarar as duas variáveis da janela de crédito, mesmo quando usar a agenda padrão. O serviço recusa o boot se algum valor for omitido ou ficar vazio; ele nunca assume uma grade de crédito a partir de um valor padrão.

O Lerian SLC entrega uma família de toggles de runtime por driver. Cada toggle habilita um fluxo no worker de agenda: dispatch e forward de crédito e débito, antecipação, cancelamento, relay de status, confirmação D+1 e alertas de operação travada. Cada um é um switch SCHEDULE_*_ENABLED que assume false por padrão. Você habilita cada um durante a homologação, assim que o material da Núclea por tenant está pronto. A cadência e os parâmetros de batch seguem o padrão *_INTERVAL_SEC / *_BATCH_SIZE / *_PAGE_SIZE.

Webhooks

O Lerian SLC pode entregar eventos de liquidação a um endpoint assinante. No BYOC o cliente fornece o material de credencial através do seu próprio secret do Kubernetes.

Variável	Padrão / Obrigatória	Descrição
`WEBHOOK_WORKER_ENABLED`	`false`	Habilita o worker de entrega de webhooks por tenant.
`WEBHOOK_DELIVERY_PROVIDER`	`direct`	Adaptador de entrega: `direct` (HTTP HMAC do BYOC) ou `notifications` (SaaS).
`WEBHOOK_API_KEY`	Obrigatória se houver entrega	Chave de API definida pelo cliente enviada no header de API-key do webhook. Sensível.
`WEBHOOK_API_KEY_FILE`	—	Caminho para um arquivo que contém a chave de API (um volume de secret montado). Quando definido, o valor inline é ignorado.
`WEBHOOK_HMAC_SECRET`	Obrigatória se houver entrega	Segredo compartilhado definido pelo cliente usado para assinar cada webhook. Sensível. Nunca vem do plano de configuração de runtime nem do banco de dados.
`WEBHOOK_HMAC_SECRET_FILE`	—	Caminho para um arquivo que contém o segredo HMAC (um volume de secret montado). Quando definido, o valor inline é ignorado.
`WEBHOOK_MAX_ATTEMPTS`	`6`	Orçamento de retries por assinatura antes de uma entrega ser estacionada na dead-letter queue.
`WEBHOOK_ALLOW_PRIVATE_NETWORK`	`false`	Relaxamento apenas para desenvolvimento do bloqueio SSRF da entrega. Deve permanecer `false` em produção/SaaS — caso contrário o boot falha fechado.
`WEBHOOK_NOTIFICATIONS_BASE_URL`	Obrigatória se provider `notifications`	URL base do serviço de notifications usado pelo provider SaaS.

​Serviço e runtime

​Transporte REST da Núclea

​Consumidor de entrada da RSFN

​Barramento de entrada SFN

​Sidecar de assinatura

​Agenda de liquidação

​Webhooks

Serviço e runtime

Transporte REST da Núclea

Consumidor de entrada da RSFN

Barramento de entrada SFN

Sidecar de assinatura

Agenda de liquidação

Webhooks