Sondeadores
Cuando
SCHEDULER_ENABLED es true, el scheduler ejecuta el sondeador de estado saliente. El sondeador se autoencola con un backoff por clave de estado.
Lerian STA somete todas las credenciales de una institución a un único presupuesto de 10 transferencias de archivo simultáneas y 10 comandos por minuto, que la rotación de contraseña comparte. Reserva 20 consultas por minuto para el descubrimiento entrante de forma predeterminada.
Credenciales
Cada credencial es una contraseña de operador de BACEN. Lerian STA la identifica por código de institución e ID de operador. Lerian STA la almacena cifrada con cifrado envelope. Los operadores pueden crear, actualizar, probar la conectividad de, rotar y revocar una credencial. Una actualización cambia solo el ID de operador o la descripción.
Qué credencial usa una transferencia
Una solicitud de creación de transferencia selecciona su credencial de BACEN de una de tres formas. Lerian STA aplica la primera que la solicitud lleva:credentialId: Lerian STA usa esa credencial.institutionCodesincredentialId: Lerian STA usa la única credencial no revocada de esa institución.- Ninguno de los dos campos: Lerian STA usa la única credencial no revocada que tiene.
201 lleva el credentialId que Lerian STA usó. Para dejar un campo sin valor, omítelo o envía null. Una cadena vacía devuelve 400 con STA-0014.
Un
409 durante una rotación de contraseña no es permanente. Repite la misma solicitud después de un backoff.
Rotación de contraseña
La rotación es un protocolo de tres fases que conserva la contraseña anterior y la nueva hasta que BACEN confirma una de ellas:
- Prepara la nueva contraseña de forma local.
- Cámbiala en BACEN.
- Promuévela de forma local.
CREDENTIALS_RECOVERY_ON_BOOT es true, y en cada barrido de credenciales cuando SCHEDULER_ENABLED es true. Si BACEN no acepta ni la contraseña anterior ni la nueva, Lerian STA bloquea la credencial en un estado de error para un restablecimiento manual de credenciales.
Monitoreo de expiración de contraseña
BACEN exige cambios periódicos de contraseña. Lerian STA rastrea la expiración reportada por BACEN de cada credencial mediante una cache read-through. Proyecta una banda de salud con los días restantes. Las bandas son saludable por encima de 15 días, de advertencia de 6 a 15, crítica de 1 a 5 y vencida en 0 o menos. Un operador puede entonces rotar la contraseña antes de que BACEN le bloquee el acceso.
Retención y TTL de protocolo
- TTL de protocolo saliente. Cada transferencia saliente tiene una vida útil de reloj de pared, contada desde que BACEN asigna su protocolo. El valor predeterminado es 44 horas (
TRANSFER_TTL_HOURS). - Transferencias canceladas e inconsistentes. Cuando
SCHEDULER_ENABLEDestrue, Lerian STA las elimina cuando su último cambio de estado tiene más de 7 días (SCHEDULER_QUARANTINE_RETENTION_DAYS). - Retención entrante. Una política de ciclo de vida en el bucket controla cuánto tiempo permanecen los archivos entrantes.
Conciliación y contingencia
Lerian STA concilia al nivel de granularidad de una transferencia por número de protocolo de BACEN. En el descubrimiento, el número de protocolo es la clave de idempotencia: un protocolo ya registrado no crea una segunda transferencia. BACEN no ofrece una creación de protocolo idempotente. Una segunda creación puede duplicar el archivo en BACEN. Cuando una transferencia tiene una marca persistente de intento de creación, pero no tiene número de protocolo, Lerian STA la pone en Creación de protocolo no confirmada. Un operador debe conciliar ese intento. Lerian STA no repite la creación marcada.