Salta al contenuto
← Back to Docs

Pseudonimi

Pseudonymize.io sostituisce le entità rilevate con stringhe alias deterministiche chiamate pseudonimi.

Cosa significa

Uno pseudonimo è un alias strutturato che conserva il tipo semantico dell'entità originale ma distrugge le informazioni sensibili originali.

Esempio:

[email protected] → EMAIL_01
[email protected]   → EMAIL_02

Perché esiste

La redazione generica (come la sostituzione di tutti i nomi con [PERSON]) distrugge tutte le relazioni all'interno di un payload. La pseudonimizzazione mantiene la mappatura dell'identità in modo che i sistemi downstream (come LLM o motori di analisi) possano raggruppare azioni della stessa entità senza sapere chi sia tale entità.

Comportamento esatto

  • Mappatura sequenziale: Nell'ambito di una singola richiesta, la prima email rilevata diventa "EMAIL_01", la seconda email distinta diventa "EMAIL_02" e così via.
  • Specifico per tipo: Gli pseudonimi portano sempre un prefisso che indica il tipo di entità (ad esempio, PERSON_, ORG_, EMAIL_).
  • Stabilità: gli pseudonimi sono rigorosamente stabili all'interno di una singola richiesta API (l'ambito predefinito). Consulta Ambiti e Determinismo per la stabilità delle richieste incrociate.
  • Collisioni: A causa dell'HMacing deterministico (se abilitato), le collisioni tra identità di origine distinte sono matematicamente improbabili.
  • Perdita di ordine: Gli alias sequenziali (_01, _02) trapelano l'ordine di apparizione in un documento specifico. Questo è generalmente accettabile per il contesto LLM, ma può essere disabilitato tramite policy se è richiesta un'opacità rigorosa.

Parametri API

Puoi configurare il formato dello pseudonimo nel payload della policy:

{
  "policy": {
    "alias_format": "sequential" // or "hash"
  }
}