Salud y readiness
GET /health responde liveness. GET /readyz ejecuta cada sonda de dependencia y responde un solo estado.
GET /readyz/tenant/{id} responde postgres, redis y rabbitmq para una institución.
Un Reporter inalcanzable retira la instancia de servicio. Inicia primero el Reporter.
Credenciales y claves
PLUGIN_AUTH_ENABLED=true con PLUGIN_AUTH_HOST hace que Access Manager autorice cada solicitud de la API. El mismo par acuña los tokens salientes.
Cada upstream lleva su propia credencial. Lerian STA usa STA_CLIENT_ID y STA_CLIENT_SECRET. Lerian Reporter usa REPORTER_CLIENT_ID y REPORTER_CLIENT_SECRET.
Lerian CCS acuña un token mediante OAuth2 client credentials para cada llamada saliente. Fuera de saas, con la puerta activa, un par faltante detiene el arranque y nombra la variable exacta. En saas, Lerian gestiona la credencial de cada institución, y el riel mantiene la credencial en caché durante M2M_CREDENTIAL_CACHE_TTL_SEC segundos, 300 por defecto.
CCS_CRYPTO_MASTER_KEY contiene la clave maestra AES-256-GCM para los datos cifrados en reposo. Toma 64 caracteres hexadecimales. Un valor vacío detiene el arranque.
Lerian CCS puede verificar una firma en cada evento entrante de Lerian STA. Configura STA_EVENT_HMAC_VERIFY_ENABLED=true, carga el catálogo de claves en STA_EVENT_HMAC_MASTER_KEYS, y nombra la versión activa en STA_EVENT_HMAC_MASTER_KEY_VERSION. Carga primero el catálogo. El servicio rechaza un evento cuya firma no coincide.
Almacenamiento, outbox y retención
Dos buckets de almacenamiento de objetos contienen el XML regulatorio:
OBJECT_STORAGE_STA_BUCKET de entrada y OBJECT_STORAGE_CCS_BUCKET de salida. La API y los mensajes del broker solo llevan referencias de archivo.
El trabajo de salida sale a través de una tabla outbox transaccional, así que el servicio necesita OUTBOX_ENABLED=true para arrancar. El despachador la lee cada OUTBOX_DISPATCH_INTERVAL_SEC segundos, 2 por defecto, en lotes de OUTBOX_BATCH_SIZE, 50 por defecto, y abandona un evento después de OUTBOX_MAX_DISPATCH_ATTEMPTS intentos, 10 por defecto. Configura CCS_OUTBOX_OVERRIDES_ENABLED=true para mover el despachador al intervalo, tamaño de lote y presupuesto de intentos de CCS_OUTBOX_*. Cuando el envío de un ACCS001 agota su presupuesto de intentos, su lote pasa a SUBMIT_FAILED.
CCS_OUTBOUND_RETENTION_DAYS y CCS_ACCS009_RETENTION_DAYS tienen ambos un valor por defecto de 30 días. Un monitor busca una remesa faltante cada CCS_NON_SUBMISSION_SCAN_INTERVAL_SEC segundos, 3600 por defecto.
El servicio nunca aplica su propio esquema de base de datos. Un job de migración separado lo aplica antes del arranque.
Respuestas de STA en espera
Cuando Lerian CCS no puede aplicar un archivo de entrada, deja el evento del archivo en espera en una cola dead-letter. El archivo queda en el bucket de entrada. Suele ser la única copia de un hecho de BACEN, así que necesita una alerta y una decisión humana.
POST /v1/batches/{id}/drain-parked-response aplica un ACCS003 tardío a un lote que ya alcanzó un estado terminal. Quien llama solo aporta identificadores. Lerian CCS vuelve a obtener el archivo, vuelve a derivar los veredictos, y rechaza cuando el lote nombrado no coincide. Escribe una entrada de auditoría en la misma transacción.
No liberes la respuesta en espera cuando dos lotes coinciden con un archivo, o cuando la correlación se contradice. Establece primero qué lote produjo el archivo. Trata el desacuerdo como el hallazgo.
Métricas y trazas
GET /metrics sirve las métricas de readiness en formato de texto Prometheus. Configura ENABLE_TELEMETRY=true para exportar trazas y métricas por OTLP a OTEL_EXPORTER_OTLP_ENDPOINT. Consulta Observabilidad para la vista de la plataforma.
Postura de despliegue
DEPLOYMENT_MODE toma local, byoc o saas. CCS_RUN_MODE toma manager, worker o all, y selecciona qué subsistemas se ejecutan.
Producción agrega estos requisitos.
PLUGIN_AUTH_ENABLED=trueconPLUGIN_AUTH_HOST.
LICENSE_KEY, ORGANIZATION_IDS, REPORTER_URL, CCS_CRYPTO_MASTER_KEY, CIRCUIT_BREAKER_ENABLED=true y OUTBOX_ENABLED=true.
La validación de arranque comprueba la licencia y la postura TLS. Una comprobación fallida detiene el arranque.