Investigar uma decisão na trilha de auditoria (API) - Lerian

Encontre uma validação, leia por que o Tracer decidiu e confira se a trilha de auditoria está íntegra.

Participantes

Sua instituição. Seu sistema lê as decisões e a trilha de auditoria delas.
Tracer. Guarda as validações e os eventos de auditoria delas e verifica a cadeia de auditoria.

Antes de começar

Seu sistema pode chamar a API do Tracer com uma credencial válida. Veja o guia de integração do Tracer.
A decisão veio de uma requisição de validação do seu sistema. Veja Validar uma transação antes do ledger.

Diagrama

Investigar uma decisão na trilha de auditoria

Passo a passo

#	Origem	Destino	Mensagem	API da Lerian	O que acontece
1	Sua instituição	Tracer	API da Lerian	`GET /v1/validations`	Liste as validações. Filtre por `decision`, `account_id`, `matched_rule_id`, `exceeded_limit_id`, `scheme`, `start_date` e `end_date`.
2	Tracer	Sua instituição	API da Lerian	Resposta ao passo 1	O Tracer devolve as validações encontradas, da mais nova para a mais antiga, com um cursor para a próxima página.
3	Sua instituição	Tracer	API da Lerian	`GET /v1/validations/{validation_id}`	Leia uma validação.
4	Tracer	Sua instituição	API da Lerian	Resposta ao passo 3	O Tracer devolve o contexto da transação que você enviou, a decisão, as regras que casaram e o uso dos limites.
5	Sua instituição	Tracer	API da Lerian	`GET /v1/audit-events`	Liste os eventos de auditoria da validação. Use o `validationId` em `resource_id`.
6	Tracer	Sua instituição	API da Lerian	Resposta ao passo 5	O Tracer devolve os eventos de auditoria.
7	Sua instituição	Tracer	API da Lerian	`GET /v1/audit-events/{audit_event_id}/verify`	Verifique a cadeia de auditoria até o evento.
8	Tracer	Sua instituição	API da Lerian	Resposta ao passo 7	O Tracer devolve `isValid`, o número de eventos que verificou e, quando a cadeia falha, `firstInvalidId`.

Como saber que terminou

A verificação devolve isValid como true para a cadeia até o evento.

Regras

O evento de auditoria de uma validação tem o tipo TRANSACTION_VALIDATED.
Sem start_date e end_date, as duas listas cobrem os últimos 90 dias.
A API não tem rota para alterar ou excluir uma validação ou um evento de auditoria.
As reservas das transações do Midaz aparecem como eventos de auditoria com o tipo de recurso reservation. Elas não são validações.

O que pode dar errado

Situação	O que você vê	O que fazer
A validação é mais antiga que a janela padrão.	Uma lista vazia.	Amplie `start_date` e `end_date`.
A cadeia de auditoria falha na verificação.	`isValid` é `false`.	Envie a resposta ao suporte da Lerian.

Relacionados