— significa que no hay un valor predeterminado.
ENV_NAME activa las barreras de seguridad más estrictas. Configúralo como production o staging y el servicio exige TLS en Redis y la conexión STR, y verify-full en PostgreSQL. También requiere custodia respaldada por hardware para la clave privada SFN, y rechaza las superficies exclusivas de desarrollo. ENV_NAME no tiene un valor predeterminado. Configúralo explícitamente. El servicio se niega a empezar cuando ENV_NAME no está configurado o contiene un valor no reconocido.Runtime y servidor
Autenticación
Lerian SPB delega la autorización, incluida la API de administración de systemplane, en Access Manager. Consulta Fundamentos de configuración de BYOC.Declaración de permisos
Lerian SPB puede publicar su propio conjunto de permisos en Access Manager durante el arranque.IDP_DECLARATION_ENABLED=true lo activa, y cualquier valor distinto de true o false impide que el servicio arranque. Con la declaración activa, una variable faltante de las siguientes impide el arranque.
Con la declaración activa,
PLUGIN_AUTH_ENABLED debe ser true y PLUGIN_AUTH_ADDRESS debe estar configurada, porque el servicio las usa para obtener el token que usa la publicación.
Licencia
Lerian SPB necesita una licencia en todo entorno, incluido el de desarrollo. No inicia sinLICENSE_FILE_PATH o LICENSE_KEY. La licencia es global: Lerian SPB no lee ningún identificador de organización. Para el host que consulta la verificación de la clave, consulta License Manager.
La licencia protege toda ruta bajo
/v1/str. Una licencia rechazada responde 403 con un código LCS-, como describe la lista de errores.
PostgreSQL
Réplica de PostgreSQL
Réplica de lectura opcional. Todos los campos recurren al primario cuando no están configurados.Redis
Conectividad STR (RSFN)
Lerian SPB intercambia mensajes STR con BACEN a través de la RSFN usando un transporte IBM MQ. Estas variables definen la identidad del participante, la conexión al gestor de colas y las colas. Los tres nombres de cola se derivan deSTR_ISPB. Production y staging rechazan un nombre de cola que difiera del nombre derivado. El servicio empieza cuando no puede alcanzar el gestor de colas y se conecta cuando el gestor de colas vuelve. Cualquier otra falla de conexión impide el arranque. Un ejemplo es un gestor de colas que rechaza el nombre del gestor de colas, el canal, las credenciales, la configuración de TLS o los nombres de las colas.
Circuit breaker
Protege el transporte STR frente a un gestor de colas con fallas.Firma de mensajes y certificados
El certificado SFN enPROCESS_CERT_PATH es la identidad de Lerian SPB en la RSFN. Su clave privada firma cada mensaje STR saliente y descifra los mensajes entrantes que BACEN cifra para este certificado. En un HSM, permite la firma y el descifrado en esta clave. SPB_SIGNER_KIND define dónde se guarda la clave. Production y staging rechazan la custodia file y requieren pkcs11 o kmip.
Custodia PKCS#11
Obligatorio cuandoSPB_SIGNER_KIND=pkcs11.
Custodia KMIP
Obligatorio cuandoSPB_SIGNER_KIND=kmip (KMIP sobre HTTP hacia un HSM de red).
Eventos y outbox
Lerian SPB registra cada mensaje antes de enviarlo y publica eventos de ciclo de vida a través de un outbox transaccional hacia el broker de streaming. El streaming no tiene un modo deshabilitado. Define la configuración compartidaSTREAMING_* como se describe en Streaming y outbox. El servicio se niega a empezar cuando STREAMING_EVENT_POLICIES desactiva un evento de SPB distinto de str.message.submitted, str.approval.signed, str.approval.quorumReached, str.reconciliation.opened, str.reconciliation.resolved, str.certificate.rotated o str.certificate.expiring.
Aprobación (maker-checker)
Aprobación opcional por banda de valor que condiciona la emisión de STR. Deshabilitada de forma predeterminada. Las bandas y las reglas por tipo que un operador almacena mediante la API de gobernanza tienen prioridad sobreAPPROVAL_ALCADA_BANDS.
Rate limiting e idempotencia
Systemplane y configuración en runtime
Lerian SPB monta la API de administración de configuración en runtime de systemplane en/v1/system en el puerto principal. PostgreSQL respalda este plano, de modo que los operadores pueden leer y cambiar la configuración recargable en caliente sin un reinicio. Consulta Systemplane para conocer la API, los namespaces y los permisos.
Los orígenes CORS, los cuatro valores de rate limit y los dos valores de envío del outbox son recargables en caliente. Para estos parámetros, la variable define el valor inicial, y un valor almacenado en Systemplane tiene prioridad.
Cifrado y secretos
Observabilidad
Solo para desarrollo
Salud y readiness
Lerian SPB exponeGET /health (liveness) y GET /readyz (readiness) en el puerto HTTP principal. Consulta Salud y readiness para conocer el contrato de las sondas.
La respuesta de
/readyz incluye una verificación license. Con LICENSE_KEY, la verificación no hace ninguna llamada y aparece como activa. Una licencia que el servicio de licencias rechaza después del arranque detiene el servicio. Un archivo de licencia vencido hace más de 14 días, el período de gracia, también detiene el servicio.
Las verificaciones certificates, bacen-public-certificate, ibm-mq y ldl-advisory-consumer informan sin hacer fallar /readyz, por lo que un servicio en ejecución sigue en rotación. La verificación certificates aparece como caída cuando el certificado SFN está vencido o aún no es válido, o cuando la custodia no responde. La verificación bacen-public-certificate aparece como caída cuando el certificado público de BACEN tiene un problema. Un signer faltante sigue haciendo fallar /readyz. Crea alertas sobre estas verificaciones, porque /readyz por sí solo no señala un certificado vencido.
