본문으로 건너뛰기
← Back to Docs

가명

Pseudonymize.io는 감지된 엔터티를 가명이라는 결정적 별칭 문자열로 바꿉니다.

의미

가명은 원래 엔터티의 의미 유형을 유지하지만 원래의 민감한 정보를 파괴하는 구조화된 별칭입니다.

예:

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

존재하는 이유

일반 수정(예: 모든 이름을 [PERSON]으로 대체)은 페이로드 내의 모든 관계를 파괴합니다. 가명처리는 ID 매핑을 유지하므로 다운스트림 시스템(예: LLM 또는 분석 엔진)은 해당 엔터티가 누구인지 알지 못한 채 동일한 엔터티별로 작업을 그룹화할 수 있습니다.

정확한 행동

  • 순차 매핑: 단일 요청 범위 내에서 처음으로 감지된 이메일은 'EMAIL_01'이 되고, 두 번째 고유 이메일은 'EMAIL_02'가 되는 식입니다.
  • 유형별: 가명에는 항상 항목 유형을 나타내는 접두사가 붙습니다(예: PERSON_, ORG_, EMAIL_).
  • 안정성: 가명은 단일 API 요청(기본 범위) 내에서 엄격하게 안정적입니다. 요청 간 안정성은 범위 및 결정론을 참조하세요.
  • 충돌: 결정론적 HMacing(활성화된 경우)으로 인해 고유한 소스 ID 간의 충돌은 수학적으로 불가능합니다.
  • 순서 누출: 순차 별칭(_01, _02)은 특정 문서에 나타나는 순서를 누출합니다. 이는 일반적으로 LLM 컨텍스트에 허용되지만 엄격한 불투명도가 필요한 경우 정책을 통해 비활성화할 수 있습니다.

API 매개변수

정책 페이로드에서 가명 형식을 구성할 수 있습니다.

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