Los valores que se muestran aquí son placeholders. Inyecta las credenciales y el material de licencia desde tu almacén de secretos. Nunca hagas commit de secretos reales.
Modelo de configuración
Cada componente carga valores de bootstrap desde su entorno. SPI, DICT Hub, COB Hub, la API de Pix Automático y el worker DICT VSync también consumen la configuración de runtime de su almacén de Systemplane después de la inicialización. El adaptador de proveedor mock lee su configuración solo desde el entorno y mantiene su estado en memoria. Configura cada componente por separado. Sus puertos, almacenes y dependencias obligatorias difieren.Identidad y despliegue compartidos
PLUGIN_AUTH_ENABLED controla la autenticación de las rutas entrantes. PLUGIN_AUTH_HOST es la dirección base de Access Manager que usa la integración de autenticación compartida y los flujos de credenciales de cliente OAuth. Debe ser solo una dirección base, sin una ruta OAuth, query, fragmento ni credenciales integradas. Usa https:// fuera del desarrollo local.
El adaptador de proveedor mock requiere SPI_BASE_URL, PROVIDER_CLIENT_ID y PROVIDER_CLIENT_SECRET al arrancar. MOCK_TEST_ENDPOINTS_ENABLED=true activa rutas de prueba que pueden falsificar callbacks del proveedor. El adaptador mock no tiene autorización de rutas: mantén el mock inaccesible para llamadores no confiables, sea cual sea el valor de este switch. No configures el adaptador mock como un riel de producción.
Persistencia y Valkey
El comportamiento de Valkey varía según el componente. SPI, DICT Hub y COB Hub pueden degradar determinadas rutas de idempotencia o caché cuando no configuras Valkey. Algunas mutaciones de SPI, DICT y COB fallan de forma segura con
PIX-0032 cuando no existe un respaldo duradero para repeticiones. DICT VSync trata Valkey como una dependencia obligatoria porque coordina el bloqueo de mutaciones entre pods. Un valor REDIS_* configurado pero mal formado hace fallar el arranque en lugar de seleccionar en silencio otro endpoint.
La implementación de Systemplane no usa SYSTEMPLANE_SECRET_MASTER_KEY. Protege el acceso a la base de datos de Systemplane, las copias de seguridad y el almacenamiento en disco mediante el entorno de despliegue.
Integraciones de la institución y de servicios
Adaptador de conectividad Lerian
El adaptador de conectividad Lerian conecta Pix Lerian con Lerian SPI. Se ejecuta como dos componentes: la API del adaptador y su escritor de configuración. La API del adaptador sirve sus rutas bajo el prefijo/lerian.
El escritor de configuración copia sus variables en el almacén de configuración de runtime del adaptador al iniciar. No sobrescribe un valor almacenado que difiere del valor predeterminado. La API del adaptador lee su enrutamiento y sus credenciales de ese almacén.
En modo multi-tenant, el escritor no copia nada. Escribe los valores de cada tenant mediante la API de administración del escritor. Estos valores son las cuatro direcciones de callback y sus pares de credenciales de cliente, DICT_CID_FILE_BASE_URL y las tres direcciones BRSFN_*_BASE_URL. PLUGIN_AUTH_HOST, los pares BRSFN_SPI_CLIENT_*, BRSFN_DICT_CLIENT_* y BRSFN_COB_CLIENT_* y los secretos de firma de las rutas de eventos no son valores de tenant. La API del adaptador los lee para todos los tenants del almacén en SYSTEMPLANE_POSTGRES_DSN.
Cuando una superficie de Lerian SPI no tiene un par de credenciales completo o no hay
PLUGIN_AUTH_HOST, el adaptador no llama a esa superficie. Cada ruta de eventos comprueba cada entrega con el secreto de firma de su suscripción de eventos. El adaptador lee esos secretos de su configuración de runtime, no del entorno. En modo single-tenant, cuando una suscripción tiene un nuevo secreto de firma, escribe ese secreto en la configuración de runtime mediante la API de administración del escritor de configuración. Una ruta sin secreto rechaza todas las entregas.
DICT VSync
El worker DICT VSync concilia el estado de DICT y requiere su propia configuración de worker:VSYNC_ENABLED y VSYNC_FILE_RECON_ENABLED pueden recargarse en caliente mediante la configuración de runtime del worker. Los valores de ajuste restantes se leen al arrancar y requieren un reinicio.
API de Pix Automático
La API de Pix Automático envía comandos de liquidación a SPI y lee estas variables:Streaming y observabilidad
El relay de notification-outbox está deshabilitado de forma predeterminada. Para habilitarlo, defineSTREAMING_ENABLED=true y proporciona STREAMING_BROKERS. La fuente de CloudEvents compartida, cuando está configurada, debe identificar el servicio Pix Lerian. El componente también valida la configuración TLS/SASL del broker de streaming y la STREAMING_DATASCHEMA_BASE_URL opcional.
Define ENABLE_TELEMETRY=true para activar OpenTelemetry. Las variables OTEL_* lo configuran. Consulta Configuración de BYOC para los parámetros compartidos de telemetría y transporte del broker.
Salud y readiness
Las rutas de las sondas y los prefijos de ruta pertenecen a la configuración de despliegue del componente. No supongas que todos los componentes exponen/health o /readyz sin prefijo. Usa las rutas del chart de la versión y de la configuración de bootstrap del componente.