Variáveis de ambiente

O Lerian SILOC é a integração de mensageria nativa da Lerian para o SILOC, o sistema de liquidação diferida líquida que a Núclea opera para os fluxos de boletos e cartões. Você define essas variáveis no momento do deploy. Uma mudança entra em vigor apenas depois que você reinicia o serviço. Para os parâmetros que se comportam da mesma forma em todos os serviços Go da Lerian — postura de deployment, telemetria e convenções de datastore — consulte a referência de configuração BYOC.

O Lerian SILOC é um serviço em estágio inicial. Esta página documenta a superfície de configuração atual verificada. Espere que ela cresça à medida que o rail amadurece. Por exemplo, a Lerian planeja um plano de configuração de runtime do systemplane mas ainda não o expõe. Trate a própria referência de ambiente do serviço como a fonte da verdade para uma dada release.

Nas tabelas abaixo, Obrigatória marca uma variável que você deve definir, globalmente ou sob a condição indicada. — significa que não há padrão.

Runtime e servidor

Variável	Descrição	Padrão	Obrigatória
`SERVICE_NAME`	Identificador de serviço usado em logs e telemetria.	Padrão do serviço	Não
`ENV_NAME`	Rótulo do ambiente de runtime. `production` arma os controles mais estritos de autenticação e TLS abaixo.	`development`	Não
`DEPLOYMENT_MODE`	Postura de enforcement de TLS (`local`, `byoc`, `saas`). `saas` torna o TLS obrigatório e se recusa a iniciar sem ele. Consulte Modo de deployment e TLS.	—	Não
`LOG_LEVEL`	Verbosidade dos logs (`debug`, `info`, `warn`, `error`).	`info`	Não
`SERVER_PORT`	Porta de escuta HTTP. As probes de liveness e readiness se vinculam a essa mesma porta.	`9820`	Não

Autenticação

O Lerian SILOC autoriza rotas protegidas através do Access Manager. Ele funciona default-closed: a autenticação permanece ligada a menos que você a desabilite.

Variável	Descrição	Padrão	Obrigatória
`AUTH_ENABLED`	Exige autenticação via Access Manager em rotas protegidas. Deve ser `true` em produção e SaaS.	`true`	Em produção
`AUTH_ADDRESS`	Endereço do serviço Access Manager. Deve ser uma URL `https://` válida em produção e SaaS.	—	Em produção

PostgreSQL

A réplica usa o host primário como fallback quando você deixa DB_REPLICA_HOST vazio (padrão single-node).

Variável	Descrição	Padrão	Obrigatória
`DB_HOST`	Host do PostgreSQL.	—	Sim (real)
`DB_PORT`	Porta do PostgreSQL.	`5432`	Não
`DB_USER`	Usuário do banco de dados.	—	Sim (real)
`DB_PASSWORD`	Senha do banco de dados. Sensível — injete no momento do deploy; nunca faça commit.	—	Sim (real)
`DB_NAME`	Nome do banco de dados.	—	Sim (real)
`DB_SSLMODE`	Modo TLS do libpq. Use `require` ou mais forte em produção.	`disable`	Não
`DB_REPLICA_HOST`	Host de réplica de leitura opcional. Usa `DB_HOST` como fallback quando não definido.	—	Não

Redis

Variável	Descrição	Padrão	Obrigatória
`REDIS_ADDRESS`	Host e porta do Redis/Valkey.	—	Não
`REDIS_PASSWORD`	Senha do Redis. Sensível.	—	Não
`REDIS_DB`	Número do banco de dados Redis.	`0`	Não
`REDIS_TLS`	Define a postura de TLS informada pelo check de prontidão do Redis. Ela não configura TLS para o transporte Redis.	`false`	Não

Conectividade de liquidação do SILOC

O Lerian SILOC mantém uma única conexão IBM MQ com o queue manager de liquidação do SILOC da Núclea. Definir MQ_HOST, MQ_CHANNEL, MQ_QUEUE_MANAGER, MQ_SEND_QUEUE ou MQ_RECEIVE_QUEUE faz o serviço validar todo o descritor de conexão fail-closed na inicialização. MQ_PORT, MQ_TLS_ENABLED e MQ_SSL_KEY_REPOSITORY sozinhas não ativam essa validação.

Variável	Descrição	Padrão	Obrigatória
`MQ_HOST`	Host do queue manager.	—	Sim (SILOC real)
`MQ_PORT`	Porta do listener do queue manager.	—	Sim (SILOC real)
`MQ_QUEUE_MANAGER`	Nome do queue manager. Deve ser o queue manager de liquidação do SILOC da Núclea.	—	Sim (SILOC real)
`MQ_CHANNEL`	Canal de server-connection. Deve corresponder ao padrão de canal do SILOC da Núclea `C02992335.<ISPB>.1`, onde `<ISPB>` é o ISPB de 8 dígitos do participante.	—	Sim (SILOC real)
`MQ_SEND_QUEUE`	Fila de envio de saída.	—	Sim (SILOC real)
`MQ_RECEIVE_QUEUE`	Fila de recebimento de entrada.	—	Sim (SILOC real)
`MQ_TLS_ENABLED`	Habilita TLS mútuo no canal MQ. Deve ser `true` em produção.	`false`	Em produção
`MQ_SSL_KEY_REPOSITORY`	Caminho para o repositório de chaves GSKit (`MQSSLKEYR`) que dá suporte ao TLS do MQ. A chave privada fica aqui, nunca em uma variável de ambiente. Obrigatório quando `MQ_TLS_ENABLED=true`.	—	Se TLS habilitado
`CAMARA_PAG_ISPB`	O ISPB de 8 dígitos da câmara SILOC. Toda mensagem de liquidação recebida é autorizada contra esse emissor antes de ter qualquer efeito semântico. Ele casa com o prefixo do canal de liquidação, então você só o sobrescreve para uma câmara de teste. Um valor que não tenha 8 dígitos impede a subida.	`02992335`	Não

Certificados

Variável	Descrição	Padrão	Obrigatória
`CERT_READINESS_MIN_DAYS`	Limiar de dias até o vencimento que registra um aviso para um certificado válido no momento. Ele não degrada a prontidão apenas porque o certificado está próximo do vencimento. Deve ser maior que 0.	`30`	Não

Confiança e custódia

Variável	Descrição	Padrão	Obrigatória
`SFN_TRUST_MANIFEST_PATH`	Caminho para o manifesto de confiança SFN usado para validar o material de confiança de mensagens reguladas.	—	Não
`SFN_CUSTODY_CONFIG_PATH`	Caminho para a configuração do provedor de custódia.	—	Não
`SFN_CUSTODY_CACHE_ENTRIES`	Número máximo de entradas de custódia mantidas no cache em memória.	`16`	Não

Observabilidade

Variável	Descrição	Padrão	Obrigatória
`ENABLE_TELEMETRY`	Habilita a instrumentação OpenTelemetry.	`false`	Não
`OTEL_EXPORTER_OTLP_ENDPOINT`	Endpoint do coletor OTLP.	—	Se telemetria habilitada
`STREAMING_BROKERS`	Endereços de broker para o dispatcher obrigatório de fatos SILOC. O streaming não tem modo desabilitado: uma configuração de broker ausente ou inválida impede a inicialização, em vez de deixar fatos como `PENDING`. Configure as opções compartilhadas `STREAMING_*` conforme Streaming e outbox.	—	Sim
`STREAMING_CLOUDEVENTS_SOURCE`	Identidade de origem dos CloudEvents. Copie-a exatamente do pacote de deployment atual da Lerian. Um valor diferente, incluindo espaços em branco no início ou no fim, impede a inicialização; o serviço usa essa identidade para derivar seus tópicos de broker e seu escopo de controle de acesso.	—	Sim
`LDL_FACT_CONSUMER_ENABLED`	Habilita o consumidor dos fatos autoritativos de liquidação LDL do SPB. Cada fato completa a instrução SILOC que ele autoriza. Com `true`, `STREAMING_BROKERS` e o datastore PostgreSQL são obrigatórios, e o serviço se recusa a iniciar sem eles. Desabilitado, seu check de prontidão reporta `skipped`; em execução, o check não bloqueia a prontidão.	`false`	Não

Saúde e prontidão

O Lerian SILOC expõe GET /health (liveness), GET /readyz (readiness) e GET /version na porta HTTP principal. O serviço inicializa e serve essas probes mesmo antes de seus datastores e da conexão de liquidação estarem acessíveis. O /readyz reporta a saúde de cada dependência. Consulte Saúde e prontidão para o contrato das probes.

​Runtime e servidor

​Autenticação

​PostgreSQL

​Redis

​Conectividade de liquidação do SILOC

​Certificados

​Confiança e custódia

​Observabilidade

​Saúde e prontidão

Runtime e servidor

Autenticação

PostgreSQL

Redis

Conectividade de liquidação do SILOC

Certificados

Confiança e custódia

Observabilidade

Saúde e prontidão