| rfc8809xml2.original.xml | rfc8809.xml | |||
|---|---|---|---|---|
| <?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> | |||
| <!DOCTYPE rfc SYSTEM "http://xml2rfc.tools.ietf.org/authoring/rfc2629.dtd" [ | <!DOCTYPE rfc SYSTEM "rfc2629-xhtml.ent"> | |||
| <!ENTITY rfc2119 SYSTEM "http://xml2rfc.tools.ietf.org/public/rfc/bibxml/refer | ||||
| ence.RFC.2119.xml"> | ||||
| <!ENTITY rfc5234 SYSTEM "http://xml2rfc.tools.ietf.org/public/rfc/bibxml/refer | ||||
| ence.RFC.5234.xml"> | ||||
| <!ENTITY rfc8126 SYSTEM "http://xml2rfc.tools.ietf.org/public/rfc/bibxml/refer | ||||
| ence.RFC.8126.xml"> | ||||
| <!ENTITY rfc8174 SYSTEM "http://xml2rfc.tools.ietf.org/public/rfc/bibxml/refer | ||||
| ence.RFC.8174.xml"> | ||||
| ]> | ||||
| <?xml-stylesheet type="text/xsl" href="http://xml2rfc.tools.ietf.org/authoring/r | ||||
| fc2629.xslt" ?> | ||||
| <?rfc compact="yes" ?> | ||||
| <?rfc subcompact="yes" ?> | ||||
| <?rfc toc="yes" ?> | ||||
| <?rfc sortrefs="yes" ?> | ||||
| <?rfc symrefs="yes" ?> | ||||
| <!-- | <rfc xmlns:xi="http://www.w3.org/2001/XInclude" submissionType="IETF" | |||
| -00a: initial version based on RFC5988 | category="info" consensus="true" ipr="trust200902" | |||
| -00b: adapt 5988bis per mnot's suggestion: draft-nottingham-rfc5988bis-01 | docName="draft-hodges-webauthn-registries-10" number="8809" obsoletes="" | |||
| * 'attestation type' -> 'attestation format' | updates="" xml:lang="en" tocInclude="true" sortRefs="true" symRefs="true" | |||
| * updated to latest extension id format, adjusted list of registered ext | version="3"> | |||
| ensions to | ||||
| match [WebAuthn] editors' draft. | ||||
| -00c: ? | ||||
| -00d: Let initial values be in the [WebAuthn] spec, rather than here. | ||||
| <rfc category="info" ipr="trust200902" docName="draft-hodges-webauthn-registries -10"> | <!-- xml2rfc v2v3 conversion 2.45.2 --> | |||
| <front> | <front> | |||
| <title>Registries for Web Authentication (WebAuthn)</title> | <title>Registries for Web Authentication (WebAuthn)</title> | |||
| <seriesInfo name="RFC" value="8809"/> | ||||
| <author initials="J." surname="Hodges" fullname="Jeff Hodges"> | <author initials="J." surname="Hodges" fullname="Jeff Hodges"> | |||
| <organization>Google</organization> | <organization>Google</organization> | |||
| <address> | <address> | |||
| <postal> | <postal> | |||
| <street>1600 Amphitheater Parkway</street> | <street>1600 Amphitheatre Parkway</street> | |||
| <city>Mountain View</city> | <city>Mountain View</city> | |||
| <region>California</region> | <region>CA</region> | |||
| <code>94043</code> | <code>94043</code> | |||
| <country>US</country> | <country>United States of America</country> | |||
| </postal> | </postal> | |||
| <email>jdhodges@google.com</email> | <email>jdhodges@google.com</email> | |||
| <uri>https://kingsmountain.com/people/Jeff.Hodges/</uri> | <uri>https://kingsmountain.com/people/Jeff.Hodges/</uri> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author fullname="Giridhar Mandyam" initials="G." surname="Mandyam"> | ||||
| <author fullname="Giridhar Mandyam" initials="G.D." | ||||
| surname="Mandyam"> | ||||
| <organization>Qualcomm Technologies Inc.</organization> | <organization>Qualcomm Technologies Inc.</organization> | |||
| <address> | <address> | |||
| <postal> | <postal> | |||
| <street>5775 Morehouse Drive</street> | <street>5775 Morehouse Drive</street> | |||
| <city>San Diego</city> | <city>San Diego</city> | |||
| <region>California</region> | <region>CA</region> | |||
| <code>92121</code> | <code>92121</code> | |||
| <country>USA</country> | <country>United States of America</country> | |||
| </postal> | </postal> | |||
| <phone>+1 858 651 7200</phone> | <phone>+1 858 651 7200</phone> | |||
| <email>mandyam@qti.qualcomm.com</email> | <email>mandyam@qti.qualcomm.com</email> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author fullname="Michael B. Jones" initials="M." surname="Jones"> | ||||
| <author fullname="Michael B. Jones" initials="M.B." surname="Jones"> | ||||
| <organization abbrev="Microsoft">Microsoft</organization> | <organization abbrev="Microsoft">Microsoft</organization> | |||
| <address> | <address> | |||
| <email>mbj@microsoft.com</email> | <email>mbj@microsoft.com</email> | |||
| <uri>https://self-issued.info/</uri> | <uri>https://self-issued.info/</uri> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <date month="August" year="2020"/> | ||||
| <date month="June" year="2020" /> | ||||
| <area>Security</area> | <area>Security</area> | |||
| <workgroup>W3C WebAuthn Working Group</workgroup> | <workgroup>W3C WebAuthn Working Group</workgroup> | |||
| <keyword>webauthn</keyword> | <keyword>webauthn</keyword> | |||
| <keyword>attestation</keyword> | <keyword>attestation</keyword> | |||
| <keyword>extensions</keyword> | <keyword>extensions</keyword> | |||
| <keyword>registry</keyword> | <keyword>registry</keyword> | |||
| <abstract> | <abstract> | |||
| <t> | <t> | |||
| This specification defines IANA registries for W3C Web Authentication | This specification defines IANA registries for W3C Web Authentication (W ebAuthn) | |||
| attestation statement format identifiers and extension identifiers. | attestation statement format identifiers and extension identifiers. | |||
| </t> | </t> | |||
| </abstract> | </abstract> | |||
| <note title="Note to Readers"> | ||||
| <t><spanx style="emph">RFC EDITOR: please remove this section before publication | ||||
| </spanx></t> | ||||
| <t>This is a work-in-progress.</t> | ||||
| <t>The issues list can be found at | ||||
| <eref target="https://github.com/w3c/webauthn/issues?q=is%3Aopen+is%3Aissue+labe | ||||
| l%3Aspec%3Awebauthn-registries"> | ||||
| https://github.com/w3c/webauthn/issues?q=is%3Aopen+is%3Aissue+label%3Aspec%3Aweb | ||||
| authn-registries | ||||
| </eref>.</t> | ||||
| <t>The most recent _published_ draft revision is at | ||||
| <eref target="https://tools.ietf.org/html/draft-hodges-webauthn-registries"> | ||||
| https://tools.ietf.org/html/draft-hodges-webauthn-registries</eref>.</t> | ||||
| <t>The editors' draft is at | ||||
| <eref target="https://github.com/w3c/webauthn/blob/master/draft-hodges-webauthn- | ||||
| registries.txt"> | ||||
| https://github.com/w3c/webauthn/blob/master/draft-hodges-webauthn-registries.txt | ||||
| </eref></t> | ||||
| <t>Changes in the editors' draft, both proposed and incorporated, are liste | ||||
| d at | ||||
| <eref target="https://github.com/w3c/webauthn/pulls?q=is%3Apr+label%3Aspec%3Aweb | ||||
| authn-registries"> | ||||
| https://github.com/w3c/webauthn/pulls?q=is%3Apr+label%3Aspec%3Awebauthn-registri | ||||
| es | ||||
| </eref></t> | ||||
| </note> | ||||
| </front> | </front> | |||
| <middle> | <middle> | |||
| <section anchor="Introduction" title="Introduction"> | <section anchor="Introduction" numbered="true" toc="default"> | |||
| <name>Introduction</name> | ||||
| <t> | <t> | |||
| This specification establishes IANA registries for W3C Web Authenticatio | This specification establishes IANA registries for W3C Web | |||
| n <xref | Authentication <xref target="WebAuthn" format="default"/> attestation | |||
| target="WebAuthn"/> attestation statement format identifiers and extensi | statement format identifiers and extension identifiers. The initial | |||
| on identifiers. | values for these registries are in the IANA Considerations section of | |||
| The initial values for these registries are in the IANA Considerations | the <xref target="WebAuthn" format="default"/> specification. | |||
| section of the <xref target="WebAuthn"/> specification. | ||||
| </t> | </t> | |||
| <section anchor="rnc" numbered="true" toc="default"> | ||||
| <section anchor="rnc" title="Requirements Notation and Conventions"> | <name>Requirements Notation and Conventions</name> | |||
| <t> | <t>The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", | |||
| The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL | |||
| "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and | NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", | |||
| "OPTIONAL" in this document are to be interpreted as described in | "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>", | |||
| BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and | "<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document | |||
| only when, they appear in all capitals, as shown here. | are to be interpreted as described in BCP 14 <xref target="RFC2119" | |||
| </t> | format="default"/> <xref target="RFC8174" format="default"/> when, and | |||
| only when, they appear in all capitals, as shown here.</t> | ||||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="sctn-iana-cons" numbered="true" toc="default"> | ||||
| <section title="IANA Considerations" anchor="sctn-iana-cons"> | <name>IANA Considerations</name> | |||
| <t> | <t>This specification establishes two registries:</t> | |||
| This specification establishes two registries: | <ul spacing="normal"> | |||
| <list style="symbols"> | <li>the "WebAuthn Attestation Statement Format Identifiers" registry | |||
| <t> | (see <xref target="sctn-attstn-format-registry" | |||
| the "WebAuthn Attestation Statement Format Identifier" registry; see | format="default"/>)</li> | |||
| <xref target="sctn-attstn-format-registry"/>. | <li>the "WebAuthn Extension Identifiers" registry (see <xref | |||
| </t> | target="sctn-extension-ident-registry" format="default"/>)</li> | |||
| <t> | </ul> | |||
| the "WebAuthn Extension Identifier" registry; | <t>Any additional processes established by the expert(s) after the | |||
| see <xref target="sctn-extension-ident-registry" />. | publication of this document will be recorded on the registry web page | |||
| </t> | at the discretion of the expert(s).</t> | |||
| </list> | <section anchor="sctn-attstn-format-registry" numbered="true" toc="default | |||
| </t> | "> | |||
| <t> | <name>WebAuthn Attestation Statement Format Identifiers Registry</name> | |||
| [[ Per discussions in an email thread between the authors and IANA ( "[IA | ||||
| NA #1154148]" ), | ||||
| it is requested that the registries be located at | ||||
| <https://www.iana.org/assignments/webauthn>. | ||||
| RFC Editor - please delete this request after the registries have been cr | ||||
| eated. ]] | ||||
| </t> | ||||
| <t> | ||||
| Any additional processes established by the expert(s) after the publicati | ||||
| on of this document | ||||
| will be recorded on the registry Web page at the expert(s)' discretion. | ||||
| </t> | ||||
| <section title="WebAuthn Attestation Statement Format Identifier Registry" | ||||
| anchor="sctn-attstn-format-registry"> | ||||
| <t> | <t> | |||
| WebAuthn attestation statement format identifiers are strings whose se mantic, syntactic, | WebAuthn attestation statement format identifiers are strings whose se mantic, syntactic, | |||
| and string-matching criteria are specified in <xref target="WebAuthn"/ > | and string-matching criteria are specified in the | |||
| <eref target="https://www.w3.org/TR/2019/REC-webauthn-1-20190304/#sctn -attstn-fmt-ids"> | <eref target="https://www.w3.org/TR/2019/REC-webauthn-1-20190304/#sctn -attstn-fmt-ids"> | |||
| "Attestation Statement Format Identifiers"</eref>, | "Attestation Statement Format Identifiers"</eref> section of <xref tar get="WebAuthn" format="default"/>, | |||
| along with the concepts of attestation and attestation statement forma ts. | along with the concepts of attestation and attestation statement forma ts. | |||
| </t> | </t> | |||
| <t> | <t> | |||
| Registered attestation statement format identifiers are those that hav e been added to the | Registered attestation statement format identifiers are those that hav e been added to the | |||
| registry by following the procedure in | registry by following the procedure in | |||
| <xref target="sctn-registering-attstn-format-idents"/>. | <xref target="sctn-registering-attstn-format-idents" format="default"/ | |||
| </t> | >. | |||
| <t> | ||||
| Each attestation statement format identifier added to this registry MU | ||||
| ST be unique amongst | ||||
| the set of registered attestation statement format identifiers. | ||||
| </t> | ||||
| <t> | ||||
| Registered attestation statement format identifiers MUST be a maximum | ||||
| of 32 octets in length | ||||
| and MUST consist only of printable ASCII <xref target="RFC20"/> charac | ||||
| ters, excluding backslash and doublequote, | ||||
| i.e., VCHAR as defined in <xref target="RFC5234"/> but without %x22 an | ||||
| d %x5c. | ||||
| Attestation statement format identifiers are case sensitive | ||||
| and may not match other registered identifiers in a | ||||
| case-insensitive manner unless the Designated Experts determine that t | ||||
| here is a compelling | ||||
| reason to allow an exception. | ||||
| </t> | </t> | |||
| <t>Each attestation statement format identifier added to this registry | ||||
| <section title="Registering Attestation Statement Format Identifiers" | <bcp14>MUST</bcp14> be unique amongst the set of registered | |||
| anchor="sctn-registering-attstn-format-idents"> | attestation statement format identifiers.</t> | |||
| <t> | <t>Registered attestation statement format identifiers | |||
| WebAuthn attestation statement format identifiers are registered usi | <bcp14>MUST</bcp14> be a maximum of 32 octets in length and | |||
| ng the | <bcp14>MUST</bcp14> consist only of printable ASCII <xref | |||
| Specification Required policy (see Section 4.6 of <xref target="RFC8 | target="RFC0020" format="default"/> characters, excluding backslash | |||
| 126"/>). | and double quote, i.e., VCHAR as defined in <xref target="RFC5234" | |||
| </t> | format="default"/> but without %x22 and %x5c. Attestation statement | |||
| format identifiers are case sensitive and may not match other | ||||
| registered identifiers in a case-insensitive manner unless the | ||||
| designated experts determine that there is a compelling reason to | ||||
| allow an exception.</t> | ||||
| <section anchor="sctn-registering-attstn-format-idents" numbered="true" | ||||
| toc="default"> | ||||
| <name>Registering Attestation Statement Format Identifiers</name> | ||||
| <t>WebAuthn attestation statement format identifiers are registered | ||||
| using the Specification Required policy (see <xref target="RFC8126" | ||||
| section="4.6" sectionFormat="of"/>).</t> | ||||
| <t> | <t> | |||
| The WebAuthn attestation statement format identifiers registry is lo | The "WebAuthn Attestation Statement Format Identifiers" registry is | |||
| cated at | located at | |||
| <eref target="https://www.iana.org/assignments/webauthn">https://www | <eref target="https://www.iana.org/assignments/webauthn" brackets="a | |||
| .iana.org/assignments/webauthn</eref>. | ngle"/>. | |||
| Registration requests can be made by following the instructions loca | Registration requests can be made by following the instructions loca | |||
| ted there, or by | ted there or by | |||
| sending an e-mail to the webauthn-reg-review@ietf.org mailing list. | sending an email to the webauthn-reg-review@ietf.org mailing list. | |||
| </t> | </t> | |||
| <t> | ||||
| Registration requests consist of at least the following information: | <t> Registration requests consist of at least the following informatio | |||
| <list style="symbols" > | n:</t> | |||
| <t> | <dl newline="true"> | |||
| WebAuthn Attestation Statement Format Identifier: | <dt>WebAuthn Attestation Statement Format Identifier:</dt> | |||
| <vspace/> | <dd>An identifier meeting the requirements given in | |||
| An identifier meeting the requirements given above in | <xref target="sctn-attstn-format-registry" | |||
| <xref target="sctn-attstn-format-registry"/>. | format="default"/>.</dd> | |||
| </t> | <dt>Description:</dt> | |||
| <t> | <dd>A relatively short description of the attestation format.</d | |||
| Description: | d> | |||
| <vspace/> | <dt>Specification Document(s):</dt> | |||
| A relatively short description of the attestation format. | <dd>Reference to the document or documents that specify the | |||
| </t> | attestation statement format.</dd> | |||
| <t> | <dt>Change Controller:</dt> | |||
| Specification Document(s): | <dd>For Standards Track RFCs, list "IETF". For others, give the | |||
| <vspace/> | name of the | |||
| Reference to the document or documents that specify the attestat | ||||
| ion statement format. | ||||
| </t> | ||||
| <t> | ||||
| Change Controller: | ||||
| <vspace/> | ||||
| For Standards Track RFCs, list the "IETF". For others, give the | ||||
| name of the | ||||
| responsible party. Other details (e.g., postal address, email ad dress, home page | responsible party. Other details (e.g., postal address, email ad dress, home page | |||
| URI) may also be included. | URI) may also be included.</dd> | |||
| </t> | <dt>Notes:</dt> | |||
| <t> | <dd>[optional]</dd> | |||
| Notes: | </dl> | |||
| <vspace/> | ||||
| [optional] | <t>Registrations <bcp14>MUST</bcp14> reference a freely available, | |||
| </t> | stable specification, e.g., as described in <xref target="RFC8126" | |||
| </list> | section="4.6" sectionFormat="of"/>. This specification | |||
| </t> | <bcp14>MUST</bcp14> include security and privacy considerations | |||
| <t> | relevant to the attestation statement format.</t> | |||
| Registrations MUST reference a freely available, stable specificatio | ||||
| n, e.g., as | ||||
| described in Section 4.6 of <xref target="RFC8126"/>. | ||||
| This specification MUST include security and privacy considerations | ||||
| relevant to the attestation statement format. | ||||
| </t> | ||||
| <t> | <t> | |||
| Note that WebAuthn attestation statement format identifiers can be r egistered by third | Note that WebAuthn attestation statement format identifiers can be r egistered by third | |||
| parties (including the expert(s) themselves), if the expert(s) deter mine that an | parties (including the expert(s) themselves), if the expert(s) deter mines that an | |||
| unregistered attestation statement format is widely deployed and not likely to be | unregistered attestation statement format is widely deployed and not likely to be | |||
| registered in a timely manner otherwise. | registered in a timely manner otherwise. | |||
| Such registrations still are subject to the requirements defined, in cluding the need to | Such registrations still are subject to the requirements defined, in cluding the need to | |||
| reference a specification. | reference a specification. | |||
| </t> | </t> | |||
| </section> | </section> | |||
| <section anchor="sctn-registering-attstn-format-idents-processing" | ||||
| <section title="Registration Request Processing" | numbered="true" toc="default"> | |||
| anchor="sctn-registering-attstn-format-idents-processing"> | <name>Registration Request Processing</name> | |||
| <t> | <t> | |||
| As noted in <xref target="sctn-registering-attstn-format-idents"/>, | As noted in <xref target="sctn-registering-attstn-format-idents" for mat="default"/>, | |||
| WebAuthn attestation statement format identifiers are registered usi ng the | WebAuthn attestation statement format identifiers are registered usi ng the | |||
| Specification Required policy. | Specification Required policy. | |||
| </t> | </t> | |||
| <t> | <t> | |||
| The expert(s) will clearly identify any issues that cause a registra tion to be refused, | The expert(s) will clearly identify any issues that cause a registra tion to be refused, | |||
| such as an incompletely specified attestation format. | such as an incompletely specified attestation format. | |||
| </t> | </t> | |||
| <t> | <t> | |||
| When a request is approved, the expert(s) will inform IANA, and the registration will | When a request is approved, the expert(s) will inform IANA, and the registration will | |||
| be processed. | be processed. | |||
| The IESG is the arbiter of any objection. | The IESG is the arbiter of any objection. | |||
| </t> | </t> | |||
| </section> | </section> | |||
| <section anchor="sctn-attstn-format-registry-values" numbered="true" toc | ||||
| <section title="Initial WebAuthn Attestation Statement Format Identifier | ="default"> | |||
| Registry Values" | <name>Initial Values in the WebAuthn Attestation Statement Format Iden | |||
| anchor="sctn-attstn-format-registry-values"> | tifiers Registry</name> | |||
| <t> | <t> | |||
| The initial values for the WebAuthn Attestation Statement Format Ide | The initial values for the "WebAuthn Attestation Statement Format | |||
| ntifier Registry are | Identifiers" registry have been | |||
| to be populated from the values listed in | populated with the values listed in the | |||
| <eref target="https://www.w3.org/TR/2019/REC-webauthn-1-20190304/#sc tn-att-fmt-reg"> | <eref target="https://www.w3.org/TR/2019/REC-webauthn-1-20190304/#sc tn-att-fmt-reg"> | |||
| "WebAuthn Attestation Statement Format Identifier Registrations"</er | "WebAuthn Attestation Statement Format Identifier | |||
| ef> | Registrations"</eref> section | |||
| of <xref target="WebAuthn"/>. | of <xref target="WebAuthn" format="default"/>. | |||
| Also, the Change Controller entry to be used for each of those regist | Also, the Change Controller entry for each of those registrations is: | |||
| rations is: | ||||
| <list style='symbols'> | ||||
| <t> | ||||
| Change Controller: W3C Web Authentication Working Group - public& | ||||
| #8209;webauthn@w3.org | ||||
| </t> | ||||
| </list> | ||||
| </t> | </t> | |||
| <dl newline="true"> | ||||
| <dt>Change Controller:</dt> | ||||
| <dd> W3C Web Authentication Working Group (public&nbhy;webauthn@w3.org) | ||||
| </dd> | ||||
| </dl> | ||||
| </section> | </section> | |||
| </section> | ||||
| </section> <!-- Attestation Statement Format Identifier Registry --> | <section anchor="sctn-extension-ident-registry" numbered="true" toc="defau | |||
| lt"> | ||||
| <section title="WebAuthn Extension Identifier Registry" | <name>WebAuthn Extension Identifiers Registry</name> | |||
| anchor="sctn-extension-ident-registry"> | ||||
| <t> | <t> | |||
| WebAuthn extension identifiers are strings whose semantic, syntactic, | WebAuthn extension identifiers are strings whose semantic, syntactic, | |||
| and string-matching criteria are specified in <xref target="WebAuthn"/ > | and string-matching criteria are specified in the | |||
| <eref target="https://www.w3.org/TR/2019/REC-webauthn-1-20190304/#sctn -extension-id"> | <eref target="https://www.w3.org/TR/2019/REC-webauthn-1-20190304/#sctn -extension-id"> | |||
| "Extension Identifiers" </eref>. | "Extension Identifiers" </eref> section of <xref target="WebAuthn" for mat="default"/>. | |||
| </t> | </t> | |||
| <t> | <t> | |||
| Registered extension identifiers are those that have been added to the | Registered extension identifiers are those that have been added to the | |||
| registry by following the procedure in | registry by following the procedure in | |||
| <xref target="sctn-registering-extension-idents"/>. | <xref target="sctn-registering-extension-idents" format="default"/>. | |||
| </t> | </t> | |||
| <t> | <t> | |||
| Each extension identifier added to this registry MUST be unique | Each extension identifier added to this registry <bcp14>MUST</bcp14> b e unique | |||
| amongst the set of registered extension identifiers. | amongst the set of registered extension identifiers. | |||
| </t> | </t> | |||
| <t> | <t>Registered extension identifiers <bcp14>MUST</bcp14> be a maximum | |||
| Registered extension identifiers MUST be a maximum of 32 octets in len | of 32 octets in length and <bcp14>MUST</bcp14> consist only of | |||
| gth and MUST | printable ASCII characters, excluding backslash and double quote, | |||
| consist only of printable ASCII characters, excluding backslash and do | i.e., VCHAR as defined in <xref target="RFC5234" format="default"/> | |||
| ublequote, | but without %x22 and %x5c. Extension identifiers are case sensitive | |||
| i.e., VCHAR as defined in <xref target="RFC5234"/> but without %x22 an | and may not match other registered identifiers in a case-insensitive | |||
| d %x5c. | manner unless the designated experts determine that there is a | |||
| Extension identifiers are case sensitive | compelling reason to allow an exception.</t> | |||
| and may not match other registered identifiers in a case-insensitive m | <section anchor="sctn-registering-extension-idents" numbered="true" toc= | |||
| anner | "default"> | |||
| unless the Designated Experts determine that there is a compelling rea | <name>Registering Extension Identifiers</name> | |||
| son | <t>WebAuthn extension identifiers are registered using the | |||
| to allow an exception. | Specification Required policy (see <xref target="RFC8126" | |||
| </t> | section="4.6" sectionFormat="of"/>).</t> | |||
| <t>The "WebAuthn Extension Identifiers" registry is located at <eref | ||||
| <section title="Registering Extension Identifiers" | target="https://www.iana.org/assignments/webauthn" | |||
| anchor="sctn-registering-extension-idents"> | brackets="angle"/>. Registration requests can be made by following | |||
| <t> | the instructions located there or by sending an email to the | |||
| WebAuthn extension identifiers registry are registered using the | webauthn-reg-review@ietf.org mailing list.</t> | |||
| Specification Required policy (see Section 4.6 of <xref target="RFC8 | <t>Registration requests consist of at least the following information:< | |||
| 126"/>). | /t> | |||
| </t> | <dl newline="true"> | |||
| <t> | <dt>WebAuthn Extension Identifier:</dt> | |||
| The WebAuthn extension identifiers registry is located at | <dd>An identifier meeting the requirements given in | |||
| https://www.iana.org/assignments/webauthn. | <xref target="sctn-extension-ident-registry" | |||
| Registration requests can be made by following the instructions loca | format="default"/>.</dd> | |||
| ted there, or by | <dt>Description:</dt> | |||
| sending an e-mail to the webauthn-reg-review@ietf.org mailing list. | <dd>A relatively short description of the extension.</dd> | |||
| </t> | <dt>Specification Document(s):</dt> | |||
| <t> | <dd>Reference to the document or documents that specify the exte | |||
| Registration requests consist of at least the following information: | nsion.</dd> | |||
| <list style="symbols" > | <dt>Change Controller:</dt> | |||
| <t> | <dd>For Standards Track RFCs, list "IETF". For others, give the | |||
| WebAuthn Extension Identifier: | name of the | |||
| <vspace/> | ||||
| An identifier meeting the requirements given above in | ||||
| <xref target="sctn-extension-ident-registry"/>. | ||||
| </t> | ||||
| <t> | ||||
| Description: | ||||
| <vspace/> | ||||
| A relatively short description of the extension. | ||||
| </t> | ||||
| <t> | ||||
| Specification Document(s): | ||||
| <vspace/> | ||||
| Reference to the document or documents that specify the extensio | ||||
| n. | ||||
| </t> | ||||
| <t> | ||||
| Change Controller: | ||||
| <vspace/> | ||||
| For Standards Track RFCs, list the "IETF". For others, give the | ||||
| name of the | ||||
| responsible party. Other details (e.g., postal address, email ad dress, home page | responsible party. Other details (e.g., postal address, email ad dress, home page | |||
| URI) may also be included. | URI) may also be included.</dd> | |||
| </t> | <dt>Notes:</dt> | |||
| <t> | <dd>[optional]</dd> | |||
| Notes: | </dl> | |||
| <vspace/> | <t>Registrations <bcp14>MUST</bcp14> reference a freely available, | |||
| [optional] | stable specification, e.g., as described in <xref target="RFC8126" | |||
| </t> | section="4.6" sectionFormat="of"/>. This specification | |||
| </list> | <bcp14>MUST</bcp14> include security and privacy considerations | |||
| </t> | relevant to the extension.</t> | |||
| <t> | <t>Note that WebAuthn extensions can be registered by third parties | |||
| Registrations MUST reference a freely available, stable specificatio | (including the expert(s) themselves), if the expert(s) determines | |||
| n, e.g., as | that an unregistered extension is widely deployed and not likely to | |||
| described in Section 4.6 of <xref target="RFC8126"/>. | be registered in a timely manner otherwise. Such registrations still | |||
| This specification MUST include security and privacy considerations | are subject to the requirements defined, including the need to | |||
| relevant to the extension. | reference a specification.</t> | |||
| </t> | ||||
| <t> | ||||
| Note that WebAuthn extensions can be registered by third parties | ||||
| (including the expert(s) themselves), if the expert(s) determine tha | ||||
| t an unregistered extension is widely deployed and not likely to be | ||||
| registered in a timely manner otherwise. | ||||
| Such registrations still are subject to the requirements defined, in | ||||
| cluding the need to | ||||
| reference a specification. | ||||
| </t> | ||||
| </section> <!-- Registering Extension Identifiers --> | ||||
| <section title="Registration Request Processing" | </section> | |||
| anchor="sctn-registering-extension-idents-processing"> | ||||
| <section anchor="sctn-registering-extension-idents-processing" numbered= | ||||
| "true" toc="default"> | ||||
| <name>Registration Request Processing</name> | ||||
| <t> | <t> | |||
| As noted in <xref target="sctn-registering-extension-idents"/>, | As noted in <xref target="sctn-registering-extension-idents" format= "default"/>, | |||
| WebAuthn extension identifiers are registered using the | WebAuthn extension identifiers are registered using the | |||
| Specification Required policy. | Specification Required policy. | |||
| </t> | </t> | |||
| <t> | <t> | |||
| The expert(s) will clearly identify any issues that cause a registra tion to be refused, | The expert(s) will clearly identify any issues that cause a registra tion to be refused, | |||
| such as an incompletely specified extension. | such as an incompletely specified extension. | |||
| </t> | </t> | |||
| <t> | <t> | |||
| When a request is approved, the expert(s) will inform IANA, and the registration will | When a request is approved, the expert(s) will inform IANA, and the registration will | |||
| be processed. | be processed. | |||
| The IESG is the arbiter of any objection. | The IESG is the arbiter of any objection. | |||
| </t> | </t> | |||
| </section> | </section> | |||
| <section anchor="sctn-extension-ident-registry-values" numbered="true" t | ||||
| <section title="Initial WebAuthn Extension Identifier Registry Values" | oc="default"> | |||
| anchor="sctn-extension-ident-registry-values"> | <name>Initial Values in the WebAuthn Extension Identifiers Registry</n | |||
| ame> | ||||
| <t> | <t> | |||
| The initial values for the WebAuthn Extension Identifier Registry are | The initial values for the "WebAuthn Extension Identifiers" | |||
| to be populated from the values listed in | registry have been | |||
| populated with the values listed in the | ||||
| <eref target="https://www.w3.org/TR/2019/REC-webauthn-1-20190304/#sct n-extensions-reg"> | <eref target="https://www.w3.org/TR/2019/REC-webauthn-1-20190304/#sct n-extensions-reg"> | |||
| "WebAuthn Extension Identifier Registrations"</eref> | "WebAuthn Extension Identifier Registrations"</eref> section | |||
| of <xref target="WebAuthn"/>. | of <xref target="WebAuthn" format="default"/>. | |||
| Also, the Change Controller entry to be used for each of those regist | Also, the Change Controller entry for each of those registrations is: | |||
| rations is: | ||||
| <list style='symbols'> | ||||
| <t> | ||||
| Change Controller: W3C Web Authentication Working Group - public& | ||||
| #8209;webauthn@w3.org | ||||
| </t> | ||||
| </list> | ||||
| </t> | </t> | |||
| </section> | <dl newline="true"> | |||
| <dt>Change Controller:</dt> | ||||
| </section> <!-- Extension Identifier Registry --> | <dd> W3C Web Authentication Working Group (public&nbhy;webauthn@w3.or | |||
| g)</dd> | ||||
| </section> <!-- IANA Cons --> | </dl> | |||
| <section anchor="Security" title="Security Considerations"> | </section> | |||
| <t> | </section> | |||
| See <xref target="WebAuthn"/> for relevant security considerations. | ||||
| </t> | ||||
| </section> | ||||
| <section anchor="Acknowledgements" title="Acknowledgements"> | ||||
| <t> | ||||
| Thanks to Mark Nottingham | ||||
| for valuable comments and suggestions. | ||||
| Thanks to Kathleen Moriarty and Benjamin Kaduk for their Area Director s | ||||
| ponsorship | ||||
| of this specification. | ||||
| Thanks to | ||||
| Amanda Baber, | ||||
| Sarah Banks, | ||||
| Alissa Cooper, | ||||
| Roman Danyliw, | ||||
| Murray Kucherawy, | ||||
| Paul Kyzivat, | ||||
| Barry Leiba, | ||||
| Hilarie Orman, | ||||
| Magnus Westerlund, | ||||
| and Robert Wilton for their reviews. | ||||
| </t> | ||||
| </section> | </section> | |||
| <section anchor="sctn-history" title="Document History"> | <section anchor="Security" numbered="true" toc="default"> | |||
| <t>[[ to be removed by the RFC Editor before publication as an RFC ]]</t> | <name>Security Considerations</name> | |||
| <t>See <xref target="WebAuthn" format="default"/> for relevant security | ||||
| <t> | considerations.</t> | |||
| -10 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Changed IESG to IETF in Change Controller instructions, per suggestio | ||||
| n by Magnus Westerlund. | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| <t> | ||||
| -09 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Added Change Controller fields to registries, per suggestion by Magnu | ||||
| s Westerlund. | ||||
| </t> | ||||
| <t> | ||||
| Applied editorial suggestions by Amanda Baber, Murray Kucherawy, and | ||||
| Barry Leiba. | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| <t> | ||||
| -08 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Addressed review feedback by Murray Kucherawy. | ||||
| </t> | ||||
| <t> | ||||
| Added BCP 14 Requirements Notation and Conventions section. | ||||
| </t> | ||||
| <t> | ||||
| Referenced RFC 20, which defines ASCII characters. | ||||
| </t> | ||||
| <t> | ||||
| Applied editorial cleanups. | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| <t> | ||||
| -07 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Removed a duplicate URI listing pointed out by Hilarie Orman. | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| <t> | ||||
| -06 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Addressed Gen-Art review comments by Paul Kyzivat by deleting text ab | ||||
| out designated experts defining additional registry fields. | ||||
| </t> | ||||
| <t> | ||||
| Addressed Ops-Dir review comments by Sarah Banks by deleting text tha | ||||
| t duplicated requirements already specified in RFC 8126. | ||||
| </t> | ||||
| <t> | ||||
| Addressed Security review comments by Hilarie Orman by deleting unnec | ||||
| essary text about attestation statement formats lacking complete specifications. | ||||
| </t> | ||||
| <t> | ||||
| Replaced uses of the URL https://www.w3.org/TR/webauthn/ with https:/ | ||||
| /www.w3.org/TR/2019/REC-webauthn-1-20190304/ | ||||
| so that the reference remains stable after the level 2 WebAuthn spec | ||||
| ification is published. | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| <t> | ||||
| -05 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Updated to address the solicited IANA review comments, | ||||
| per discussions in an email thread between the authors and IANA ( "[I | ||||
| ANA #1154148]" ). | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| <t> | ||||
| -04 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Update per Benjamin Kaduk's further AD review: | ||||
| Remove 'final' wrt IESG arbitrating objections; Add explicit | ||||
| requirement for extension or attestation specs to include | ||||
| security and privacy considerations. | ||||
| </t> | ||||
| <t> | ||||
| Update per IANA review: Move "IANA considerations section up in doc | ||||
| to encompass (former) sections 2 and 3. | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| <t> | ||||
| -03 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Update per Benjamin Kaduk's AD review. Align with RFC 8288, rather t | ||||
| han | ||||
| draft-nottingham-rfc5988bis. | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| <t> | ||||
| -02 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Refresh now that the WebAuthn spec is at Recommendation (REC) maturi | ||||
| ty level. | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| <t> | ||||
| -01 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Refresh now that the WebAuthn Committee Recommendation (CR) draft is | ||||
| pending. | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| <t> | ||||
| -00 | ||||
| <list style="symbols"> | ||||
| <t> | ||||
| Initial version, based on draft-nottingham-rfc5988bis. | ||||
| </t> | ||||
| </list> | ||||
| </t> | ||||
| </section> | </section> | |||
| </middle> | </middle> | |||
| <back> | <back> | |||
| <references title="Normative References"> | ||||
| &rfc2119; | ||||
| &rfc5234; | ||||
| &rfc8126; | ||||
| &rfc8174; | ||||
| <reference anchor="RFC20" target="http://www.rfc-editor.org/info/rfc20"> | <displayreference target="RFC0020" to="RFC20"/> | |||
| <front> | ||||
| <title>ASCII format for Network Interchange</title> | <references> | |||
| <author fullname="Vint Cerf" surname="Cerf" initials="V."> | ||||
| <organization>University California Los Angeles (UCLA)</organization> | <name>Normative References</name> | |||
| </author> | <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/referen | |||
| <date month="October" year="1969"/> | ce.RFC.2119.xml"/> | |||
| </front> | <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/referen | |||
| <seriesInfo name="STD" value="80"/> | ce.RFC.5234.xml"/> | |||
| <seriesInfo name="RFC" value="20"/> | <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/referen | |||
| </reference> | ce.RFC.8126.xml"/> | |||
| <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/referen | ||||
| ce.RFC.8174.xml"/> | ||||
| <xi:include href="https://xml2rfc.tools.ietf.org/public/rfc/bibxml/referen | ||||
| ce.RFC.0020.xml"/> | ||||
| <reference anchor="WebAuthn" target="https://www.w3.org/TR/2019/REC-webaut hn-1-20190304/"> | <reference anchor="WebAuthn" target="https://www.w3.org/TR/2019/REC-webaut hn-1-20190304/"> | |||
| <front> | <front> | |||
| <title>Web Authentication: An API for accessing Public Key Credentials </title> | <title>Web Authentication: An API for accessing Public Key Credentials </title> | |||
| <seriesInfo name="World Wide Web Consortium (W3C)" value="Recommendati on"/> | ||||
| <author initials="D." surname="Balfanz" fullname="Dirk Balfanz"> | <author initials="D." surname="Balfanz" fullname="Dirk Balfanz"> | |||
| <organization>Google</organization> | <organization>Google</organization> | |||
| <address> | <address> | |||
| <email>balfanz@google.com</email> | <email>balfanz@google.com</email> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author initials="A." surname="Czeskis" fullname="Alexei Czeskis"> | <author initials="A." surname="Czeskis" fullname="Alexei Czeskis"> | |||
| <organization>Google</organization> | <organization>Google</organization> | |||
| <address> | <address> | |||
| <email>aczeskis@google.com</email> | <email>aczeskis@google.com</email> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author initials="J." surname="Hodges" fullname="Jeff Hodges"> | <author initials="J." surname="Hodges" fullname="Jeff Hodges"> | |||
| <organization>PayPal</organization> | <organization>PayPal</organization> | |||
| <address> | <address> | |||
| <email>jdhodges@google.com</email> | <email>jdhodges@google.com</email> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author initials="J.C." surname="Jones" fullname="J.C. Jones"> | <author initials="J.C." surname="Jones" fullname="J.C. Jones"> | |||
| <organization>Mozilla</organization> | <organization>Mozilla</organization> | |||
| <address> | <address> | |||
| <email>jc@mozilla.com</email> | <email>jc@mozilla.com</email> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author initials="M." surname="Jones" fullname="Michael B. Jones"> | ||||
| <author initials="M.B." surname="Jones" fullname="Michael B. Jones"> | ||||
| <organization>Microsoft</organization> | <organization>Microsoft</organization> | |||
| <address> | <address> | |||
| <email>mbj@microsoft.com</email> | <email>mbj@microsoft.com</email> | |||
| <uri>http://self-issued.info/</uri> | <uri>http://self-issued.info/</uri> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author initials="A." surname="Kumar" fullname="Akshay Kumar"> | <author initials="A." surname="Kumar" fullname="Akshay Kumar"> | |||
| <organization>Microsoft</organization> | <organization>Microsoft</organization> | |||
| <address> | <address> | |||
| <email>akshayku@microsoft.com</email> | <email>akshayku@microsoft.com</email> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author initials="A." surname="Liao" fullname="Angelo Liao"> | <author initials="A." surname="Liao" fullname="Angelo Liao"> | |||
| <organization>Microsoft</organization> | <organization>Microsoft</organization> | |||
| <address> | <address> | |||
| <email>huliao@microsoft.com</email> | <email>huliao@microsoft.com</email> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author initials="R." surname="Lindemann" fullname="Rolf Lindemann"> | <author initials="R." surname="Lindemann" fullname="Rolf Lindemann"> | |||
| <organization>Nok Nok Labs</organization> | <organization>Nok Nok Labs</organization> | |||
| <address> | <address> | |||
| <email>rolf@noknok.com</email> | <email>rolf@noknok.com</email> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author initials="E." surname="Lundberg" fullname="Emil Lundberg"> | <author initials="E." surname="Lundberg" fullname="Emil Lundberg"> | |||
| <organization>Yubico</organization> | <organization>Yubico</organization> | |||
| <address> | <address> | |||
| <email>emil@yubico.com</email> | <email>emil@yubico.com</email> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <date month="March" day="4" year="2019"/> | ||||
| <date month="March" day="4" year="2019" /> | ||||
| </front> | </front> | |||
| <seriesInfo name="World Wide Web Consortium (W3C)" value="Recommendation | ||||
| " /> | ||||
| <format type="HTML" target="https://www.w3.org/TR/2019/REC-webauthn-1-20 | ||||
| 190304/" /> | ||||
| </reference> | </reference> | |||
| </references> | </references> | |||
| <section anchor="Acknowledgements" numbered="false" toc="default"> | ||||
| <name>Acknowledgements</name> | ||||
| <t>Thanks to <contact fullname="Mark Nottingham"/> for valuable comments | ||||
| and suggestions. Thanks to <contact fullname="Kathleen Moriarty"/> and | ||||
| <contact fullname="Benjamin Kaduk"/> for their Area Director sponsorship | ||||
| of this specification. Thanks to <contact fullname="Amanda Baber"/>, | ||||
| <contact fullname="Sarah Banks"/>, <contact fullname="Alissa Cooper"/>, | ||||
| <contact fullname="Roman Danyliw"/>, <contact fullname="Murray | ||||
| Kucherawy"/>, <contact fullname="Paul Kyzivat"/>, <contact | ||||
| fullname="Barry Leiba"/>, <contact fullname="Hilarie Orman"/>, <contact | ||||
| fullname="Magnus Westerlund"/>, and <contact fullname="Robert Wilton"/> | ||||
| for their reviews.</t> | ||||
| </section> | ||||
| </back> | </back> | |||
| </rfc> | </rfc> | |||
| End of changes. 72 change blocks. | ||||
| 546 lines changed or deleted | 246 lines changed or added | |||
This html diff was produced by rfcdiff 1.45. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||