RVS.AuditTrail 0.1.2

AuditTrail

EF Core audit trail package for commercial .NET applications.

Features

Community Features

• Captures EF Core create, update, and delete changes.
• Stores entity name, table name, primary key, changed properties, user, tenant, correlation ID, and UTC timestamp.
• Redacts common sensitive properties before audit data leaves the collector.
• Supports custom context providers and custom audit sinks.
• Includes EF Core table mapping and an EF-backed storage sink.

Licensed Feature Gates

The package includes a licensing foundation for paid features. These features are available for a local 3-day trial when no license key is configured, then blocked until a commercial validator enables them:

• Tamper-proof hash chain
• Audit export
• Retention policies
• Advanced search

Install

dotnet add package AuditTrail

This package is organized as a standalone product folder:

docs/
samples/
src/
tests/

Current Development Surface

Register the package services, then add the EF Core interceptor when configuring your DbContext.

services
    .AddAuditTrail()
    .AddEntityFrameworkAuditSink<AuditDbContext>()
    .AddAuditContextProvider<MyAuditContextProvider>();

services.AddDbContextFactory<AuditDbContext>(options =>
{
    options.UseSqlServer(connectionString);
});

services.AddDbContext<AppDbContext>((serviceProvider, options) =>
{
    options
        .UseSqlServer(connectionString)
        .AddInterceptors(serviceProvider.GetRequiredService<AuditTrailSaveChangesInterceptor>());
});

Add audit table mapping in your audit storage DbContext:

public sealed class AuditDbContext : DbContext
{
    public AuditDbContext(DbContextOptions<AuditDbContext> options)
        : base(options)
    {
    }

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.AddAuditTrailRecords();
}
}

Configure a commercial license key when using licensed features:

services
    .AddAuditTrail()
    .AddSignedAuditTrailLicense("your-license-key", "your-public-key-pem");

Trial behavior:

• Community features always work.
• Paid features work for 3 days without a license.
• The trial starts the first time a paid feature is checked or used.
• Trial state is stored locally under the user's application data folder by default.
• After the trial expires, paid features require a valid signed license.

Issuing Licenses

Use the Windows license manager tool to create signed offline licenses:

dotnet run --project packages\AuditTrail\tools\AuditTrail.LicenseManager\AuditTrail.LicenseManager.csproj

The tool can:

• generate an RSA private/public key pair
• create a signed customer license
• select paid features for the customer
• copy or save the generated license
• open an email draft for the customer

Keep the private key secret. Customers receive only the license key and public key PEM. The package validates the license with the public key and rejects edited, expired, or unsigned license keys.

License

This package is commercial software. See LICENSE.txt for terms.