トレースから PII をマスクする

​

組織レベルで PII の秘匿化を有効にする

• メールアドレス
• 電話番号
• 米国社会保障番号

​

Python SDK で PII をマスクする

• redact_pii 設定: weave.init() の呼び出しで有効または無効にでき、有効にすると PII の秘匿化が行われます。
• redact_pii = True の場合に、一般的なエンティティ を自動的にマスキング。
• redact_pii_fields 設定で、マスキング対象のフィールドをカスタマイズ。
• redact_pii_exclude_fields 設定で、特定のエンティティをマスキング対象から除外。

​

PII の秘匿化を有効にする

1. 必要な依存関係をインストールします。
   pip install presidio-analyzer presidio-anonymizer
   
2. weave.init() の呼び出しを変更して、マスキングを有効にします。redact_pii=True を指定すると、Weave は一般的なエンティティをデフォルトでマスクします。
   import weave
   
   weave.init("my-project", settings={"redact_pii": True})
   
3. オプション: redact_pii_fields パラメーターを使用して、マスキング対象のフィールドをカスタマイズします。
   weave.init("my-project", settings={"redact_pii": True, "redact_pii_fields":["CREDIT_CARD", "US_SSN"]})
   
   検出およびマスクできるエンティティの一覧については、Presidio でサポートされる PII エンティティを参照してください。
4. オプション: redact_pii_exclude_fields パラメーターを使用して、特定のエンティティをマスキングから除外します。デフォルトのマスキングは維持しつつ、一部のエンティティタイプはそのまま残したい場合に便利です。次の例では、EMAIL_ADDRESS と PERSON を除くすべてのデフォルトのエンティティをマスクします。
   weave.init("my-project", settings={"redact_pii": True, "redact_pii_exclude_fields":["EMAIL_ADDRESS", "PERSON"]})
   

​

デフォルトでマスクされるエンティティ

• CREDIT_CARD
• CRYPTO
• EMAIL_ADDRESS
• ES_NIF
• FI_PERSONAL_IDENTITY_CODE
• IBAN_CODE
• IN_AADHAAR
• IN_PAN
• IP_ADDRESS
• LOCATION
• PERSON
• PHONE_NUMBER
• UK_NHS
• UK_NINO
• US_BANK_NUMBER
• US_DRIVER_LICENSE
• US_PASSPORT
• US_SSN

​

REDACT_KEYS で機密キーをマスクする

• APIキー
• 認証ヘッダー
• トークン
• 内部 ID
• 設定値

​

事前定義された REDACT_KEYS

[
  "api_key",
  "auth_headers",
  "authorization"
]

​

独自のキーを追加する

import weave
from weave.utils import sanitize

client = weave.init("my-project", settings={"redact_pii": True})

# マスク対象のカスタムキーを追加
sanitize.add_redact_key("client_id")
sanitize.add_redact_key("token")

client_id = "123"
token = "789"

@weave.op
def test(client_id, token):
    return client_id + token

test(client_id, token)

client_id = "REDACTED"
token = "REDACTED"

​

使用上の注意

• この機能は Python SDK でのみ使用できます。
• マスキングを有効にすると、Presidio に依存するため処理時間が長くなります。