조직 수준 PII 마스킹 활성화
조직 관리자는 조직의 개인정보 보호 설정에서 Redact PII in Weave traces를 켤 수 있습니다. 이 설정을 켜면 Weave 서버는 새로 기록되는 Call 및 Agent OTel 데이터를 저장하기 전에 다음 항목을 마스킹합니다.- 이메일 주소
- 전화번호
- 미국 사회보장번호
Python SDK로 PII 마스킹하기
클라이언트 측 PII 마스킹은 Python에서만 사용할 수 있습니다.
- PII 마스킹을 켜는
redact_pii설정.weave.init()호출에서 활성화하거나 비활성화할 수 있습니다. redact_pii = True일 때 일반적인 엔티티 자동 마스킹redact_pii_fields설정을 통한 마스킹 필드 맞춤 구성redact_pii_exclude_fields설정을 통한 특정 엔티티의 마스킹 제외
PII 마스킹 활성화
이 섹션에서는 필요한 의존성을 설치하고,weave.init()에서 PII 마스킹을 활성화한 다음, 필요에 따라 Weave가 마스킹할 엔티티를 조정하는 방법을 안내합니다. Weave에서 Sensitive Data Protection 기능을 사용하려면 다음 단계를 완료하세요.
-
필요한 의존성을 설치합니다.
-
마스킹이 활성화되도록
weave.init()호출을 수정합니다.redact_pii=True로 설정하면 Weave는 일반적인 엔티티를 기본으로 마스킹합니다. -
선택 사항:
redact_pii_fields매개변수로 마스킹 필드를 사용자 지정합니다.감지 및 마스킹할 수 있는 엔티티의 전체 목록은 Presidio에서 지원하는 PII 엔티티를 참조하세요. -
선택 사항:
redact_pii_exclude_fields매개변수로 특정 엔티티를 마스킹 대상에서 제외합니다. 기본 마스킹은 유지하되 일부 엔티티 유형은 그대로 두고 싶을 때 유용합니다. 다음 예시는EMAIL_ADDRESS와PERSON을 제외한 모든 기본 엔티티를 마스킹하는 방법을 보여줍니다.
기본적으로 마스킹되는 엔티티
이 섹션에서는redact_pii_fields를 지정하지 않고 PII 마스킹을 활성화할 때 Weave가 자동으로 마스킹하는 PII 엔티티 유형을 소개합니다. PII 마스킹을 활성화하면 Weave는 다음 엔티티를 자동으로 마스킹합니다.
CREDIT_CARDCRYPTOEMAIL_ADDRESSES_NIFFI_PERSONAL_IDENTITY_CODEIBAN_CODEIN_AADHAARIN_PANIP_ADDRESSLOCATIONPERSONPHONE_NUMBERUK_NHSUK_NINOUS_BANK_NUMBERUS_DRIVER_LICENSEUS_PASSPORTUS_SSN
REDACT_KEYS로 민감한 키 마스킹하기
Weave SDK는 PII 마스킹 외에도 REDACT_KEYS를 사용한 맞춤형 키 마스킹을 지원합니다. 이 기능은 PII 범주에 속하지는 않지만 비공개로 유지해야 하는 기타 민감한 데이터를 보호하려는 경우에 유용합니다. 예시는 다음과 같습니다.
- API 키
- 인증 헤더
- 토큰
- 내부 ID
- 설정 값
사전 정의된 REDACT_KEYS
Weave는 기본적으로 다음과 같은 민감한 키를 자동으로 마스킹합니다.
자체 키 추가
애플리케이션에서 민감한 값이 담긴 다른 필드 이름을 사용한다면 기본REDACT_KEYS 목록을 확장할 수 있습니다. 트레이스에서 마스킹하려는 맞춤형 키를 직접 추가하세요.
client_id와 token의 값이 "REDACTED"로 표시됩니다.
사용 정보
- 이 기능은 Python SDK에서만 사용할 수 있습니다.
- 마스킹을 활성화하면 Presidio 의존성 때문에 처리 시간이 늘어납니다.