Skip to content

Commit

Permalink
Structured Field Values for HTTP are now RFC8941 (#526)
Browse files Browse the repository at this point in the history 
SHA: 827bf83
Reason: push, by clelland

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
@JannisBush @github-actions
JannisBush and github-actions[bot] committed Aug 24, 2023
1 parent ce35595 commit fda9e43
Showing 1 changed file with 14 additions and 14 deletions.
28 changes: 14 additions & 14 deletions index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@
<title>Permissions Policy</title>
<meta content="ED" name="w3c-status">
<link href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED" rel="stylesheet">
<meta content="Bikeshed version b06c00b8e, updated Tue Jul 11 13:41:16 2023 -0700" name="generator">
<meta content="Bikeshed version 6edc88947, updated Thu Aug 17 11:18:09 2023 -0700" name="generator">
<link href="https://www.w3.org/TR/permissions-policy/" rel="canonical">
<meta content="eb5199e716233fe80ecb831db7aeb1ab3d9a56c5" name="document-revision">
<meta content="827bf83b1699673801aac8b7c79312490241d4cf" name="document-revision">
<style>
.unstable::before {
content: "This section is not stable.";
Expand Down Expand Up @@ -905,7 +905,7 @@
<div class="head">
<p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72"> </a> </p>
<h1 class="p-name no-ref" id="title">Permissions Policy</h1>
<p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2023-07-17">17 July 2023</time></p>
<p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">Editor’s Draft</a>, <time class="dt-updated" datetime="2023-08-24">24 August 2023</time></p>
<details open>
<summary>More details about this document</summary>
<div data-fill-with="spec-metadata">
Expand Down Expand Up @@ -1270,7 +1270,7 @@ <h3 class="heading settled" data-level="4.6" id="policy-directives"><span class=
directive</dfn> is an <a data-link-type="dfn" href="https://infra.spec.whatwg.org/#ordered-map" id="ref-for-ordered-map②">ordered map</a>, mapping <a data-link-type="dfn" href="#policy-controlled-feature" id="ref-for-policy-controlled-feature⑦">policy-controlled
features</a> to corresponding <a data-link-type="dfn" href="#allowlist" id="ref-for-allowlist③">allowlists</a> of origins.</p>
<p>A <a data-link-type="dfn" href="#policy-directive" id="ref-for-policy-directive③">policy directive</a> is represented in HTTP headers as the
serialization of an <a data-link-type="dfn" href="https://httpwg.org/http-extensions/draft-ietf-httpbis-header-structure.html#dictionary" id="ref-for-dictionary">sh-dictionary</a> structure, and in and HTML
serialization of an <a data-link-type="dfn" href="https://datatracker.ietf.org/doc/html/rfc8941#dictionary" id="ref-for-dictionary">sf-dictionary</a> structure, and in and HTML
attributes as its ASCII serialization.</p>
</section>
<section>
Expand Down Expand Up @@ -1360,7 +1360,7 @@ <h3 class="heading settled" data-level="5.1" id="ascii-serialization"><span clas
<section>
<h3 class="heading settled" data-level="5.2" id="structured-header-serialization"><span class="secno">5.2. </span><span class="content">Structured header serialization</span><a class="self-link" href="#structured-header-serialization"></a></h3>
<a data-link-type="dfn" href="#policy-directive" id="ref-for-policy-directive⑤">Policy Directives</a> in HTTP headers are represented as Structured
Fields. <a data-link-type="biblio" href="#biblio-header-structure" title="Structured Field Values for HTTP">[HEADER-STRUCTURE]</a>
Fields. <a data-link-type="biblio" href="#biblio-rfc8941" title="Structured Field Values for HTTP">[RFC8941]</a>
<p>In this representation, a <a data-link-type="dfn" href="#policy-directive" id="ref-for-policy-directive⑥">policy directive</a> is represented by a
Dictionary.</p>
<p>Each Dictionary Member associates a <a data-link-type="dfn" href="https://w3c.github.io/permissions/#dfn-powerful-feature" id="ref-for-dfn-powerful-feature②">feature</a> with an <a data-link-type="dfn" href="#allowlist" id="ref-for-allowlist①①">allowlist</a>.
Expand Down Expand Up @@ -1394,7 +1394,7 @@ <h3 class="heading settled" data-level="6.1" id="permissions-policy-http-header-
client.</p>
<p><a data-link-type="http-header" href="#permissions-policy-header" id="ref-for-permissions-policy-header⑦">Permissions-Policy</a> is a structured header. Its value
must be a dictionary. It’s ABNF is: </p>
<pre class="abnf">PermissionsPolicy = <a data-link-type="dfn" href="https://httpwg.org/http-extensions/draft-ietf-httpbis-header-structure.html#dictionary" id="ref-for-dictionary①">sh-dictionary</a>
<pre class="abnf">PermissionsPolicy = <a data-link-type="dfn" href="https://datatracker.ietf.org/doc/html/rfc8941#dictionary" id="ref-for-dictionary①">sf-dictionary</a>
</pre>
<p>The semantics of the dictionary are defined in <a href="#structured-header-serialization">§ 5.2 Structured header serialization</a>.</p>
<p>The processing steps are defined in <a href="#algo-construct-policy">§ 9.2 Construct policy from dictionary and origin</a>.</p>
Expand Down Expand Up @@ -2449,11 +2449,6 @@ <h3 class="no-num no-ref heading settled" id="index-defined-elsewhere"><span cla
<ul>
<li><span class="dfn-paneled" id="bcdb6841">requestFullscreen()</span>
</ul>
<li>
<a data-link-type="biblio">[HEADER-STRUCTURE]</a> defines the following terms:
<ul>
<li><span class="dfn-paneled" id="0234d42b">sh-dictionary</span>
</ul>
<li>
<a data-link-type="biblio">[HTML]</a> defines the following terms:
<ul>
Expand Down Expand Up @@ -2516,6 +2511,11 @@ <h3 class="no-num no-ref heading settled" id="index-defined-elsewhere"><span cla
<li><span class="dfn-paneled" id="4d5cebba">report type</span>
<li><span class="dfn-paneled" id="3c4b330a">visible to reportingobservers</span>
</ul>
<li>
<a data-link-type="biblio">[RFC8941]</a> defines the following terms:
<ul>
<li><span class="dfn-paneled" id="92871e3b">sf-dictionary</span>
</ul>
<li>
<a data-link-type="biblio">[URL]</a> defines the following terms:
<ul>
Expand Down Expand Up @@ -2544,8 +2544,6 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
<dd>Anne van Kesteren. <a href="https://fetch.spec.whatwg.org/"><cite>Fetch Standard</cite></a>. Living Standard. URL: <a href="https://fetch.spec.whatwg.org/">https://fetch.spec.whatwg.org/</a>
<dt id="biblio-fullscreen">[FULLSCREEN]
<dd>Philip Jägenstedt. <a href="https://fullscreen.spec.whatwg.org/"><cite>Fullscreen API Standard</cite></a>. Living Standard. URL: <a href="https://fullscreen.spec.whatwg.org/">https://fullscreen.spec.whatwg.org/</a>
<dt id="biblio-header-structure">[HEADER-STRUCTURE]
<dd>Mark Nottingham; Poul-Henning Kamp. <a href="https://tools.ietf.org/html/draft-ietf-httpbis-header-structure-18"><cite>Structured Field Values for HTTP</cite></a>. Draft. URL: <a href="https://tools.ietf.org/html/draft-ietf-httpbis-header-structure-18">https://tools.ietf.org/html/draft-ietf-httpbis-header-structure-18</a>
<dt id="biblio-html">[HTML]
<dd>Anne van Kesteren; et al. <a href="https://html.spec.whatwg.org/multipage/"><cite>HTML Standard</cite></a>. Living Standard. URL: <a href="https://html.spec.whatwg.org/multipage/">https://html.spec.whatwg.org/multipage/</a>
<dt id="biblio-infra">[INFRA]
Expand All @@ -2558,6 +2556,8 @@ <h3 class="no-num no-ref heading settled" id="normative"><span class="content">N
<dd>S. Bradner. <a href="https://datatracker.ietf.org/doc/html/rfc2119"><cite>Key words for use in RFCs to Indicate Requirement Levels</cite></a>. March 1997. Best Current Practice. URL: <a href="https://datatracker.ietf.org/doc/html/rfc2119">https://datatracker.ietf.org/doc/html/rfc2119</a>
<dt id="biblio-rfc3864">[RFC3864]
<dd>G. Klyne; M. Nottingham; J. Mogul. <a href="https://www.rfc-editor.org/rfc/rfc3864"><cite>Registration Procedures for Message Header Fields</cite></a>. September 2004. Best Current Practice. URL: <a href="https://www.rfc-editor.org/rfc/rfc3864">https://www.rfc-editor.org/rfc/rfc3864</a>
<dt id="biblio-rfc8941">[RFC8941]
<dd>M. Nottingham; P-H. Kamp. <a href="https://www.rfc-editor.org/rfc/rfc8941"><cite>Structured Field Values for HTTP</cite></a>. February 2021. Proposed Standard. URL: <a href="https://www.rfc-editor.org/rfc/rfc8941">https://www.rfc-editor.org/rfc/rfc8941</a>
<dt id="biblio-url">[URL]
<dd>Anne van Kesteren. <a href="https://url.spec.whatwg.org/"><cite>URL Standard</cite></a>. Living Standard. URL: <a href="https://url.spec.whatwg.org/">https://url.spec.whatwg.org/</a>
<dt id="biblio-webidl">[WEBIDL]
Expand Down Expand Up @@ -2962,7 +2962,6 @@ <h2 class="no-num no-ref heading settled" id="issues-index"><span class="content
window.dfnpanelData['e3201629'] = {"dfnID": "e3201629", "url": "https://fetch.spec.whatwg.org/#concept-response-response", "dfnText": "response", "refSections": [{"refs": [{"id": "ref-for-concept-response-response"}], "title": "6.1. Permissions-Policy HTTP Header\n Field"}, {"refs": [{"id": "ref-for-concept-response-response\u2460"}], "title": "9.1. Process response policy"}, {"refs": [{"id": "ref-for-concept-response-response\u2461"}], "title": "9.6. Create a Permissions Policy for a navigable from response"}], "external": true};
window.dfnpanelData['1ab127d6'] = {"dfnID": "1ab127d6", "url": "https://fetch.spec.whatwg.org/#concept-request-window", "dfnText": "window", "refSections": [{"refs": [{"id": "ref-for-concept-request-window"}], "title": "9.11. Should request be allowed to use feature?"}], "external": true};
window.dfnpanelData['bcdb6841'] = {"dfnID": "bcdb6841", "url": "https://fullscreen.spec.whatwg.org/#dom-element-requestfullscreen", "dfnText": "requestFullscreen()", "refSections": [{"refs": [{"id": "ref-for-dom-element-requestfullscreen"}], "title": "6.3.1. allowfullscreen"}], "external": true};
window.dfnpanelData['0234d42b'] = {"dfnID": "0234d42b", "url": "https://httpwg.org/http-extensions/draft-ietf-httpbis-header-structure.html#dictionary", "dfnText": "sh-dictionary", "refSections": [{"refs": [{"id": "ref-for-dictionary"}], "title": "4.6. Policy directives"}, {"refs": [{"id": "ref-for-dictionary\u2460"}], "title": "6.1. Permissions-Policy HTTP Header\n Field"}], "external": true};
window.dfnpanelData['10e25f42'] = {"dfnID": "10e25f42", "url": "https://html.spec.whatwg.org/multipage/iframe-embed-object.html#htmliframeelement", "dfnText": "HTMLIFrameElement", "refSections": [{"refs": [{"id": "ref-for-htmliframeelement"}], "title": "7.2. The permissionsPolicy object"}], "external": true};
window.dfnpanelData['5d7209e9'] = {"dfnID": "5d7209e9", "url": "https://html.spec.whatwg.org/multipage/nav-history-apis.html#window", "dfnText": "Window", "refSections": [{"refs": [{"id": "ref-for-window"}], "title": "9.11. Should request be allowed to use feature?"}], "external": true};
window.dfnpanelData['83c59a3a'] = {"dfnID": "83c59a3a", "url": "https://html.spec.whatwg.org/multipage/workers.html#workerglobalscope", "dfnText": "WorkerGlobalScope", "refSections": [{"refs": [{"id": "ref-for-workerglobalscope"}], "title": "9.11. Should request be allowed to use feature?"}], "external": true};
Expand Down Expand Up @@ -3009,6 +3008,7 @@ <h2 class="no-num no-ref heading settled" id="issues-index"><span class="content
window.dfnpanelData['9fe8836b'] = {"dfnID": "9fe8836b", "url": "https://w3c.github.io/reporting/#report", "dfnText": "report", "refSections": [{"refs": [{"id": "ref-for-report"}], "title": "9.10. Generate report for violation of permissions policy on settings"}], "external": true};
window.dfnpanelData['4d5cebba'] = {"dfnID": "4d5cebba", "url": "https://w3c.github.io/reporting/#report-type", "dfnText": "report type", "refSections": [{"refs": [{"id": "ref-for-report-type"}], "title": "8. Reporting"}], "external": true};
window.dfnpanelData['3c4b330a'] = {"dfnID": "3c4b330a", "url": "https://w3c.github.io/reporting/#visible-to-reportingobservers", "dfnText": "visible to reportingobservers", "refSections": [{"refs": [{"id": "ref-for-visible-to-reportingobservers"}], "title": "8. Reporting"}], "external": true};
window.dfnpanelData['92871e3b'] = {"dfnID": "92871e3b", "url": "https://datatracker.ietf.org/doc/html/rfc8941#dictionary", "dfnText": "sf-dictionary", "refSections": [{"refs": [{"id": "ref-for-dictionary"}], "title": "4.6. Policy directives"}, {"refs": [{"id": "ref-for-dictionary\u2460"}], "title": "6.1. Permissions-Policy HTTP Header\n Field"}], "external": true};
window.dfnpanelData['959ad97b'] = {"dfnID": "959ad97b", "url": "https://url.spec.whatwg.org/#concept-url-origin", "dfnText": "origin", "refSections": [{"refs": [{"id": "ref-for-concept-url-origin"}, {"id": "ref-for-concept-url-origin\u2460"}, {"id": "ref-for-concept-url-origin\u2461"}], "title": "4.7. Allowlists"}, {"refs": [{"id": "ref-for-concept-url-origin\u2462"}, {"id": "ref-for-concept-url-origin\u2463"}], "title": "7.2. The permissionsPolicy object"}, {"refs": [{"id": "ref-for-concept-url-origin\u2464"}], "title": "9.1. Process response policy"}, {"refs": [{"id": "ref-for-concept-url-origin\u2465"}], "title": "9.2. Construct policy from dictionary and origin"}, {"refs": [{"id": "ref-for-concept-url-origin\u2466"}, {"id": "ref-for-concept-url-origin\u2467"}, {"id": "ref-for-concept-url-origin\u2468"}], "title": "9.3. Parse policy directive"}, {"refs": [{"id": "ref-for-concept-url-origin\u2460\u24ea"}], "title": "9.5. Create a Permissions Policy for a navigable"}, {"refs": [{"id": "ref-for-concept-url-origin\u2460\u2460"}], "title": "9.6. Create a Permissions Policy for a navigable from response"}, {"refs": [{"id": "ref-for-concept-url-origin\u2460\u2461"}], "title": "9.8. Get feature value for origin"}, {"refs": [{"id": "ref-for-concept-url-origin\u2460\u2462"}], "title": "9.9. Is feature enabled in document for origin?"}], "external": true};
window.dfnpanelData['ca3ca4ae'] = {"dfnID": "ca3ca4ae", "url": "https://url.spec.whatwg.org/#concept-url-parser", "dfnText": "url parser", "refSections": [{"refs": [{"id": "ref-for-concept-url-parser"}], "title": "4.7. Allowlists"}, {"refs": [{"id": "ref-for-concept-url-parser\u2460"}], "title": "9.3. Parse policy directive"}], "external": true};
window.dfnpanelData['8855a9aa'] = {"dfnID": "8855a9aa", "url": "https://webidl.spec.whatwg.org/#idl-DOMString", "dfnText": "DOMString", "refSections": [{"refs": [{"id": "ref-for-idl-DOMString"}, {"id": "ref-for-idl-DOMString\u2460"}, {"id": "ref-for-idl-DOMString\u2461"}, {"id": "ref-for-idl-DOMString\u2462"}, {"id": "ref-for-idl-DOMString\u2463"}, {"id": "ref-for-idl-DOMString\u2464"}], "title": "7.2. The permissionsPolicy object"}, {"refs": [{"id": "ref-for-idl-DOMString\u2465"}, {"id": "ref-for-idl-DOMString\u2466"}, {"id": "ref-for-idl-DOMString\u2467"}], "title": "8. Reporting"}], "external": true};
Expand Down

0 comments on commit fda9e43

Please sign in to comment.