Skip to content

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) はこのサイト自身のオリジンです。他のサイトのフレーム内ではカメラもマイクも許可しません。親ページがカメラを拒否していると、このサイトのフレームもブロックされます。通話ページはトップレベルの文書である必要があります。

text
acme-marketing の Permissions-Policy を、このオリジンがカメラとマイクを要求できるようにし、位置情報、決済、USB、interest cohort は拒否のままにして。すでに設定されているヘッダーは残して。
bash
edge api PATCH /v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38 --input - <<'EOF'
{
        "headers": {
          "permissions-policy": "camera=(self), microphone=(self), geolocation=(), payment=(), usb=(), interest-cohort=()"
        }
      }
EOF
bash
curl -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 を設定しない場合、プラットフォームの基準が残り、カメラとマイクも拒否されます。