Passer au contenu
← Back to Docs

Pseudonymes

Pseudonymize.io remplace les entités détectées par des chaînes d'alias déterministes appelées pseudonymes.

Qu'est-ce que cela signifie

Un pseudonyme est un alias structuré qui conserve le type sémantique de l'entité d'origine mais détruit les informations sensibles d'origine.

Exemple:

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

Pourquoi ça existe

La rédaction générique (comme le remplacement de tous les noms par « [PERSON] ») détruit toutes les relations au sein d'une charge utile. La pseudonymisation conserve le mappage d'identité afin que les systèmes en aval (comme les LLM ou les moteurs d'analyse) puissent regrouper les actions d'une même entité sans savoir qui est cette entité.

Comportement exact

  • Mappage séquentiel : Dans la portée d'une seule requête, le premier e-mail détecté devient « EMAIL_01 », le deuxième e-mail distinct devient « EMAIL_02 », et ainsi de suite.
  • Spécifique au type : Les pseudonymes portent toujours un préfixe indiquant le type d'entité (par exemple, PERSON_, ORG_, EMAIL_).
  • Stabilité : Les pseudonymes sont strictement stables au sein d'une seule requête API (la portée par défaut). Voir Scopes et Determinism pour la stabilité des demandes croisées.
  • Collision : En raison du HMacing déterministe (lorsqu'il est activé), les collisions entre des identités sources distinctes sont mathématiquement improbables.
  • Fuite d'ordre : Les alias séquentiels (_01, _02) divulguent l'ordre d'apparition dans un document spécifique. Ceci est généralement acceptable pour le contexte LLM, mais peut être désactivé via une stratégie si une opacité stricte est requise.

Paramètres de l'API

Vous pouvez configurer le format de pseudonyme dans la charge utile de votre stratégie :

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