Zum Inhalt springen
← Back to Docs

Pseudonyme

Pseudonymize.io ersetzt erkannte Entitäten durch deterministische Alias-Strings namens Pseudonyme.

Was es bedeutet

Ein Pseudonym ist ein strukturierter Alias, der den semantischen Typ der ursprünglichen Entität beibehält, aber die ursprünglichen sensiblen Informationen zerstört.

Beispiel:

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

Warum es existiert

Eine generische Schwärzung (z. B. das Ersetzen aller Namen durch „[PERSON]“) zerstört alle Beziehungen innerhalb einer Nutzlast. Bei der Pseudonymisierung bleibt die Identitätszuordnung erhalten, sodass nachgelagerte Systeme (wie LLMs oder Analyse-Engines) Aktionen derselben Entität gruppieren können, ohne zu wissen, wer diese Entität ist.

Genaues Verhalten

  • Sequentielle Zuordnung: Innerhalb eines einzelnen Anforderungsbereichs wird die erste erkannte E-Mail zu „EMAIL_01“, die zweite eindeutige E-Mail wird zu „EMAIL_02“ und so weiter.
  • Typspezifisch: Pseudonyme tragen immer ein Präfix, das den Entitätstyp angibt (z. B. „PERSON_“, „ORG_“, „EMAIL_“).
  • Stabilität: Pseudonyme sind innerhalb einer einzigen API-Anfrage (Standardbereich) absolut stabil. Weitere Informationen zur anforderungsübergreifenden Stabilität finden Sie unter Scopes und Determinismus.
  • Kollisionen: Aufgrund des deterministischen HMacing (sofern aktiviert) sind Kollisionen zwischen unterschiedlichen Quellidentitäten mathematisch unwahrscheinlich.
  • Reihenfolgeverlust: Sequentielle Aliase (_01, _02) führen dazu, dass die Reihenfolge des Auftretens in einem bestimmten Dokument verloren geht. Dies ist normalerweise für den LLM-Kontext akzeptabel, kann jedoch über eine Richtlinie deaktiviert werden, wenn strikte Transparenz erforderlich ist.

API-Parameter

Sie können das Pseudonymformat in Ihrer Richtliniennutzlast konfigurieren:

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