EZ.Redact.Lgpd.OpenTelemetry 2.1.0

EZ.Redact.Lgpd.OpenTelemetry

EZ.Redact.Lgpd.OpenTelemetry é uma extensão do ecossistema EZ.Redact.Lgpd que aplica redação de dados sensíveis (LGPD) em traces do OpenTelemetry. Ela redige tags e baggage de spans automaticamente antes da exportação, além de fornecer uma API fluente para criar eventos com dados mascarados.

Instalação

dotnet add package EZ.Redact.Lgpd.OpenTelemetry

Registre os serviços no DI com AddLGPDRedaction() e configure a redação OpenTelemetry:

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddLGPDRedaction();
builder.Logging.EnableRedaction(options => options.ApplyDiscriminator = false);

Exemplo rápido

using EZ.Redact.Lgpd.OpenTelemetry;
using EZ.Redact.Lgpd.OpenTelemetry.Processors;
using OpenTelemetry.Trace;

builder.Services.AddLGPDRedaction()
    .AddOpenTelemetryRedaction(options =>
    {
        options.RedactTags("user.cpf", "user.email", "customer.document");
        options.RedactBaggage("user.cpf", "user.email");
    });

builder.Services.AddOpenTelemetry()
    .WithTracing(tracing => tracing
        .AddAspNetCoreInstrumentation()
        .AddProcessor(sp => sp.GetRequiredService<LgpdRedactionProcessor>()));

Tags e baggage cujos nomes estiverem na blacklist são redigidos automaticamente ao final do span:

Eventos redigidos

Crie eventos com dados sensíveis usando a API fluente:

activity.CreateRedactedEvent(
    "Cliente {cpf} realizou saque de {valor} na conta {conta}",
    redactService)
    .WithRedacted("cpf", DadoPessoal.CPF, "123.456.789-00")
    .WithRaw("valor", "R$ 1.500,00")
    .WithRedacted("conta", DadoPessoal.ContaBancaria, "12345-6")
    .Add();

Saída do evento redigido:

Cliente ***.***.***-** realizou saque de R$ 1.500,00 na conta *****-*

API do builder

Configuração

LgpdOpenTelemetryOptions

builder.Services.AddLGPDRedaction()
    .AddOpenTelemetryRedaction(options =>
    {
        options.RedactTags("user.cpf", "user.email", "user.nome", "customer.document");
        options.RedactBaggage("user.cpf", "user.email");
    });

Comportamento

LgpdRedactionProcessor

O LgpdRedactionProcessor implementa BaseProcessor<Activity> do OpenTelemetry e:

1. No método OnEnd intercepta cada span antes da exportação
2. Verifica se a redação está habilitada — respeita o controle configurado no Core (via ILGPDRedactService)
3. Para cada tag cujo nome estiver na blacklist, substitui o valor pela redação genérica
4. Para cada baggage cujo nome estiver na blacklist, substitui o valor pela redação genérica

Redação genérica

Preserva 3 caracteres no início e 3 no final do valor, substituindo o meio por asteriscos:

"123.456.789-00" → "123*******00"
"joao@example.com" → "joa*******com"
"curto" → "curto" (inalterado — < 6 caracteres)

Projetos Relacionados

Licença

Distribuído sob a licença MIT.