Investigar una decisión en el registro de auditoría (API) - Lerian

Encuentra una validación, lee por qué Tracer decidió y comprueba que el registro de auditoría esté íntegro.

Participantes

Tu institución. Tu sistema lee las decisiones y su registro de auditoría.
Tracer. Guarda las validaciones y sus eventos de auditoría, y verifica la cadena de auditoría.

Antes de empezar

Tu sistema puede llamar a la API de Tracer con una credencial válida. Consulta la guía de integración de Tracer.
La decisión vino de una solicitud de validación de tu sistema. Consulta Validar una transacción antes del ledger.

Diagrama

Investigar una decisión en el registro de auditoría

Pasos

#	Origen	Destino	Mensaje	API de Lerian	Qué ocurre
1	Tu institución	Tracer	API de Lerian	`GET /v1/validations`	Lista las validaciones. Filtra por `decision`, `account_id`, `matched_rule_id`, `exceeded_limit_id`, `scheme`, `start_date` y `end_date`.
2	Tracer	Tu institución	API de Lerian	Respuesta al paso 1	Tracer devuelve las validaciones encontradas, de la más nueva a la más antigua, con un cursor para la página siguiente.
3	Tu institución	Tracer	API de Lerian	`GET /v1/validations/{validation_id}`	Lee una validación.
4	Tracer	Tu institución	API de Lerian	Respuesta al paso 3	Tracer devuelve el contexto de la transacción que enviaste, la decisión, las reglas que coincidieron y el uso de los límites.
5	Tu institución	Tracer	API de Lerian	`GET /v1/audit-events`	Lista los eventos de auditoría de la validación. Usa el `validationId` en `resource_id`.
6	Tracer	Tu institución	API de Lerian	Respuesta al paso 5	Tracer devuelve los eventos de auditoría.
7	Tu institución	Tracer	API de Lerian	`GET /v1/audit-events/{audit_event_id}/verify`	Verifica la cadena de auditoría hasta el evento.
8	Tracer	Tu institución	API de Lerian	Respuesta al paso 7	Tracer devuelve `isValid`, el número de eventos que verificó y, cuando la cadena falla, `firstInvalidId`.

Cómo saber que terminó

La verificación devuelve isValid como true para la cadena hasta el evento.

Reglas

El evento de auditoría de una validación tiene el tipo TRANSACTION_VALIDATED.
Sin start_date y end_date, las dos listas cubren los últimos 90 días.
La API no tiene una ruta para cambiar o eliminar una validación o un evento de auditoría.
Las reservas de las transacciones de Midaz aparecen como eventos de auditoría con el tipo de recurso reservation. No son validaciones.

Qué puede salir mal

Situación	Qué ves	Qué hacer
La validación es más antigua que la ventana predeterminada.	Una lista vacía.	Amplía `start_date` y `end_date`.
La cadena de auditoría falla la verificación.	`isValid` es `false`.	Envía la respuesta al soporte de Lerian.

Relacionados