仮名

Pseudonymize.io は、検出されたエンティティを pseudononyms と呼ばれる決定的なエイリアス文字列に置き換えます。

それが意味するもの

ペンネームは、元のエンティティの意味論的なタイプを保持しながら、元の機密情報を破壊する構造化されたエイリアスです。

例：

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

存在理由

一般的な編集 (すべての名前を「[PERSON]」 に置き換えるなど) を行うと、ペイロード内のすべての関係が破壊されます。 仮名化では ID マッピングが保持されるため、下流システム (LLM や分析エンジンなど) は、エンティティが誰であるかを知らなくても、同じエンティティによるアクションをグループ化できます。

正確な動作

• シーケンシャル マッピング: 単一のリクエスト スコープ内では、最初に検出された電子メールは EMAIL_01 になり、2 番目の個別の電子メールは EMAIL_02 になります。
• タイプ固有: ペンネームには常にエンティティ タイプを示すプレフィックスが付きます (例: PERSON_、ORG_、EMAIL_)。
• 安定性: ペンネームは 単一の API リクエスト内 (デフォルトの範囲) 内で厳密に安定しています。 クロスリクエストの安定性については、スコープ および 決定論 を参照してください。
• 衝突: 決定論的な HMacing (有効な場合) により、異なるソース ID 間の衝突は数学的に起こりそうにありません。
• 順序の漏洩: 連続したエイリアス (_01、_02) によって、特定のドキュメント内の出現順序が漏洩します。 これは通常、LLM コンテキストでは許容されますが、厳密な不透明性が必要な場合はポリシーによって無効にすることができます。

APIパラメータ

ポリシー ペイロードで仮名形式を構成できます。

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