Skip to content

アナリティクスプロパティを保護する ​

Edge はアナリティクスプロパティのキーと値を、メールアドレス、電話番号、決済カード、公的 ID、JWT、PII らしいキー名について検査します。

このポリシーはエージェント、CLI、または API で管理し、admin のみです(pii.read / pii.policy.write)。コンソールに Security エディタはまだありません。publisher と manager のトークンでは変更できません。

モードを理解する ​

  • block — 元の値は保持されず、アナリティクスには (blocked) と見えます。
  • redact — アナリティクスは元の値の代わりに (redacted) を保持します。
  • allow — 元の値をアナリティクスに渡せます。

既定は block です。名前空間のポリシーは、その下の distribution の上限になります。 埋め込み distribution(embed_script と embed_iframe)は redact より緩くできません。 決済カードと公的 ID の検出器は block に固定されています。

実効ポリシーを確認する ​

text
acme-marketing の PII 検出器を一覧し、検出器ごとの解決済みポリシーを見せ、
直近 7 日に block および redact されたプロパティを報告して。

エージェントは edge_pii_detector_list、edge_pii_policy_get、edge_pii_report を実行します。 解決済みポリシーは、各モードが exemption、distribution、 namespace、default のどれから来たかを示します。

同等の読み取りは次のとおりです。

  • GET /v1/pii-detectors
  • GET /v1/distributions/{id}/pii-policy
  • GET /v1/distributions/{id}/pii-report?from=…&to=…

distribution ポリシーを設定する ​

text
acme-marketing で、メールアドレスとして一致した値を redact して。
理由は "Support form reporting without retaining addresses" と記録して。
bash
edge api PUT /v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/pii-policy --input - <<'EOF'
{
        "detector_key": "email",
        "mode": "redact",
        "reason": "Support form reporting without retaining addresses"
      }
EOF
bash
curl -s -X PUT \
  https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/pii-policy \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "detector_key": "email",
        "mode": "redact",
        "reason": "Support form reporting without retaining addresses"
      }'

エージェントは edge_pii_policy_set を実行します。block から離れるには理由が必要で、 名前空間、検出器、埋め込みの上限を超えられません。ポリシー変更は監査されます。

狭い例外を設ける ​

exemption は 1 つのプロパティと 1 つの検出器に適用されます。理由は必須で、 expires_at を含められます。

json
{
  "property_key": "support_contact_type",
  "detector_key": "key_name",
  "mode": "allow",
  "reason": "Enum contains no contact details",
  "expires_at": "2026-12-31T00:00:00Z"
}

このボディを POST /v1/distributions/{id}/pii-exemptions に送るか、エージェントに edge_pii_exemption_create を実行させてください。固定された検出器には exemption を付けられません。exemption の取り消しは DELETE /v1/distributions/{id}/pii-exemptions または edge_pii_exemption_revoke です。取り消し自体も監査されます。

例外を足すより、ページが送る内容を変える方を優先してください。ポリシーは保存済みアナリティクスを守りますが、不要な個人データを集めてよい設計にはなりません。

次に読む ​