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.

ScriptScenarioCosa resta
Test-InboundPayload.ps1analisi a vuoto, verbosaniente: non scrive nulla
Protect-InboundForLlm.ps1payload da sottoporre a un LLMpseudonimi validi e correlati, nessuna mappa
Protect-InboundWithMapping.ps1come sopra, ma la risposta va riportata sui dati verianche la chiave di re-identificazione
Protect-InboundIrreversible.ps1dataset da archiviare o consegnare[REDACTED:...] / ********, nessuna correlazione
Protect-InboundInPlace.ps1file già depositati, il percorso non deve cambiarel’originale sovrascritto, più la copia .bak
Protect-InboundBatch.ps1intera cartella, XML e JSON insiemeuna cartella anonimizzata, coerente fra i file
Show-XmlAnonRules.ps1regole attive, verifica interna— (non prende un file inbound)
New-XmlAnonSalt.ps1generazione del salt, una tantumil 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.