LGPD.Redact.Core 1.3.0

LGPD.Redact

LGPD.Redact é uma biblioteca de alta performance para redação de dados sensíveis (PII) em conformidade com a LGPD. Construída sobre o framework oficial de conformidade da Microsoft, ela utiliza Span<char> para garantir alocação zero e máxima velocidade durante o processamento de logs, telemetria, e APIs REST.

Oferece dois modos de redação:

Instalação

dotnet add package LGPD.Redact.Core

Registre os servicos no DI com AddLGPDRedaction():

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

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

Importante: O nome do parâmetro do método deve corresponder exatamente ao nome do placeholder na mensagem do [LoggerMessage]. O source generator do Microsoft.Extensions.Logging valida essa correspondência em tempo de build.

// ✅ Correto - nomes correspondentes
[LoggerMessage(Message = "Meu nome é {Nome}")]
public static partial void LogNome(this ILogger logger, [NomeData] string nome);

// ❌ Erro de build - nomes não correspondentes
[LoggerMessage(Message = "Meu nome é {PessoaNome}")]
public static partial void LogNome(this ILogger logger, [NomeData] string nome);

Exemplo rápido

Veja a diferença entre masking e HMAC para o mesmo CPF:

var cpf = redact.Redact(DadoPessoal.CPF, "123.456.789-01");
// Modo masking: "123.***.***-01"
// Modo HMAC:    "1:a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p=="

Configuração

LGPDRedactOptions

GuidOptions

Três formas de configurar

1. Em código (Action<LGPDRedactOptions>)

builder.Services.AddLGPDRedaction(options =>
{
    options.MaskChar = '#';
    options.Guid.PrefixHexCount = 6;
    options.HmacKey = Convert.ToBase64String(RandomNumberGenerator.GetBytes(32));
    options.HmacFor.Add(DadoPessoal.CPF);
});

2. Via IConfiguration (appsettings.json + env vars)

// appsettings.json com seção "LGPD"
builder.Services.AddLGPDRedaction(builder.Configuration);

{
  "LGPD": {
    "MaskChar": "#",
    "Guid": { "PrefixHexCount": 6 },
    "HmacFor": ["CPF"],
    "HmacKeyId": 1
  }
}

A HmacKey não deve ficar no appsettings.json (evite vazar a chave). Use variável de ambiente ou User Secrets:

# Environment variable (Linux/macOS)
export LGPD__HmacKey="suachavebase64aqui=="

# Windows CMD
set LGPD__HmacKey=suachavebase64aqui==

Ela também pode vir de qualquer outra fonte da cadeia de configuração: appsettings.Development.json, Azure Key Vault, ou gerada programaticamente.

3. Combinando ambas

// Lê defaults do config, depois sobrescreve programaticamente
builder.Services.AddLGPDRedaction(options =>
{
    options.HmacKey = Convert.ToBase64String(RandomNumberGenerator.GetBytes(32));
});
builder.Services.PostConfigure<LGPDRedactOptions>(opts =>
{
    opts.HmacFor.Add(DadoPessoal.CPF);
});

HMAC Redaction

Ao ativar HMAC para um tipo (ex.: CPF), o valor é substituído por um hash determinístico formatado como {KeyId}:{Base64}:

Vantagens do HMAC

Comportamento

O mesmo input sempre produz o mesmo hash (dentro do mesmo HmacKeyId):

redact.Redact(DadoPessoal.CPF, "123.456.789-01"); // 1:8fLm3q...==
redact.Redact(DadoPessoal.CPF, "123.456.789-01"); // 1:8fLm3q...== (mesmo valor)
redact.Redact(DadoPessoal.CPF, "987.654.321-00"); // 1:XyZ9a...==  (outro hash)

Atributos Suportados

Identificação Pessoal

Documentos Oficiais

Financeiro

Redes e Localização

Veículo

Técnico

Uso com ILGPDRedactService

Injete ILGPDRedactService e utilize o enum DadoPessoal para redigir valores avulsos sem precisar lidar com DataClassification:

public class MeuServico
{
    private readonly ILGPDRedactService _redact;

    public MeuServico(ILGPDRedactService redact) => _redact = redact;

    public void Executar()
    {
        string cpf = _redact.Redact(DadoPessoal.CPF, "123.456.789-09");
        string email = _redact.Redact(DadoPessoal.Email, "usuario@example.com");
    }
}

Enum DadoPessoal

Licenca

Distribuido sob a licenca MIT.