pgEdge Anonymizer

Documentazione:

• Introduzione
• Buone Pratiche
• Installazione
• Configurazione
• Avvio Rapido
• Utilizzo
• Pattern Personalizzati
• Pattern Integrati
• Configurazione di Esempio
• Risoluzione dei Problemi
• Note di Rilascio
• Licenza

pgEdge Anonymizer è uno strumento da riga di comando per anonimizzare le informazioni personali identificabili (PII) nei database PostgreSQL. Lo strumento sostituisce i dati sensibili con valori fittizi realistici che puoi utilizzare per sviluppo e test, mantenendo la coerenza dei dati e l'integrità referenziale.

Caratteristiche

• Oltre 100 pattern integrati per tipi PII comuni in 19 paesi
• Sostituzione coerente - lo stesso input produce lo stesso output durante un'esecuzione
• Consapevolezza delle chiavi esterne - gestisce automaticamente le relazioni CASCADE
• Supporto per database di grandi dimensioni - elaborazione batch efficiente con cursori lato server
• Conservazione del formato - mantiene la formattazione originale dei dati dove possibile
• Transazione singola - tutte le modifiche vengono commesse atomicamente o annullate
• Estensibile - definisci pattern personalizzati utilizzando formati di data, numero o maschera

Avvio Rapido

Anonymizer ti consente di creare un set di dati sperimentale che preserva la forma e l'integrità di un database Postgres in soli tre passaggi:

1. Crea un file di configurazione che specifica i pattern di sostituzione per le tue colonne.
2. Compila ed esegui pgedge-anonymizer per convertire le tue colonne.
3. Esamina i risultati.

Prima di eseguire pgedge-anonymizer, devi creare un file di configurazione denominato pgedge-anonymizer.yaml; il file deve contenere:

• una sezione database, con i dettagli di connessione per il tuo database.
• una sezione columns, che elenca le colonne completamente qualificate che desideri anonimizzare (nel formato schema_name.table_name.column_name).
• le proprietà patterns per ogni colonna che specificano la forma che il contenuto sostitutivo assumerà.

Per esempio:

database:
  host: localhost
  port: 5432
  database: myapp
  user: anonymizer

columns:
  - column: public.users.email
    pattern: EMAIL

  - column: public.users.phone
    pattern: US_PHONE

  - column: public.users.ssn
    pattern: US_SSN

Dopo aver creato un file di configurazione, esegui l'anonymizer:

pgedge-anonymizer run

Esamina l'elenco delle modifiche mentre pgedge-anonymizer viene eseguito, mostrando le statistiche:

Processing public.users.email (est. 50000 rows)...
  10000 rows processed
  20000 rows processed
  30000 rows processed
  40000 rows processed
  50000 rows processed
  Completed: 50000 rows, 48234 values anonymized

=== Anonymization Statistics ===
Total columns processed: 1
Total rows processed:    50000
Total values anonymized: 48234
Total duration:          2.34s
Throughput:              21367 rows/sec

Note per gli Sviluppatori

Prerequisiti

• Go 1.24 o successivo
• PostgreSQL (per test di integrazione)
• Python 3.12+ (per documentazione)

Usa il seguente comando per compilare pgedge-anonymizer:

make build        # Build binary

Usa il seguente comando per eseguire la suite di test di Anonymizer:

make test

Usa il seguente comando per eseguire il Go Linter:

make lint

Usa il seguente comando per formattare il codice:

make fmt

Supporto

• Problemi su GitHub
• La documentazione completa è disponibile sul sito web pgEdge.

Licenza

Questo progetto è concesso in licenza secondo la Licenza PostgreSQL.