BrainEnterprise.Library.LLBLGen.Audit 1.0.0

BrainEnterprise.Library.LLBLGen.Audit

Libreria per il tracciamento automatico delle modifiche alle Entity LLBLGen Pro su file JSON.

Funzionalita'

• Traccia operazioni Insert, Update e Delete sulle Entity
• Salvataggio su file JSON con rotazione giornaliera
• Filtri configurabili per entita', campi e tipi di operazione
• Supporto per whitelist/blacklist di entita'
• Identificazione applicazione, versione e ambiente
• Personalizzazione dell'utente corrente tramite callback

Installazione

Aggiungere il riferimento al progetto e la dipendenza a LLBLGen Pro Runtime.

Utilizzo

Configurazione Base

// Inizializzazione semplice con ApplicationId
AuditConfiguration.Initialize("MyApp");

// Assegnare l'auditor all'adapter
using (var adapter = new DataAccessAdapter())
{
    adapter.Auditor = AuditConfiguration.CreateAuditor();
    // ... operazioni CRUD
}

Configurazione con Builder Fluent

AuditConfiguration.Configure()
    .WithApplication("MyApp", "1.0.0", "Production")
    .WithLogDirectory("C:\\Logs\\Audit")
    .WithFilePattern("audit_{date}.json")
    .OnlyEntities("CustomerEntity", "OrderEntity")      // Whitelist
    .ExcludeFields("Password", "CreditCardNumber")      // Esclusione globale
    .ExcludeFieldsFor("UserEntity", "PasswordHash")     // Esclusione per entita'
    .ExcludeDeletes()                                   // Solo Insert e Update
    .Apply();

Configurazione Manuale Completa

var config = new AuditFilterConfig
{
    ApplicationId = "MyApp",
    ApplicationVersion = "1.0.0",
    EnvironmentName = "Production",
    FilterMode = AuditFilterMode.WhiteListOnly,
    EntityNames = new HashSet<string> { "CustomerEntity", "OrderEntity" },
    GlobalExcludedFields = new HashSet<string> { "Password", "ModifiedDate" },
    AuditedOperations = new HashSet<AuditOperationType>
    {
        AuditOperationType.Insert,
        AuditOperationType.Update
    }
};

AuditConfiguration.Initialize("AuditLogs", "audit_{date}.json", config);

Personalizzazione Utente Corrente

Per default viene usato System.Environment.UserName. E' possibile personalizzare l'utente tramite la proprieta' GetCurrentUserFunc:

var config = new AuditFilterConfig
{
    ApplicationId = "MyWebApp",
    GetCurrentUserFunc = () => HttpContext.Current?.User?.Identity?.Name
};

AuditConfiguration.Initialize("AuditLogs", "audit_{date}.json", config);

Oppure con un sistema di autenticazione personalizzato:

config.GetCurrentUserFunc = () =>
    SecurityContext.CurrentSession?.PrimaryUser?.Name ?? "Anonymous";

Modalita' di Filtro

Formato Output JSON

Ogni riga del file di log e' un oggetto JSON:

{
  "applicationId": "MyApp",
  "applicationVersion": "1.0.0",
  "environmentName": "Production",
  "timestamp": "2024-01-15 10:30:45.123",
  "userName": "john.doe",
  "machineName": "SERVER01",
  "entityName": "CustomerEntity",
  "operationType": "Insert",
  "primaryKeyValues": { "Id": 123 },
  "entitySnapshot": { "Id": 123, "Name": "Acme Corp", "Email": "info@acme.com" }
}

Tipi di Operazione

Struttura File

BrainEnterprise.Library.LLBLGen.Audit/
├── AuditConfiguration.cs      # Configurazione statica e factory
├── AuditConfigBuilder.cs      # Builder fluent
├── AuditFilterConfig.cs       # Classe di configurazione filtri
├── AuditFilterMode.cs         # Enum modalita' filtro
├── AuditOperationType.cs      # Enum tipi operazione
├── AuditEntry.cs              # Modello entry di audit
└── FileAuditor.cs             # Implementazione IAuditor

Dipendenze

• LLBLGen Pro Runtime Framework
• Newtonsoft.Json

Note

• I file di log vengono creati automaticamente nella directory specificata
• Il pattern {date} nel nome file viene sostituito con la data corrente (yyyy-MM-dd)
• I valori binari vengono rappresentati come [Binary: N bytes]
• Le date vengono formattate come yyyy-MM-dd HH:mm:ss.fff