Przejdź do zawartości
← Back to Docs

Pseudonimy

Pseudonymize.io zastępuje wykryte jednostki deterministycznymi ciągami aliasów zwanymi pseudonimami.

Co to znaczy

Pseudonim to ustrukturyzowany alias, który zachowuje typ semantyczny pierwotnej jednostki, ale niszczy oryginalne poufne informacje.

Przykład:

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

Dlaczego istnieje

Redakcja ogólna (np. zastąpienie wszystkich nazw przez „[PERSON]”) niszczy wszystkie relacje w ładunku. Pseudonimizacja zachowuje mapowanie tożsamości, więc późniejsze systemy (takie jak LLM lub silniki analityczne) mogą grupować działania według tego samego podmiotu, nie wiedząc, kim jest ten podmiot.

Dokładne zachowanie

  • Mapowanie sekwencyjne: w zakresie pojedynczego żądania pierwszy wykryty e-mail to „EMAIL_01”, drugi odrębny e-mail to „EMAIL_02” i tak dalej.
  • Specyficzne dla typu: Pseudonimy zawsze zawierają przedrostek wskazujący typ jednostki (np. PERSON_, ORG_, EMAIL_).
  • Stabilność: Pseudonimy są ściśle stabilne w ramach jednego żądania API (zakres domyślny). Zobacz Zakresy i Determinizm, aby uzyskać stabilność między żądaniami.
  • Kolizje: Ze względu na deterministyczne HMacing (jeśli jest włączone), kolizje pomiędzy różnymi tożsamościami źródłowymi są matematycznie nieprawdopodobne.
  • Wyciek kolejności: Aliasy sekwencyjne (_01, _02) przeciekają w kolejności występowania w konkretnym dokumencie. Jest to zwykle akceptowalne w kontekście LLM, ale można je wyłączyć za pomocą zasad, jeśli wymagana jest ścisła nieprzezroczystość.

Parametry API

Możesz skonfigurować format pseudonimu w pakiecie zasad:

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