跳转到主要内容
← Back to Docs

化名

Pseudonymize.io 使用名为 pseudonyms 的确定性别名字符串替换检测到的实体。

这意味着什么

假名是一种结构化别名,保留了原始实体的语义类型,但破坏了原始敏感信息。

例子:

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

为什么它存在

通用编辑(例如用“[PERSON]”替换所有名称)会破坏有效负载中的所有关系。 假名化保留了身份映射,因此下游系统(例如法学硕士或分析引擎)可以对同一实体的操作进行分组,而无需知道该实体是谁。

确切的行为

  • 顺序映射: 在单个请求范围内,第一个检测到的电子邮件变为“EMAIL_01”,第二个不同的电子邮件变为“EMAIL_02”,依此类推。
  • 特定于类型: 假名始终带有指示实体类型的前缀(例如,“PERSON_”、“ORG_”、“EMAIL_”)。
  • 稳定性: 假名在单个 API 请求内**严格稳定(默认范围)。 请参阅 Scopes 和 Determinism 了解跨请求稳定性。
  • 冲突: 由于确定性 HMacing(启用时),不同源身份之间的冲突在数学上是不可能的。
  • 顺序泄漏: 顺序别名(_01、_02)泄漏特定文档中出现的顺序。 这对于 LLM 上下文来说通常是可以接受的,但如果需要严格的不透明度,可以通过策略禁用。

API 参数

您可以在策略负载中配置假名格式:

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