Tool a riga di comando per anonimizzazione e pseudonimizzazione di file XML e JSON secondo i dettami del GDPR.
Uno script per scenario, tutti con il file inbound come primo parametro posizionale.
| Script | Scenario | Cosa resta |
|---|---|---|
Test-InboundPayload.ps1 | analisi a vuoto, verbosa | niente: non scrive nulla |
Protect-InboundForLlm.ps1 | payload da sottoporre a un LLM | pseudonimi validi e correlati, nessuna mappa |
Protect-InboundWithMapping.ps1 | come sopra, ma la risposta va riportata sui dati veri | anche la chiave di re-identificazione |
Protect-InboundIrreversible.ps1 | dataset da archiviare o consegnare | [REDACTED:...] / ********, nessuna correlazione |
Protect-InboundInPlace.ps1 | file già depositati, il percorso non deve cambiare | l’originale sovrascritto, più la copia .bak |
Protect-InboundBatch.ps1 | intera cartella, XML e JSON insieme | una cartella anonimizzata, coerente fra i file |
Show-XmlAnonRules.ps1 | regole attive, verifica interna | — (non prende un file inbound) |
New-XmlAnonSalt.ps1 | generazione del salt, una tantum | il salt negli appunti, mai a video — (non prende un file inbound) |
Prima di usarli
Gli scripts vanno eseguiti da un terminale PowerShell dalla versione 5.1.
Per abilitare il terminale ad eseguire scripts PowerShell impartire necessariamente il seguente comando:Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
Gli script cercano l’eseguibile xmlanon.exe in quest’ordine:
parametro -ToolPath > variabile XMLANON_EXE > bin\xmlanon.exe > .\xmlanon.exe > xmlanon nel PATH.
Il giro tipico
# 1. capire cosa verrebbe toccato, e soprattutto cosa no
.\Test-InboundPayload.ps1 ..\samples\pratica.xml
# 2. coprire i campi che i detector non intercettano (testo libero)
.\Test-InboundPayload.ps1 ..\samples\pratica.xml -ExtraPath '//Note=FreeText:Redact'
# 3. produrre il payload da dare al modello
$env:XMLANON_SALT = '<segreto>'
.\Protect-InboundForLlm.ps1 ..\samples\pratica.xml -ExtraPath '//Note=FreeText:Redact'
Il passo 1 non è un formalismo: i detector prendono identificatori strutturati (codice
fiscale, IBAN, email), non un nome scritto in mezzo a una frase. <Note>ho parlato con l'ing. Bianchi</Note> passa intatto, e nei tracciati reali è proprio lì che si annidano i
nomi.
Salt
Gli scripts Protect-* accettano -Salt, ma il valore finisce nella riga di comando ed è quindi
visibile nell’elenco dei processi. Su macchine condivise conviene lasciarlo fuori e
impostare XMLANON_SALT (o Salt nell’appsettings.json): la precedenza è--salt > appsettings.json > variabile d’ambiente.
Per generare un salt, utilizzare New-XmlAnonSalt.ps1; ne crea uno da 256 bit con il generatore
crittografico del sistema e lo copia negli appunti senza stamparlo a video:
Se la cronologia degli appunti di Windows (Win+V) è attiva, il salt vi resta: conviene
svuotarla dopo averlo incollato.
Cambiando il salt cambia tutta la mappatura: due esecuzioni con salt diversi producono
pseudonimi diversi per lo stesso valore, e la correlazione fra i due risultati si perde.
Report
Gli scripts Protect-* scrivono per default un report JSON accanto all’output, con l’estensione del
payload nel nome (pratica.anon.xml.report.json, pratica.anon.json.report.json).
Si disattiva con -NoReport. Il report contiene il path del nodo, la categoria, l’azione,
la regola che ha deciso e solo un’impronta breve del valore originale, quindi è
archiviabile e condivisibile.
La mappa di Protect-InboundWithMapping.ps1 contiene invece i valori originali.
Va nella sottocartella keys\, con i permessi ristretti all’utente corrente, e
non deve mai viaggiare insieme al payload anonimizzato né avvicinarsi al prompt. Finché
esiste, quella è pseudonimizzazione e non anonimizzazione: i dati restano personali
(considerando 26 GDPR).
Più file
Per una cartella c’è Protect-InboundBatch.ps1, ed è preferibile a un ciclo su più
esecuzioni: una sola esecuzione condivide lo stesso ValueTransformer fra i due motori,
ed è questo che fa coincidere gli pseudonimi fra un XML e un JSON elaborati insieme.
.\Protect-InboundBatch.ps1 ..\samples
# in samples_anon\ Rossi diventa lo stesso cognome finto nel .xml e nel .json,
# con lo stesso codice fiscale, lo stesso IBAN e la stessa email
Codici di uscita
Gli script restituiscono quello del tool: 0 completato, 1 errore su uno o più file
(gli altri proseguono comunque), 2 argomenti o configurazione non validi.