Permissions-Policy
Edge が配信するすべてのページは、カメラ、マイク、位置情報、決済、USB、interest cohort を拒否する Permissions-Policy から始まります。getUserMedia を呼ぶページは、このヘッダーを置き換える必要があります。ブラウザは、カメラやマイクをオンにする前に訪問者へ確認します。
Web アプリではレスポンスヘッダーを編集できません。エージェントに頼むか、API でヘッダーを送ってください。エージェントは edge_distribution_update を実行します。この呼び出しはすぐに検証され、deployment を作成します。その deployment を promote するまで、訪問者には以前のヘッダーが届きます。
GET /v1/distributions/{id}/header-check(edge_header_check)は保存済みのヘッダーを表示するだけで、変更はしません。
headers オブジェクトは全体が置き換わります。残したいレスポンスヘッダーはすべて含めてください。リダイレクトやアクセス設定など、他の設定はそのままです。
許可される値
ヘッダー全体を送ってください。短いポリシーは拒否されます。省略した機能は拒否ではなく、ブラウザの既定に戻るためです。機能の順序は問いません。
このオリジンのマイクを許可し、カメラは拒否:
camera=(), microphone=(self), geolocation=(), payment=(), usb=(), interest-cohort=()このオリジンのカメラとマイクを許可:
camera=(self), microphone=(self), geolocation=(), payment=(), usb=(), interest-cohort=()(self) はこのサイト自身のオリジンです。他のサイトのフレーム内ではカメラもマイクも許可しません。親ページがカメラを拒否していると、このサイトのフレームもブロックされます。通話ページはトップレベルの文書である必要があります。
acme-marketing の Permissions-Policy を、このオリジンがカメラとマイクを要求できるようにし、位置情報、決済、USB、interest cohort は拒否のままにして。すでに設定されているヘッダーは残して。edge api PATCH /v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38 --input - <<'EOF'
{
"headers": {
"permissions-policy": "camera=(self), microphone=(self), geolocation=(), payment=(), usb=(), interest-cohort=()"
}
}
EOFcurl -s -X PATCH \
https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38 \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"headers": {
"permissions-policy": "camera=(self), microphone=(self), geolocation=(), payment=(), usb=(), interest-cohort=()"
}
}'更新が返す deployment を promote してから、公開中のサイトを確認してください。
拒否される値
| 値 | 理由 |
|---|---|
camera=* または microphone=* | すべてのオリジンを許可する |
camera=(self "https://other.example") | このサイト以外のオリジンを許可する |
microphone=() | このヘッダーを設定するとき、マイクは (self) のまま |
microphone=(self) だけ | 省略した機能は拒否にならない |
geolocation=(self)、payment=(self)、usb=(self) | これらの機能は拒否のまま |
Set-Cookie | ヘッダーの許可リストにない |
distribution が permissions-policy を設定しない場合、プラットフォームの基準が残り、カメラとマイクも拒否されます。