仕様書

意味

[32] sandbox 属性は、 iframe 要素の中の内容に追加の制限を加えるものです >>31。

[36] 本属性が指定されていると、色々な制限が適用されます。 属性に値を指定することで、その制限の一部を緩和できます。

[38] 本属性の指定は、 navigate 時に適用されます。変更したり削除したりしても、 直ちに適用されるのではなく、次の navigate より適用されます。

[50] CSP の sandbox 指令は、保護対象資源に適用するべき制限を指定するものです >>48。 CSP では閲覧文脈ではなく、閲覧文脈内の文書単位で制限を適用します。 最上位閲覧文脈でも使うことができます。

[73] 祖先すべての閲覧文脈を含めた HTML sandbox 属性と CSP sandbox 指令の最も厳しい制限が適用されます。

属性名

[51] iframe 要素の属性名 >>31 も、 CSP の指令名 >>48 も、 sandbox です。

属性値

[33] iframe sandbox 属性値は、unordered set of unique space-separated tokens でなければなりません >>31。

[52] CSP sandbox 指令の値は、 空文字列か、1つ以上の字句を1つ以上の WSP で区切った列のいずれかでなければなりません >>48。

[34] 各値は、認められた値のいずれかでなければなりません。 ASCII大文字・小文字不区別です >>31。

[49] HTML Standard では、認められる値がすべて規定されているため、 一般的な構文は規定されていません。 CSP では、HTTP の字句であると構文を規定し >>48、 HTML で認められる値を使わなければならない >>48 と規定していますが、 HTML と違って同じ値の重複は禁止されていないようです。

砂箱化フラグ集合

[61] 砂箱化は、仕様書上はいくつかのフラグの集合として表されており、 これを砂箱化フラグ集合 (sandboxing flag set) >>57 といいます。

[62] 砂箱化の指定がない場合、砂箱化フラグ集合は空とされ、 砂箱化はまったく行われません。

[63] sandbox 属性 >>31 や sandbox 指令 >>48 などで砂箱化が指示されている場合、 parse a sandboxing directive >>31 操作により新たな砂箱化フラグ集合が作られます。 この操作では、明示的に除外することが指定されたフラグを除いたすべての砂箱化のフラグが設定されます。

[64] 属性値 >>31 や指令値 >>48 は、 間隔で分割しなければなりません。 その結果キーワードが含まれていれば、 次表の通り、フラグが設定されません。

[35] 次のフラグがあります。

[66] 砂箱化フラグ集合は、次の4箇所で使われています。

[76] 文書の色々な処理で実際に参照されるのは、このうちの active sandboxing flag set です。それ以外は、砂箱化の実装で active sandboxing flag set を決定するための入力として使われます。

[116] 活性砂箱化フラグ群を決定する手順群では、 合同 (union) 演算が行われます。

処理

[99] sandbox 属性は、入れ子閲覧文脈の閲覧文脈の作成が行われる際や、 属性変更手順群が呼び出された際に、処理されます。

[54] CSP sandbox 指令は、 monitoring の場合 (Content-Securiry-Policy-Report-Only) や meta 要素の場合、無視されます >>48。

[55] それ以外の場合、 enforce 時に指令の値を parse a sandboxing directive し、結果を保護対象資源の forced sandboxing flag set としなければなりません >>48。

[58] frame-ancestor 指令の制限対象となる場合には、 空文字列が指定された場合と同様に parse a sandboxing directive し、結果を保護対象資源の forced sandboxing flag set としなければなりません >>57。

[67] 閲覧文脈閲覧文脈とnavigateする資源について砂 (すな) 箱 (ばこ) 化 (か) フラグ群 (ぐん) を決 (けっ) 定 (てい) (determine sandboxing flags) するには、 次のようにします。 >>31

[111] 新しい閲覧文脈の作成や navigate から呼び出されます。

[120] この処理は、 iframe の sandbox 属性など、 適用対象となる sandbox の指定をすべて掛け合わせた結果を取得するものです。 フラグの合同ですから、すべての制限が適用されたもっとも厳しい制約となります。

[56] navigate ではなく run a Worker 時に enforce される場合は、 sandbox 指令が指定され allow-scripts が指定されていない時や、 sandbox 指令が指定され allow-same-origin が指定されておらず新しい実行文脈が同じ起源であることを求めている時には、 ネットワークエラーが返されたものとして扱わなければなりません >>48。

サーバー

[39] 危険かもしれないファイルを iframe の文書と同じサーバーから提供するべきではありません。 直接アクセスさせられると、 sandbox を回避してファイルが処理されてしまうからです。 被害を抑えるため、異なるドメインに分けて提供するべきです。 >>31

利用者インターフェイス

[78] Webブラウザーによっては、入れ子閲覧文脈の文書を最上位閲覧文脈で開くメニュー等の指示機能を利用者に提供しているかもしれません。 利用者は砂箱化されているものを、そうと気づかずに通常の閲覧文脈で開いてしまうかもしれず、 注意が必要です。 popup sandboxing flag set を活用するなど配慮が必要かもしれません。

HTMLIFrameElement インターフェイス sandbox 属性

[43] HTMLIFrameElement インターフェイスの sandbox IDL属性は、 sandbox 内容属性を反映しなければなりません >>31。

[44] 取得器は、 DOMSettableTokenList として反映します >>31。

[45] 設定器は、 value IDL属性に PutForwards されます >>31。

関連

[41] CSP の他の機能も更なる安全性の確保に有用かもしれません。

[42] 単一の文書の一部の内容のみを砂箱化することはできません。しかし iframe 要素の srcdoc 属性と併用すれば、そのような効果が得られます。

歴史

• [125] [whatwg] The <iframe> element and sandboxing ideas, 2024-09-20T16:18:32.000Z, 2024-09-28T01:22:39.913Z https://lists.whatwg.org/pipermail/whatwg-whatwg.org/2008-May/057147.html
• [126] [acgiow] (2) * Add <iframe sandbox>, which supports:, Hixie, 2008-05-21 09:30:41 +09:00, 2024-09-28T01:23:33.000Z https://github.com/whatwg/html/commit/68d989c9b4a1f06f0125d421ff3258f2405701cf
• [127] [] (0) <iframe seamless> -- clientside inclusion of HTML documents. P…, Hixie, 2008-05-20 08:26:09 +09:00, 2024-09-28T01:23:44.000Z https://github.com/whatwg/html/commit/f6490f17f577fa3478791b29ad8c2b586418001f

[128] seamless も参照。

[1] (X)HTML5 Tracking (2010-01-12 22:36:56 +09:00 版) http://html5.org/tools/web-apps-tracker?from=4576&to=4577

[2] (X)HTML5 Tracking (2010-01-12 22:37:33 +09:00 版) http://html5.org/tools/web-apps-tracker?from=4577&to=4578

[3] (X)HTML5 Tracking (2010-01-12 22:39:10 +09:00 版) http://html5.org/tools/web-apps-tracker?from=4579&to=4580

[4] HTML5 Revision Tracker (2010-03-24 22:15:30 +09:00 版) http://html5.org/tools/web-apps-tracker?from=4861&to=4862

[5] IRC logs: freenode / #whatwg / 20100408 (2010-04-20 20:02:50 +09:00 版) http://krijnhoetmer.nl/irc-logs/whatwg/20100408

[6] [whatwg] Please consider dropping the "sandbox" attribute from the <iframe> element (2010-08-02 22:50:46 +09:00 版) http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2010-August/027491.html

[7] IRC logs: freenode / #whatwg / 20100715 (2010-08-03 08:03:40 +09:00 版) http://krijnhoetmer.nl/irc-logs/whatwg/20100715

[8] Web Applications 1.0 r5571 Better define how sets of unique space-separated tokens are handled in terms of case-sensitivity.Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=10781 ( (2010-10-01 08:07:00 +09:00 版)) http://html5.org/tools/web-apps-tracker?from=5570&to=5571

[9] IRC logs: freenode / #whatwg / 20110714 ( (2011-07-23 20:18:18 +09:00 版)) http://krijnhoetmer.nl/irc-logs/whatwg/20110714

[10] IRC logs: freenode / #whatwg / 20111011 ( (2011-10-12 00:08:40 +09:00 版)) http://krijnhoetmer.nl/irc-logs/whatwg/20111011

[11] [whatwg] iframe sandbox, <object tag> ( (2012-01-29 12:17:08 +09:00 版)) http://lists.whatwg.org/htdig.cgi/whatwg-whatwg.org/2012-January/034567.html

[12] Web Applications 1.0 r7054 sandbox='allow-popups' feature ( (2012-04-17 14:02:00 +09:00 版)) http://html5.org/tools/web-apps-tracker?from=7053&to=7054

[13] IRC logs: freenode / #whatwg / 20120411 ( (2012-04-16 21:25:26 +09:00 版)) http://krijnhoetmer.nl/irc-logs/whatwg/20120411

[14] IRC logs: freenode / #whatwg / 20120414 ( (2012-04-21 20:45:41 +09:00 版)) http://krijnhoetmer.nl/irc-logs/whatwg/20120414

[15] [whatwg] Security Issue- Iframe Sandbox attribute - Clarity of operation ( (2012-06-30 08:25:56 +09:00 版)) http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2012-June/036530.html

[16] [whatwg] iframe sandbox attribute ( (2012-07-10 09:56:14 +09:00 版)) http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2012-July/036586.html

[17] [whatwg] Additional attribute value for iframe sandbox ( (2012-07-11 01:27:41 +09:00 版)) http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2012-July/036587.html

[18] [whatwg] sandboxed documents and cookies ( (2012-07-11 04:15:29 +09:00 版)) http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2012-July/036589.html

[19] Web Applications 1.0 r7485 Add sandbox=allow-pointer-lock, and some nearby cleanup. ( (2012-10-26 03:10:00 +09:00 版)) http://html5.org/tools/web-apps-tracker?from=7484&to=7485

[20] [whatwg] allowfullscreen vs sandbox="allow-fullscreen" ( (2012-12-05 05:25:40 +09:00 版)) http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2012-December/038258.html

[21] ChangeProposals/sandbox allow popups - HTML WG Wiki ( (2013-06-13 12:01:58 +09:00 版)) http://www.w3.org/html/wg/wiki/ChangeProposals/sandbox_allow_popups

[22] Web Applications 1.0 r7984 Sandboxing: prevent pages from closing their top-level browsing context (unless they can navigate it, in which case, whatever) ( (2013-06-18 09:24:00 +09:00 版)) http://html5.org/tools/web-apps-tracker?from=7983&to=7984

[23] [whatwg] iframe sandbox and top navigation ( (2013-07-12 00:26:45 +09:00 版)) http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2013-July/040002.html

[24] [whatwg] Making cross-origin <iframe seamless=""> (partly) usable ( (2013-07-18 06:08:37 +09:00 版)) http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2013-July/040115.html

[25] [whatwg] iframes, more sandbox ( (2014-05-01 17:26:14 +09:00 版)) http://lists.whatwg.org/pipermail/whatwg-whatwg.org/2014-May/254199.html

[26] Add a placeholder for filesystem and add the sandboxed storage area URLs... · e6fa889 · whatwg/fetch ( (2014-08-06 04:06:16 +09:00 版)) https://github.com/whatwg/fetch/commit/e6fa8899423652413287c0cf22cd074ffed12905

[27] Web Applications 1.0 r8706 Add a sandboxing flag for use by fetch ( (2014-08-05 08:38:00 +09:00 版)) http://html5.org/r/8706

[28] [whatwg] Proposal: Two changes to iframe@sandbox (Mike West 著, 2015-05-11 13:11:12 +09:00 版) https://lists.w3.org/Archives/Public/public-whatwg-archive/2015May/0035.html

[29] Iframe sandbox improvments - WHATWG Wiki (2015-06-23 18:03:36 +09:00 版) https://wiki.whatwg.org/wiki/Iframe_sandbox_improvments

[30] Re: [whatwg] Proposal: Two changes to iframe@sandbox (Mike West 著, 2015-06-23 18:14:17 +09:00 版) https://lists.w3.org/Archives/Public/public-whatwg-archive/2015Jun/0098.html

[79] Block modal dialogs by default in sandboxed documents · whatwg/html@bbccfc9 (2015-09-09 23:54:04 +09:00 版) https://github.com/whatwg/html/commit/bbccfc976754def0c187ac8ce5891d2fb20dfc15

[80] Cleanup sandbox token lists · whatwg/html@36f2a65 (2015-09-09 23:54:11 +09:00 版) https://github.com/whatwg/html/commit/36f2a65398310be4aeef3e71bb01bb290589ecb3

[81] Clarify sandbox directive. · w3c/webappsec-csp@4568e26 (2015-10-22 11:40:20 +09:00 版) https://github.com/w3c/webappsec-csp/commit/4568e26ca6f58f6609c8b5d30b38f9992776256c

[82] Add supported tokens to relList and sandbox · whatwg/html@f7a66ed (2015-11-22 23:39:58 +09:00 版) https://github.com/whatwg/html/commit/f7a66ed52a93d3b63304f4a669e868684dc95b56

[83] No CSP report-uri|frame-ancestors|sandbox in meta · whatwg/html@3947072 (2016-01-30 20:56:25 +09:00 版) https://github.com/whatwg/html/commit/39470724136a366bab4e893efd889a513d61cc3e

[85] Remove <iframe seamless> · whatwg/html@1490eba (2016-02-04 19:22:12 +09:00 版) https://github.com/whatwg/html/commit/1490eba4dba5ab476f0981443a86c01acae01311

[86] Adding [SameObject] to DOMTokenLists · whatwg/html@ec1dc4d (2016-02-18 11:10:36 +09:00 版) https://github.com/whatwg/html/commit/ec1dc4d4571c61cf0c0dfe3e562898635886b412

[87] Restrict valid sandbox values to keywords in HTML · w3c/webappsec-csp@cfd12e8 (2016-03-11 15:35:12 +09:00 版) https://github.com/w3c/webappsec-csp/commit/cfd12e8828a431f4741942480bf501042ba7be1a

[88] We're not going to enable 'sandbox' in '<meta>'. · w3c/webappsec-csp@8ca78f0 (2016-04-06 16:32:07 +09:00 版) https://github.com/w3c/webappsec-csp/commit/8ca78f0ed12bbbde0a11c4d58fb936ce0a25f9d7

[89] Fold CSPDOCUMENT into CSP. ( (mikewest著, 2016-05-23 12:05:43 +09:00)) https://github.com/w3c/webappsec-csp/commit/0cd4bf42b5e78168cd85efe798a9a5e719677b8e

[90] Add allow-orientation-lock to sandbox flags ( (mounirlamouri著, 2016-05-28 07:09:45 +09:00)) https://github.com/whatwg/html/commit/8f0f73c1b061a8ccee57c6878d8474b43c73aaeb

[91] Add allow-presentation to sandbox flags ( (mounirlamouri著, 2016-05-28 07:32:46 +09:00)) https://github.com/whatwg/html/commit/0678e3de01a3ef83c5f6f0c017e7464ede1d8ec1

[93] Use fullscreen logic for initial about:blank documents too ( (annevk著, 2016-06-09 21:47:29 +09:00)) https://github.com/whatwg/html/commit/c2a8d605e0115c80d1ccb4b15371ecaa56a33e30

[94] Integrate allowusermedia (domenic著, 2016-05-07 03:46:31 +09:00) https://github.com/whatwg/html/commit/688df431630fe7d9a0518e402c1f1543d0f493a0

[101] Make allowfullscreen and allowusermedia match implementations (annevk著, 2016-07-07 04:47:42 +09:00) https://github.com/whatwg/html/commit/9f6b91cb14a0f497ee5b3e7118ee65e687eaea78

[98] Be more precise about nested and discarded browsing contexts (domenic著, 2016-07-20 22:58:49 +09:00) https://github.com/whatwg/html/commit/39118df640ad4a3f03f164fb5ffe0a56316297be

[46] Tweak [CEReactions] definition and usage (domenic著, 2017-02-22 06:11:13 +09:00) https://github.com/whatwg/html/commit/c422734d44ae9897c1700daf08bd415e0dc5f9e1

[47] Add allow-top-navigation-by-user-activation sandbox token (domenic著, 2017-02-24 04:51:48 +09:00) https://github.com/whatwg/html/commit/8abd73ec3a56541e3f6486d3a593a8bcfd67295d

[100] Remove <applet> (zcorpan著, 2017-08-21 22:19:30 +09:00) https://github.com/whatwg/html/commit/b9b9d60f9451c05f8e8d542e4094f987ae1a5fb8

[102] 28563 – As in most cases the http-equiv meta tags are equivalent to their corresponding HTTP header, would i [...] (2017-08-29 00:23:56 +09:00) https://www.w3.org/Bugs/Public/show_bug.cgi?id=28563

[103] Define the HTTP Refresh header by annevk · Pull Request #2892 · whatwg/html (2017-08-29 00:24:48 +09:00) https://github.com/whatwg/html/pull/2892

[104] <meta http-equiv=Set-Cookie> should do nothing if document is cookie averse · Issue #1950 · whatwg/html (2018-05-02 13:19:06 +09:00) https://github.com/whatwg/html/issues/1950

[105] What is the "sandboxed storage area URLs flag"? · Issue #3862 · whatwg/html (2018-08-15 13:39:30 +09:00) https://github.com/whatwg/html/issues/3862

[106] Editorial: remove sandboxed storage area URLs flag (annevk著, 2019-02-23 01:53:39 +09:00) https://github.com/whatwg/html/commit/42a1e493fea61129e4b7c8a3bd80856feb85b8c4

[107] What is the "sandboxed storage area URLs flag"? · Issue #3862 · whatwg/html (2019-07-15 20:31:59 +09:00) https://github.com/whatwg/html/issues/3862

[108] Remove "filesystem" URL scheme · Issue #846 · whatwg/fetch (2019-07-15 20:32:37 +09:00) https://github.com/whatwg/fetch/issues/846

[109] Editorial: remove sandboxed storage area URLs flag by annevk · Pull Request #4388 · whatwg/html (2019-07-15 20:32:52 +09:00) https://github.com/whatwg/html/pull/4388

[110] Refactor the navigation algorithm (dtapuska, 2019-07-12 00:49:55 +09:00, 2021-07-01T09:41:47.000Z) https://github.com/whatwg/html/commit/061e782437c6cff600f18bc96c1a11489e09c3ab

[112] Refactor navigation algorithm. by dtapuska · Pull Request #4664 · whatwg/html (2021-07-02T08:22:35.000Z) https://github.com/whatwg/html/pull/4664

[117] Snapshot sandbox at the start of navigation (clelland, 2019-11-26 01:42:48 +09:00, 2022-01-14T09:47:31.000Z) https://github.com/whatwg/html/commit/eb13fece2cadc45863dc61079358b72478756f8b

[121] Possible race in feature policy in multiprocess implementations · Issue #256 · w3c/webappsec-permissions-policy (2022-01-14T10:33:16.000Z) https://github.com/w3c/webappsec-permissions-policy/issues/256

[122] Snapshot sandbox at start of navigation. by clelland · Pull Request #5098 · whatwg/html (2022-01-14T10:33:36.000Z) https://github.com/whatwg/html/pull/5098

[123] Editorial: nested browsing context is a member, not a type (annevk, 2019-11-27 02:46:03 +09:00, 2022-01-18T09:40:05.000Z) https://github.com/whatwg/html/commit/6b737bbc428facf34ec3728c0912cf9e172d0ea4

[124] Revamp the user activation model (mustaqahmed, 2019-12-05 04:09:23 +09:00, 2022-01-25T07:54:20.000Z) https://github.com/whatwg/html/commit/8f8c1f50158736b3cf16188377a0974a20367c8b