Visão geral de conformidade
O Tracer foi projetado para atender aos requisitos de auditoria de regulamentações financeiras, incluindo:
| Regulamentação | Requisito | Como o Tracer atende |
|---|---|---|
| SOX (Sarbanes-Oxley) | Trilha de auditoria completa de decisões financeiras | Toda validação é registrada com contexto completo |
| GLBA (Gramm-Leach-Bliley) | Proteção de dados financeiros do cliente | Dados criptografados em repouso e em trânsito |
| Auditoria geral | Capacidade de reconstruir decisões | Registros imutáveis com snapshots de entrada/saída |
Arquitetura da trilha de auditoria
O Tracer registra cada decisão de validação com contexto completo para conformidade e investigação.
O que é registrado
Toda validação cria um registro de auditoria imutável contendo:| Dado | Descrição |
|---|---|
| Snapshot da requisição | Payload de entrada completo como recebido |
| Snapshot da resposta | Resposta completa incluindo decisão e detalhes |
| Decisão | ALLOW, DENY ou REVIEW |
| Motivo | Por que a decisão foi tomada |
| Regras avaliadas | Todas as regras que foram avaliadas |
| Regras correspondentes | Regras que foram acionadas (se houver) |
| Detalhes de limite | Informações de uso para limites verificados |
| Tempo de processamento | Quanto tempo a validação levou |
| Timestamp | Quando a validação ocorreu |
Garantias de imutabilidade
Registros de auditoria são write-once (escrita única):- Registros não podem ser modificados após a criação
- Registros não podem ser excluídos (exceto por política de retenção)
- Cada registro tem um ID de validação único para referência
A trilha de auditoria foi projetada para auditorias de conformidade. Você pode reconstruir exatamente o que aconteceu em qualquer validação, mesmo anos depois.
Retenção de dados
O Tracer retém dados de acordo com requisitos regulatórios e necessidades operacionais.
Períodos de retenção
| Tipo de dado | Período de retenção | Motivo |
|---|---|---|
| Registros de validação | Mínimo de 7 anos | Requisito de conformidade SOX/GLBA |
| Regras (ativas/inativas) | Indefinido | Continuidade operacional |
| Regras (excluídas) | Não retido | Removidas permanentemente |
| Limites | Indefinido | Continuidade operacional |
| Logs de aplicação | 90 dias | Debugging e troubleshooting |
Considerações de conformidade
- Requisito SOX: Manter registros por 7 anos a partir da data do relatório de auditoria
- Requisito GLBA: Reter registros demonstrando conformidade com regras de privacidade
- Exportação de dados: Registros podem ser exportados para sistemas de auditoria externos
Consultando histórico de validações
Use o endpoint
GET /v1/validations para consultar validações históricas.
Consulta básica
Consulta filtrada
Filtros disponíveis
| Parâmetro | Tipo | Descrição |
|---|---|---|
startDate | RFC3339 | Início do intervalo de datas (inclusivo) |
endDate | RFC3339 | Fim do intervalo de datas (exclusivo) |
decision | enum | Filtrar por ALLOW, DENY ou REVIEW |
accountId | UUID | Filtrar por conta |
segmentId | UUID | Filtrar por segmento |
portfolioId | UUID | Filtrar por portfólio |
transactionType | enum | Filtrar por CARD, WIRE, PIX, CRYPTO |
matchedRuleId | UUID | Filtrar por regra que correspondeu |
exceededLimitId | UUID | Filtrar por limite que foi excedido |
Requisito de formato de data
Válido:Paginação
Resultados usam paginação baseada em cursor. A resposta inclui camposnextCursor e hasMore para navegar pelos resultados.
| Parâmetro | Padrão | Máximo | Descrição |
|---|---|---|---|
limit | 100 | 1000 | Resultados por página |
cursor | - | - | Cursor de paginação da resposta anterior |
Ao usar paginação por cursor,
sortBy e sortOrder são fixados a partir da consulta original.Ordenação
| Parâmetro | Opções | Padrão |
|---|---|---|
sortBy | createdAt, processingTimeMs | createdAt |
sortOrder | ASC, DESC | DESC |
Obtendo detalhes de validação
Recupere detalhes completos para uma validação específica usando
GET /v1/validations/{validationId}.
A resposta contém tudo necessário para entender uma decisão de validação:
- Snapshot da requisição: O payload de entrada completo como recebido
- Snapshot da resposta: Resposta completa incluindo decisão e motivo
- Regras avaliadas: Todas as regras que foram verificadas
- Regras correspondentes: Regras que foram acionadas (se houver)
- Detalhes de limites: Informações de uso para limites verificados
- Timestamps: Quando a validação ocorreu e tempo de processamento
Cenários de relatórios de conformidade
Consultas comuns para relatórios de auditoria e conformidade.
Cenário 1: Investigação de auditoria
“Por que esta transação foi negada em 15 de janeiro?”Cenário 2: Relatório mensal de conformidade
“Mostrar todas as transações negadas para contas corporativas em janeiro”Cenário 3: Análise de eficácia de regra
“Quais transações foram negadas por uma regra de fraude específica?”Cenário 4: Revisão de utilização de limite
“Quais transações excederam limites de gastos este mês?”Melhores práticas para conformidade
Recomendações para manter a prontidão para auditorias.
Manutenção de registros
- Armazene IDs de validação nos seus registros de transação para fácil referência cruzada
- Registre o requestId que você envia para o Tracer para correlação
- Exporte regularmente se você precisa de registros em sistemas de auditoria externos
Preparação para auditoria
- Teste consultas antes da temporada de auditoria para garantir que você consegue recuperar os dados necessários
- Verifique intervalos de data funcionam corretamente com seus requisitos de timezone
- Documente o alinhamento da sua política de retenção com a retenção de 7 anos do Tracer
Fluxo de trabalho de investigação
Ao investigar uma transação específica:- Encontre o ID de validação dos seus logs de transação ou histórico do Tracer
- Recupere detalhes completos usando GET /v1/validations/
- Revise o snapshot da requisição para ver quais dados foram fornecidos
- Verifique regras correspondentes para entender por que a decisão foi tomada
- Verifique status do limite se limites estavam envolvidos
Comportamento fail-open e auditoria
O Tracer usa uma abordagem fail-open configurável por padrão:
| Cenário | Comportamento padrão | Registro de auditoria |
|---|---|---|
| Nenhuma regra corresponde | ALLOW | Registrado com motivo “no_match” |
| Banco de dados temporariamente indisponível | ALLOW com aviso | Registrado se possível; alerta gerado |
| Timeout de avaliação | ALLOW com aviso | Registrado com motivo “timeout” |
O comportamento fail-open pode ser configurado para fail-closed em ambientes de alta segurança. Contate seu administrador para opções de configuração.
Referência rápida
Endpoints-chave e informações de retenção.
Endpoints
| Operação | Método | Endpoint |
|---|---|---|
| Listar validações | GET | /v1/validations |
| Obter validação | GET | /v1/validations/{validationId} |
Resumo de retenção
| Dado | Retenção |
|---|---|
| Registros de validação | 7+ anos |
| Regras/limites ativos | Indefinido |
| Logs de aplicação | 90 dias |