Os valores mostrados aqui são marcadores de posição. Injete credenciais e material de licença a partir do seu cofre de segredos. Nunca faça commit de segredos reais.
Modelo de configuração
Cada componente carrega valores de bootstrap do ambiente. O SPI, o DICT Hub, o COB Hub, a API do Pix Automático e o worker DICT VSync também consomem a configuração de tempo de execução do armazenamento do Systemplane após a inicialização. O adaptador do provedor simulado lê a configuração apenas do ambiente e mantém o estado em memória. Configure cada componente separadamente. Suas portas, seus armazenamentos e suas dependências obrigatórias são diferentes.Identidade e deploy compartilhados
PLUGIN_AUTH_ENABLED controla a autenticação das rotas de entrada. PLUGIN_AUTH_HOST é o endereço base do Access Manager usado pela integração de autenticação compartilhada e pelos fluxos de credenciais de cliente OAuth. Ele deve conter somente um endereço base, sem caminho OAuth, query, fragmento ou credenciais incorporadas. Use https:// fora do desenvolvimento local.
O adaptador do provedor simulado exige SPI_BASE_URL, PROVIDER_CLIENT_ID e PROVIDER_CLIENT_SECRET na inicialização. MOCK_TEST_ENDPOINTS_ENABLED=true ativa rotas de teste que podem forjar callbacks do provedor. O adaptador simulado não tem autorização de rota: mantenha o mock inacessível para chamadores não confiáveis, seja qual for o valor desse switch. Não configure o adaptador simulado como um trilho de produção.
Persistência e Valkey
O comportamento do Valkey varia por componente. SPI, DICT Hub e COB Hub podem degradar caminhos selecionados de idempotência ou cache quando você não configura o Valkey. Algumas mutações de SPI, DICT e COB falham de forma fechada com
PIX-0032 quando não existe um backstop de replay durável. O DICT VSync trata o Valkey como uma dependência obrigatória porque coordena o bloqueio de mutações entre pods. Um valor REDIS_* configurado, mas malformado, faz a inicialização falhar em vez de selecionar silenciosamente outro endpoint.
A implementação do Systemplane não usa SYSTEMPLANE_SECRET_MASTER_KEY. Proteja o acesso ao banco de dados do Systemplane, os backups e o armazenamento em disco por meio do ambiente de deploy.
Integrações da instituição e de serviços
Adaptador de conectividade Lerian
O adaptador de conectividade Lerian conecta o Pix Lerian ao Lerian SPI. Ele roda em dois componentes: a API do adaptador e o seu gravador de configuração. A API do adaptador atende as suas rotas sob o prefixo/lerian.
O gravador de configuração copia as suas variáveis para o armazenamento de configuração de tempo de execução do adaptador na inicialização. Ele não sobrescreve um valor armazenado que difere do padrão. A API do adaptador lê o roteamento e as credenciais desse armazenamento.
No modo multi-tenant, o gravador não copia nada. Grave os valores de cada tenant pela API administrativa do gravador. Esses valores são os quatro endereços de callback e os seus pares de credenciais de cliente, DICT_CID_FILE_BASE_URL e os três endereços BRSFN_*_BASE_URL. PLUGIN_AUTH_HOST, os pares BRSFN_SPI_CLIENT_*, BRSFN_DICT_CLIENT_* e BRSFN_COB_CLIENT_* e os segredos de assinatura das rotas de eventos não são valores de tenant. A API do adaptador lê esses valores para todos os tenants no armazenamento em SYSTEMPLANE_POSTGRES_DSN.
Quando uma superfície do Lerian SPI não tem um par de credenciais completo ou não há
PLUGIN_AUTH_HOST, o adaptador não chama essa superfície. Cada rota de eventos verifica cada entrega com o segredo de assinatura da sua inscrição de eventos. O adaptador lê esses segredos da configuração de tempo de execução, não do ambiente. No modo single-tenant, quando uma inscrição tem um novo segredo de assinatura, grave esse segredo na configuração de tempo de execução pela API administrativa do gravador de configuração. Uma rota sem segredo recusa todas as entregas.
VSync do DICT
O worker DICT VSync concilia o estado do DICT e exige sua própria configuração de worker:VSYNC_ENABLED e VSYNC_FILE_RECON_ENABLED podem ser recarregados a quente pela configuração de tempo de execução do worker. Os demais valores de ajuste são lidos na inicialização e exigem um restart.
API do Pix Automático
A API do Pix Automático envia comandos de liquidação ao SPI e lê estas variáveis:Streaming e observabilidade
O relay do outbox de notificações é desabilitado por padrão. Para habilitá-lo, definaSTREAMING_ENABLED=true e forneça STREAMING_BROKERS. A origem compartilhada de CloudEvents, quando configurada, deve identificar o serviço Pix Lerian. O componente também valida as configurações TLS/SASL do broker de streaming e a STREAMING_DATASCHEMA_BASE_URL opcional.
Defina ENABLE_TELEMETRY=true para ativar o OpenTelemetry. As variáveis OTEL_* configuram a telemetria. Consulte Configuração BYOC para a telemetria compartilhada e os parâmetros de transporte do broker.
Saúde e readiness
Os caminhos de probe e os prefixos de rota pertencem à configuração de deploy do componente. Não suponha que todos os componentes exponham/health ou /readyz sem prefixo. Use os caminhos no chart da release e na configuração de bootstrap do componente.