Variáveis de ambiente

O Lerian SISBAJUD é o rail de propriedade da Lerian que cumpre ordens judiciais de bloqueio de ativos e protege os dados pessoais que elas carregam. Você define essas variáveis no momento do deploy. Elas só entram em vigor após uma reinicialização do serviço. A referência de configuração BYOC documenta o backbone universal que todo serviço Go da Lerian compartilha: servidor, datastores, multi-tenancy, telemetria, autenticação de plugin e licenciamento. Esta página cobre apenas as variáveis distintivas do Lerian SISBAJUD. Nas tabelas abaixo, a coluna Padrão / Obrigatória mostra o valor padrão. Um qualificador em negrito (por exemplo Obrigatória ou Obrigatória se habilitado) marca as variáveis que você deve definir. — significa que não há padrão. Qualquer 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`	—	Endereço de escuta HTTP principal; sem padrão no código, então defina explicitamente (o deployment de referência usa `:4029`). As probes de liveness, readiness, metrics e version se vinculam a essa mesma porta.
`ENVIRONMENT_NAME`	—	Ambiente de runtime: `local`, `development`, `staging`, `e2e`, `test` ou `production`. `ENV_NAME` é aceito como nome alternativo. Não definido fica vazio e é tratado como produção, então os controles de segurança mais estritos armam de forma fechada.
`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).
`DEFAULT_TENANT_ID`	Obrigatória no modo single-tenant	UUID de tenant usado no modo single-tenant. Não há um valor padrão de string efetivo: defina explicitamente um UUID válido para uma operação single-tenant utilizável. O tenant é a fronteira de isolamento de banco de dados e pode conter várias instituições; cada instituição roteia pelo seu próprio identificador dentro do tenant. Com a autenticação desativada, o trilho também usa este UUID como fallback da sua única instituição configurada.

O Lerian SISBAJUD expõe /health (liveness), /readyz (readiness), /version e /metrics na porta principal. 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.

Backend de segurança

O serviço valida o provider KMS no boot. Ele seleciona o backend que protege, com criptografia de envelope, os dados de bloqueio determinados por ordem judicial. Em produção, um valor não definido ou não suportado falha o boot fechado. Fora de produção, o padrão é vault.

Variável	Padrão / Obrigatória	Descrição
`KMS_PROVIDER`	`vault` (fora de produção) · Obrigatória em produção	Gerenciador de chaves de criptografia de envelope: `vault` (HashiCorp Vault Transit) ou `aws` (AWS KMS). Lido uma vez no boot; não recarregável a quente. Não há provider em memória.

KMS_PROVIDER=vault requer as variáveis do Vault abaixo. KMS_PROVIDER=aws requer a AWS_REGION compartilhada. As credenciais de conector por instituição são seladas dentro dos metadados de configuração da instituição, sob uma KEK de classe de credenciais; nenhum seletor de ambiente escolhe onde armazená-las. KMS_PROVIDER usa vault como padrão quando não definido fora de produção. Em produção, você deve defini-lo explicitamente ou o boot falha fechado.

Vault (quando `KMS_PROVIDER=vault`)

Variável	Padrão / Obrigatória	Descrição
`VAULT_ADDR`	Obrigatória para o provider Vault	Endereço do Vault do cliente.
`VAULT_AUTH_METHOD`	`token`	Método de autenticação: `token` (`VAULT_TOKEN` estático) ou `approle` (role id e secret id do AppRole).
`VAULT_TOKEN`	Obrigatória se `token`, em produção	Token de serviço para o Vault. Sensível. Fora de produção recorre a um token de desenvolvimento.
`VAULT_APPROLE_ROLE_ID`	Obrigatória se `approle`	Role id do AppRole. Sensível.
`VAULT_APPROLE_SECRET_ID`	Obrigatória se `approle`	Secret id do AppRole. Sensível.
`VAULT_TRANSIT_MOUNT_PATH`	`transit`	Mount path do engine Transit usado para criptografia de envelope.

AWS (quando `KMS_PROVIDER=aws`)

Variável	Padrão / Obrigatória	Descrição
`AWS_REGION`	Obrigatória com `KMS_PROVIDER=aws`	Região para o adaptador AWS KMS. O boot falha fechado quando `KMS_PROVIDER=aws` e ela está em branco. As credenciais são resolvidas através da cadeia padrão do AWS SDK.
`AWS_ENDPOINT_URL`	—	Override de endpoint compatível com AWS. Deixe não definido em ambientes AWS reais para que o SDK use seus endpoints padrão.

Ciclo de vida cripto

A criptografia de envelope usa uma data key por registro selada sob a chave-mestra da instituição, além de um blind index para busca por correspondência exata em identificadores fiscais.

Variável	Padrão / Obrigatória	Descrição
`SISBAJUD_DEK_CACHE_TTL`	`5m`	Tempo de vida de uma data-encryption key desenvelopada no cache em memória antes de o KMS ser solicitado a desenvelopar novamente. String de duração Go.
`SISBAJUD_DEK_CACHE_MAX_ENTRIES`	`50000`	Teto de primitivas de data key em cache; limita o heap durante um decrypt em batch grande.
`SISBAJUD_HMAC_COEXISTENCE_WINDOW`	`720h`	Janela durante a qual hashes de blind index da versão anterior de chave HMAC permanecem consultáveis ao longo de uma rotação de chave. String de duração Go.
`KEK_REWRAP_BACKFILL_ENABLED`	`false`	Habilita a varredura em segundo plano que avança linhas de data key atrasadas para a versão de chave-mestra ativa após uma rotação.
`REHASH_BACKFILL_ENABLED`	`false`	Habilita a varredura em segundo plano que re-hasheia linhas de blind index atrasadas para a nova versão primária de chave HMAC.

Workers de domínio

O processamento de ordens judiciais roda como um conjunto de crons em segundo plano por instituição. Todos ficam desligados por padrão, exceto o reaper de locks de processamento, que roda por padrão. Os workers usam os parâmetros de cadência *_SCAN_INTERVAL (segundos) e *_BATCH_SIZE quando aplicável.

Variável	Padrão / Obrigatória	Descrição
`EXECUTION_ENABLED`	`false`	Chave mestra para o engine de execução de ordens. Quando desligada, o orquestrador FIFO e o dispatch downstream permanecem dormentes.
`ORCHESTRATOR_LOCK_TTL`	`30`	Lease do lock de execução por sujeito, em segundos.
`ORCHESTRATOR_RENEW_INTERVAL`	`10`	Cadência, em segundos, na qual o worker proprietário renova o lock. Deve permanecer estritamente abaixo de `ORCHESTRATOR_LOCK_TTL` ou o boot falha fechado.
`PROCESSING_LOCK_REAPER_ENABLED`	`true`	Habilita o reaper em segundo plano que exclui linhas de locks de processamento expirados de cada tenant.
`PROCESSING_LOCK_REAPER_INTERVAL_SEC`	`300`	Cadência da varredura do reaper, em segundos. Se esta variável não for definida ou não for positiva, o serviço usa 300 segundos.
`UNBLOCK_EXECUTION_SCAN_INTERVAL`	`60`	Cadência da varredura de desbloqueios pendentes em segundos. Compartilha o gate `EXECUTION_ENABLED`.
`UNBLOCK_EXECUTION_BATCH_SIZE`	`500`	Ordens de desbloqueio pendentes processadas por passada de tenant.
`PERMANENT_BLOCK_EXPIRY_ENABLED`	`false`	Habilita a varredura diária que expira bloqueios permanentes após seu prazo.
`RECONCILIATION_ENABLED`	`false`	Habilita a varredura que reconcilia ordens de monitoramento contra o ledger e persiste as lacunas detectadas.
`RETURN_FILE_GENERATION_ENABLED`	`false`	Habilita a geração de arquivos de retorno SISBAJUD para ordens terminais não retornadas.
`INFORMATION_RETURN_FILE_GENERATION_ENABLED`	`false`	Habilita a geração de arquivos de resposta de informação AJUD309.
`SLA_ALERT_ENABLED`	`false`	Habilita o avaliador que classifica ordens ativas por faixa de risco de SLA e emite as faixas como métricas.
`RETURN_FILE_ENVIRONMENT`	`HOMOLOGATION`	Ambiente regulatório carimbado nos arquivos de retorno gerados.

Armazenamento de objetos

O Lerian SISBAJUD escreve os artefatos de bloqueio determinados por ordem judicial em um object store compatível com S3, já criptografados. A camada de blob nunca vê texto plano.

Variável	Padrão / Obrigatória	Descrição
`SEAWEEDFS_S3_ENDPOINT`	`http://localhost:8333`	Endpoint do object store compatível com S3. Falhas na conexão do storage não são fatais: o serviço sobe e a probe de readiness reporta o store como indisponível.
`SEAWEEDFS_BUCKET`	`sisbajud`	Bucket para artefatos de remessa e de retorno (já criptografados).
`SEAWEEDFS_REGION`	`us-east-1`	Rótulo de região S3 exigido pelo AWS SDK.
`SEAWEEDFS_ACCESS_KEY`	—	Access key do object store. Sensível. Deixe em branco quando o store não exigir auth.
`SEAWEEDFS_SECRET_KEY`	—	Secret key do object store. Sensível. Deixe em branco quando o store não exigir auth.
`STA_INBOUND_BUCKET`	`sta-files`	Bucket que armazena os objetos de remessa brutos para os quais uma notificação de recepção aponta.
`STA_FILE_LOCK_TTL`	`5`	TTL do lock de processamento por arquivo, em minutos.

Conector do ledger Midaz

O Lerian SISBAJUD lê saldos e bloqueios através do ledger Midaz. MIDAZ_BASE_URL é um fallback opcional para todo o serviço; os metadados do conector por instituição têm precedência.

Variável	Padrão / Obrigatória	Descrição
`MIDAZ_BASE_URL`	— (fallback opcional)	URL base do ledger Midaz. É usada apenas quando os metadados por instituição não fornecem uma URL. A resolução do conector falha fechada somente se nenhum dos dois fornecer uma URL.
`MIDAZ_AUTH_ENABLED`	`false`	Habilita a autenticação machine-to-machine para o Midaz.
`MIDAZ_AUTH_ADDRESS`	Obrigatória se habilitado	Endereço do serviço de auth para emitir tokens Midaz.
`MIDAZ_CLIENT_ID`	Obrigatória se habilitado	OAuth client id para o Midaz. Ignorado no modo multi-tenant (resolvido por tenant).
`MIDAZ_CLIENT_SECRET`	Obrigatória se habilitado	OAuth client secret para o Midaz. Sensível. Ignorado no modo multi-tenant (resolvido por tenant).

​Serviço e runtime

​Backend de segurança

​Vault (quando KMS_PROVIDER=vault)

​AWS (quando KMS_PROVIDER=aws)

​Ciclo de vida cripto

​Workers de domínio

​Armazenamento de objetos

​Conector do ledger Midaz

Serviço e runtime

Backend de segurança

Vault (quando `KMS_PROVIDER=vault`)

AWS (quando `KMS_PROVIDER=aws`)

Ciclo de vida cripto

Workers de domínio

Armazenamento de objetos

Conector do ledger Midaz