Pular para o conteúdo
← Back to Docs

Pseudônimos

Pseudonymize.io substitui entidades detectadas por strings de alias determinísticas chamadas pseudônimos.

O que significa

Um pseudônimo é um alias estruturado que retém o tipo semântico da entidade original, mas destrói as informações confidenciais originais.

Exemplo:

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

Por que existe

A redação genérica (como substituir todos os nomes por [PERSON]) destrói todos os relacionamentos dentro de uma carga útil. A pseudonimização retém o mapeamento de identidade para que sistemas downstream (como LLMs ou mecanismos analíticos) possam agrupar ações pela mesma entidade sem saber quem é essa entidade.

Comportamento exato

  • Mapeamento sequencial: dentro de um único escopo de solicitação, o primeiro e-mail detectado se torna EMAIL_01, o segundo e-mail distinto se torna EMAIL_02 e assim por diante.
  • Específico do tipo: Pseudônimos sempre carregam um prefixo que indica o tipo de entidade (por exemplo, PERSON_, ORG_, EMAIL_).
  • Estabilidade: Os pseudônimos são estritamente estáveis ​​dentro de uma única solicitação de API (o escopo padrão). Consulte Escopos e Determinismo para estabilidade de solicitações cruzadas.
  • Colisões: Devido ao HMacing determinístico (quando ativado), as colisões entre identidades de origem distintas são matematicamente improváveis.
  • Vazamento de pedidos: Aliases sequenciais (_01, _02) vazam a ordem de aparecimento em um documento específico. Isso geralmente é aceitável para o contexto LLM, mas pode ser desabilitado por meio de política se for necessária opacidade estrita.

Parâmetros da API

Você pode configurar o formato de pseudônimo na carga útil da sua política:

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