アナリティクスプロパティを保護する
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 に固定されています。
実効ポリシーを確認する
acme-marketing の PII 検出器を一覧し、検出器ごとの解決済みポリシーを見せ、
直近 7 日に block および redact されたプロパティを報告して。エージェントは edge_pii_detector_list、edge_pii_policy_get、edge_pii_report を実行します。 解決済みポリシーは、各モードが exemption、distribution、 namespace、default のどれから来たかを示します。
同等の読み取りは次のとおりです。
GET /v1/pii-detectorsGET /v1/distributions/{id}/pii-policyGET /v1/distributions/{id}/pii-report?from=…&to=…
distribution ポリシーを設定する
acme-marketing で、メールアドレスとして一致した値を redact して。
理由は "Support form reporting without retaining addresses" と記録して。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"
}
EOFcurl -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 を含められます。
{
"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 です。取り消し自体も監査されます。
例外を足すより、ページが送る内容を変える方を優先してください。ポリシーは保存済みアナリティクスを守りますが、不要な個人データを集めてよい設計にはなりません。