Feature-Policy

HTTP の Feature-Policy ヘッダーは、自身のフレームおよび文書内の <iframe> 要素で、ブラウザーの機能を使用することを許可または拒否する仕組みを提供します。

詳しくは、機能ポリシーの記事を参照してください。

構文

Feature-Policy: <directive> <allowlist>

<allowlist>

許可リストは、以下の値のうち一つを取るオリジンのリストです。

• *: この機能は既定で、最上位の閲覧コンテキストと、含まれるすべての閲覧コンテキスト (iframe) で許可されます。
• 'self': (既定値) この機能は既定で、最上位の閲覧コンテキストと、含まれる同じオリジンの閲覧コンテキスト (iframe) で許可されます。この機能は、含まれる閲覧コンテキストにある別なオリジンの文書では許可されません。
• 'none': この機能は最上位および含まれる閲覧コンテキストで無効になります。
• <origin(s)>: この機能は特定のオリジン (例えば、 https://example.com) で許可されます。オリジンは空白で区切ってください。

* の値 (すべてのオリジンで有効) または 'none' (すべてのオリジンで無効) は単独でのみ使用できますが、 'self' は一つ以上のオリジンと一緒に使用することができます。

ディレクティブ

ambient-light-sensor

現在の文書が、端末の周囲の環境における光量についての情報を、 AmbientLightSensor インターフェイスを通じて収集することを許可するかどうかを制御します。

autoplay

現在の文書で HTMLMediaElement インターフェイスによってメディアの自動再生をリクエストすることを許可するかどうかを制御します。このポリシーが有効であり、ユーザーによる操作がなかった場合、 HTMLMediaElement.play() から返却された Promise が DOMException で拒否されます。 <audio> および <video> 要素の autoplay 属性は無視されます。

accelerometer

現在の文書が、端末の加速度に関する情報を、 Accelerometer インターフェイスを通じて収集することを許可するかどうかを制御します。

camera

現在の文書が動画入力機器を使用することを許可するかどうかを制御します。このポリシーが有効であれば、 getUserMedia() から返却された Promise が NotAllowedError で拒否されます。

display-capture

現在の文書が getDisplayMedia() メソッドを使用して画面の内容をキャプチャすることを許可するかどうかを制御します。このポリシーが有効であれば、表示内容をキャプチャする許可がない場合、 getDisplayMedia() から返却される Promise が NotAllowedError で拒否されます。

document-domain

現在の文書が document.domain を設定することを許可するかどうかを制御します。このポリシーが有効な場合、 document.domain を設定しようとすると失敗し、 SecurityError の DOMException が発生します。

encrypted-media

現在の文書が Encrypted Media Extensions API (EME) を使用することを許可するかどうかを制御します。このポリシーが有効であれば、 Navigator.requestMediaKeySystemAccess() から返却された Promise が DOMException で拒否されます。

fullscreen

現在の文書が Element.requestFullScreen() を使用することを許可するかどうかを制御します。このポリシーが有効であれば、返却された Promise が TypeError で拒否されます。

geolocation

現在の文書が Geolocation インターフェイスを使用することを許可するかどうかを制御します。このポリシーが有効であれば、 getCurrentPosition() および watchPosition() を呼び出すと、関数のコールバックが呼び出され、 PositionError コードが PERMISSION_DENIED になります。

gyroscope

現在の文書が Gyroscope インターフェイスを通じて、端末の方向に関する情報を収集することを許可するかどうかを制御します。

magnetometer

現在の文書が Magnetometer インターフェイスを通じて、端末の方向に関する情報を収集することを許可するかどうかを制御します。

microphone

現在の文書がオーディオ入力端末を使用することを許可するかどうかを制御します。このポリシーが有効であれば、 MediaDevices.getUserMedia() で返却された Promise が NotAllowedError で拒否されます。

midi

現在の文書が Web MIDI API を使用することを許可するかどうかを制御します。このポリシーが有効であれば、 Navigator.requestMIDIAccess() から返却された Promise が DOMException で拒否されます。

payment

現在の文書が Payment Request API を使用することを許可するかどうかを制御します。このポリシーが有効であれば、 PaymentRequest() コンストラクターが SecurityError の DOMException を発生させます。

picture-in-picture

現在の文書が、該当する API を使用して Picture-in-Picture モードで動画を再生することを許可するかどうかを制御します。

speaker

現在の文書が何らかのメソッドで音声を再生することを許可するかどうかを制御します。

sync-xhr

現在の文書が同期 XMLHttpRequest リクエストを行うことを許可するかどうかを制御します。

usb

現在の文書が WebUSB API を使用することを許可するかどうかを制御します。

wake-lock

現在の文書が Wake Lock API を使用して、端末が省電力モードに入らないことを示すことを許可するかどうかを制御します。

webauthn

現在の文書が Web Authentication API を使用して公開鍵資格情報を生成、格納、受け取りすることを許可するかどうかを制御します。

vr / xr

現在の文書が WebVR API を使用することを許可するかどうかを制御します。このポリシーが有効であれば、 Navigator.getVRDisplays() から返却された Promise が DOMException で拒否されます。

例

SecureCorp Inc. が、アプリケーションでバイブレーションと Geolocation API を無効にしたがっているとします。以下の機能ポリシーを設定する HTTP レスポンスヘッダーを配信することで実現できます。

Feature-Policy: vibrate 'none'; geolocation 'none'

オリジンのリストに 'none' キーワードを指定すると、指定された機能がオリジンに関係なく、すべての閲覧コンテキストで無効になります。

仕様書

ブラウザーの互換性

関連情報

• 機能ポリシー
• 機能ポリシーの使用
• Feature-Policy Tester (Chrome Developer Tools extension)
• Content-Security-Policy
• Referrer-Policy