| rfc9038.original.xml | rfc9038.xml | |||
|---|---|---|---|---|
| <?xml version='1.0' encoding='utf-8'?> | <?xml version='1.0' encoding='utf-8'?> | |||
| <!DOCTYPE rfc SYSTEM "rfc2629-xhtml.ent" [ | <!DOCTYPE rfc SYSTEM "rfc2629-xhtml.ent"> | |||
| <!-- One method to get references from the online citation libraries. | ||||
| There has to be one entity for each item to be referenced. | ||||
| An alternate method (rfc include) is described in the references. --> | ||||
| <!ENTITY RFC2119 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .2119.xml"> | ||||
| <!ENTITY RFC3688 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .3688.xml"> | ||||
| <!ENTITY RFC3735 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .3735.xml"> | ||||
| <!ENTITY RFC3915 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .3915.xml"> | ||||
| <!ENTITY RFC5234 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .5234.xml"> | ||||
| <!ENTITY RFC5730 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .5730.xml"> | ||||
| <!ENTITY RFC5731 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .5731.xml"> | ||||
| <!ENTITY RFC5910 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .5910.xml"> | ||||
| <!ENTITY RFC7451 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .7451.xml"> | ||||
| <!ENTITY RFC7942 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .7942.xml"> | ||||
| <!ENTITY RFC8174 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .8174.xml"> | ||||
| <!ENTITY RFC8590 SYSTEM "http://xml.resource.org/public/rfc/bibxml/reference.RFC | ||||
| .8590.xml"> | ||||
| <!ENTITY I-D.narten-iana-considerations-rfc2434bis SYSTEM "http://xml.resource.o | ||||
| rg/public/rfc/bibxml3/reference.I-D.narten-iana-considerations-rfc2434bis.xml"> | ||||
| ]> | ||||
| <?xml-stylesheet type='text/xsl' href='rfc2629.xslt' ?> | ||||
| <!-- used by XSLT processors --> | ||||
| <!-- For a complete list and description of processing instructions (PIs), | ||||
| please see http://xml.resource.org/authoring/README.html. --> | ||||
| <!-- Below are generally applicable Processing Instructions (PIs) that most I-Ds | ||||
| might want to use. | ||||
| (Here they are set differently than their defaults in xml2rfc v1.32) --> | ||||
| <?rfc strict="yes" ?> | ||||
| <!-- give errors regarding ID-nits and DTD validation --> | ||||
| <!-- control the table of contents (ToC) --> | ||||
| <?rfc toc="yes"?> | ||||
| <!-- generate a ToC --> | ||||
| <?rfc tocdepth="4"?> | ||||
| <!-- the number of levels of subsections in ToC. default: 3 --> | ||||
| <!-- control references --> | ||||
| <?rfc symrefs="yes"?> | ||||
| <!-- use symbolic references tags, i.e, [RFC2119] instead of [1] --> | ||||
| <?rfc sortrefs="yes" ?> | ||||
| <!-- sort the reference entries alphabetically --> | ||||
| <!-- control vertical white space | ||||
| (using these PIs as follows is recommended by the RFC Editor) --> | ||||
| <?rfc compact="yes" ?> | ||||
| <!-- do not start each main section on a new page --> | ||||
| <?rfc subcompact="yes"?> | ||||
| <!-- keep one blank line between list items --> | ||||
| <?rfc comments="yes" ?> | ||||
| <!-- show cref output --> | ||||
| <?rfc inline="yes" ?> | ||||
| <!-- inline cref output --> | ||||
| <!-- end of list of popular I-D processing instructions --> | ||||
| <rfc xmlns:xi="http://www.w3.org/2001/XInclude" category="std" docName="draft-ie | ||||
| tf-regext-unhandled-namespaces-08" | ||||
| ipr="trust200902" obsoletes="" updates="" submissionType="IETF" xml:lang="en" | ||||
| tocInclude="true" tocDepth="4" | ||||
| symRefs="true" sortRefs="true" version="3" consensus="true"> | ||||
| <!-- ***** FRONT MATTER ***** --> | ||||
| <rfc xmlns:xi="http://www.w3.org/2001/XInclude" docName="draft-ietf-regext-unhan dled-namespaces-08" number="9038" ipr="trust200902" obsoletes="" updates="" subm issionType="IETF" category="std" consensus="true" xml:lang="en" tocInclude="true " tocDepth="4" symRefs="true" sortRefs="true" version="3"> | ||||
| <front> | <front> | |||
| <title abbrev="unhandledNamespaces"> | <title abbrev="Unhandled Namespaces"> | |||
| Extensible Provisioning Protocol (EPP) Unhandled Namespaces</title> | Extensible Provisioning Protocol (EPP) Unhandled Namespaces</title> | |||
| <seriesInfo name="Internet-Draft" value="draft-ietf-regext-unhandled-namespa ces-08"/> | <seriesInfo name="RFC" value="9038"/> | |||
| <author fullname="James Gould" surname="Gould"> | <author fullname="James Gould" surname="Gould"> | |||
| <organization>VeriSign, Inc.</organization> | <organization>VeriSign, Inc.</organization> | |||
| <address> | <address> | |||
| <postal> | <postal> | |||
| <street>12061 Bluemont Way</street> | <street>12061 Bluemont Way</street> | |||
| <city>Reston</city> | <city>Reston</city> | |||
| <region>VA</region> | <region>VA</region> | |||
| <code>20190</code> | <code>20190</code> | |||
| <country>US</country> | <country>United States of America</country> | |||
| </postal> | </postal> | |||
| <email>jgould@verisign.com</email> | <email>jgould@verisign.com</email> | |||
| <uri>http://www.verisigninc.com</uri> | <uri>http://www.verisign.com</uri> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <author fullname="Martin Casanova" surname="Casanova"> | <author fullname="Martin Casanova" surname="Casanova"> | |||
| <organization>SWITCH</organization> | <organization>SWITCH</organization> | |||
| <address> | <address> | |||
| <postal> | <postal> | |||
| <street>P.O. Box</street> | <street>P.O. Box</street> | |||
| <city>Zurich</city> | <city>Zurich</city> | |||
| <code>8021</code> | <code>8021</code> | |||
| <country>CH</country> | <country>Switzerland</country> | |||
| </postal> | </postal> | |||
| <email>martin.casanova@switch.ch</email> | <email>martin.casanova@switch.ch</email> | |||
| <uri>http://www.switch.ch</uri> | <uri>http://www.switch.ch</uri> | |||
| </address> | </address> | |||
| </author> | </author> | |||
| <date day="19" month="February" year="2021"/> | <date month="May" year="2021"/> | |||
| <keyword>login</keyword> | ||||
| <keyword>greeting</keyword> | ||||
| <keyword>URI</keyword> | ||||
| <keyword>namespace</keyword> | ||||
| <keyword>response</keyword> | ||||
| <keyword>general</keyword> | ||||
| <keyword>poll</keyword> | ||||
| <keyword>object-level</keyword> | ||||
| <keyword>command-response</keyword> | ||||
| <keyword>signal</keyword> | ||||
| <keyword>signaling</keyword> | ||||
| <abstract> | <abstract> | |||
| <t>The Extensible Provisioning Protocol (EPP), as defined in RFC 5730, | <t>The Extensible Provisioning Protocol (EPP), as defined in RFC 5730, | |||
| includes a method for the client and server to | includes a method for the client and server to | |||
| determine the objects to be managed during a session and the object | determine the objects to be managed during a session and the object | |||
| extensions to be used during a session. The services are identified using | extensions to be used during a session. The services are identified using | |||
| namespace URIs, and an "unhandled namespace" is one that is associated wit h | namespace URIs, and an "unhandled namespace" is one that is associated wit h | |||
| a service not supported by the client. | a service not supported by the client. | |||
| This document defines an operational practice that enables the server | This document defines an operational practice that enables the server | |||
| to return information associated with unhandled namespace URIs that is | to return information associated with unhandled namespace URIs and that | |||
| compliant with the negotiated services defined in | maintains compliance with the negotiated services defined in | |||
| RFC 5730.</t> | RFC 5730.</t> | |||
| </abstract> | </abstract> | |||
| </front> | </front> | |||
| <middle> | <middle> | |||
| <section numbered="true" toc="default"> | <section numbered="true" toc="default"> | |||
| <name>Introduction</name> | <name>Introduction</name> | |||
| <t>The Extensible Provisioning Protocol (EPP), as defined in <xref target= "RFC5730" format="default"/>, includes a method for the client and server to | <t>The Extensible Provisioning Protocol (EPP), as defined in <xref target= "RFC5730" format="default"/>, includes a method for the client and server to | |||
| determine the objects to be managed during a session and the object | determine the objects to be managed during a session and the object | |||
| extensions to be used during a session. The services are identified using | extensions to be used during a session. The services are identified using | |||
| namespace URIs. How should the server handle | namespace URIs. How should the server handle | |||
| service data that needs to be returned in the response when | service data that needs to be returned in the response when | |||
| the client does not support the required service namespace URI, | the client does not support the required service namespace URI, | |||
| which is referred to as an unhandled namespace? An unhandled namespace | which is referred to as an "unhandled namespace"? | |||
| is a significant issue for the processing of <xref target="RFC5730" format | An unhandled namespace | |||
| ="default"/> poll messages, since poll messages are inserted | is a significant issue for the processing of the poll messages described i | |||
| n <xref target="RFC5730" format="default"/>, since poll messages are inserted | ||||
| by the server prior to knowing the supported client services, | by the server prior to knowing the supported client services, | |||
| and the client needs to be capable of processing all poll messages. | and the client needs to be capable of processing all poll messages. | |||
| Returning an unhandled namespace poll message is not compliant with the ne gotiated services defined in | Returning an unhandled namespace poll message is not compliant with the ne gotiated services defined in | |||
| <xref target="RFC5730" format="default"/> and returning an error makes the unhandled namespace poll message | <xref target="RFC5730" format="default"/>, and returning an error makes th e unhandled namespace poll message | |||
| a poison message by halting the processing of the poll queue. | a poison message by halting the processing of the poll queue. | |||
| An unhandled namespace is an issue also for general EPP responses when the | An unhandled namespace is also an issue for general EPP responses when the | |||
| server has information that it cannot return to the client due to | server has information that it cannot return to the client due to | |||
| the client's supported services. The server should be able to return | the client's supported services. The server should be able to return | |||
| unhandled namespace information that | unhandled namespace information that | |||
| the client can process later. This document defines an operational | the client can process later. This document defines an operational | |||
| practice that enables the server to return information associated | practice that enables the server to return information associated | |||
| with unhandled namespace URIs that is compliant with the negotiated | with unhandled namespace URIs and that maintains compliance with the negot iated | |||
| services defined in <xref target="RFC5730" format="default"/>.</t> | services defined in <xref target="RFC5730" format="default"/>.</t> | |||
| <section numbered="true" toc="default"> | <section numbered="true" toc="default"> | |||
| <name>Conventions Used in This Document</name> | <name>Conventions Used in This Document</name> | |||
| <t>The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL | <t> | |||
| NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", | The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQU | |||
| "MAY", and "OPTIONAL" in this document are to be interpreted as | IRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL | |||
| described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> | NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14> | |||
| when, and only when, they | RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>", | |||
| appear in all capitals, as shown here.</t> | "<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to | |||
| <t>XML is case sensitive. Unless stated otherwise, XML specifications | be interpreted as | |||
| and examples provided in this document MUST be interpreted in the | described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> | |||
| when, and only when, they appear in all capitals, as shown here. | ||||
| </t> | ||||
| <t>XML <xref target="W3C.REC-xml11-20060816"/> is case sensitive. Unless | ||||
| stated otherwise, XML specifications | ||||
| and examples provided in this document <bcp14>MUST</bcp14> be interprete | ||||
| d in the | ||||
| character case presented in order to develop a conforming | character case presented in order to develop a conforming | |||
| implementation.</t> | implementation.</t> | |||
| <t>In examples, "S:" represents lines returned by a protocol server. | <t>In examples, "S:" represents lines returned by a protocol server. | |||
| Indentation and white space in examples are provided only to illustrate element relationships | Indentation and white space in examples are provided only to illustrate element relationships | |||
| and are not a required feature of this protocol. | and are not required features of this protocol. | |||
| </t> | </t> | |||
| <t>The examples reference XML namespace prefixes that are used for the a ssociated XML namespaces. | <t>The examples reference XML namespace prefixes that are used for the a ssociated XML namespaces. | |||
| Implementations MUST NOT depend on the example XML namespaces and instea d employ a proper | Implementations <bcp14>MUST NOT</bcp14> depend on the example XML namesp aces and instead employ a proper | |||
| namespace-aware XML parser and serializer to interpret and | namespace-aware XML parser and serializer to interpret and | |||
| output the XML documents. The example namespace prefixes used and their associated XML namespaces include:</t> | output the XML documents. The example namespace prefixes used and their associated XML namespaces include:</t> | |||
| <dl newline="false" spacing="compact" indent="4"> | <dl newline="false" spacing="normal" indent="4"> | |||
| <dt>"changePoll":</dt> | <dt>changePoll:</dt> | |||
| <dd>urn:ietf:params:xml:ns:changePoll-1.0</dd> | <dd>urn:ietf:params:xml:ns:changePoll-1.0</dd> | |||
| <dt>"domain":</dt> | <dt>domain:</dt> | |||
| <dd>urn:ietf:params:xml:ns:domain-1.0</dd> | <dd>urn:ietf:params:xml:ns:domain-1.0</dd> | |||
| <dt>"secDNS":</dt> | <dt>secDNS:</dt> | |||
| <dd>urn:ietf:params:xml:ns:secDNS-1.1</dd> | <dd>urn:ietf:params:xml:ns:secDNS-1.1</dd> | |||
| </dl> | </dl> | |||
| <t>In the template example XML, placeholder content is represented by th e following variables:</t> | <t>In the template example XML, placeholder content is represented by th e following variables:</t> | |||
| <dl newline="false" spacing="compact" indent="4"> | <dl newline="false" spacing="normal" indent="4"> | |||
| <dt>"[NAMESPACE-XML]":</dt> | <dt>[NAMESPACE-XML]:</dt> | |||
| <dd>XML content associated with a login service namespace URI. | <dd>XML content associated with a login service namespace URI. | |||
| An example is the <domain:infData> element content in <xref ta rget="RFC5731" format="default"/>.</dd> | An example is the <domain:infData> element content in <xref ta rget="RFC5731" format="default"/>.</dd> | |||
| <dt>"[NAMESPACE-URI]":</dt> | <dt>[NAMESPACE-URI]:</dt> | |||
| <dd>XML namespace URI associated with the [NAMESPACE-XML] XML content. | <dd>XML namespace URI associated with the [NAMESPACE-XML] XML content. | |||
| An example is "urn:ietf:params:xml:ns:domain-1.0" in <xref target="R FC5731" format="default"/>.</dd> | An example is "urn:ietf:params:xml:ns:domain-1.0" in <xref target="R FC5731" format="default"/>.</dd> | |||
| </dl> | </dl> | |||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="unhandledNamespace" numbered="true" toc="default"> | <section anchor="unhandledNamespace" numbered="true" toc="default"> | |||
| <name>Unhandled Namespaces</name> | <name>Unhandled Namespaces</name> | |||
| <t>An Unhandled Namespace is an XML namespace that is associated with a re sponse extension that is | <t>An unhandled namespace is an XML namespace that is associated with a re sponse extension that is | |||
| not included in the client-specified EPP login services of <xref target="RFC 5730" format="default"/>. The EPP login | not included in the client-specified EPP login services of <xref target="RFC 5730" format="default"/>. The EPP login | |||
| services consists of the set of XML namespace URIs included in the <objUR | services consist of the set of XML namespace URIs included in the <objURI | |||
| I> or <extURI> elements of | > or <extURI> elements of | |||
| the <xref target="RFC5730" format="default"/> EPP <login> command. Th | the EPP <login> command <xref target="RFC5730" format="default"/>. Th | |||
| e services supported by the server are | e services supported by the server are | |||
| included in the <objURI> and <extURI> elements of the <xref targ | included in the <objURI> and <extURI> elements of the EPP <gr | |||
| et="RFC5730" format="default"/> EPP <greeting>, which should be | eeting> <xref target="RFC5730" format="default"/>, which should be | |||
| a superset of the login services included in the EPP <login> command. A server may have information | a superset of the login services included in the EPP <login> command. A server may have information | |||
| associated with a specific namespace that it needs to return in the response to a client. The unhandled namespaces problem exists when the server | associated with a specific namespace that it needs to return in the response to a client. The unhandled namespaces problem exists when the server | |||
| has information that it needs to return to the client but the namespace of t he information is not supported by the client based on the | has information that it needs to return to the client, but the namespace of the information is not supported by the client based on the | |||
| negotiated EPP <login> command services.</t> | negotiated EPP <login> command services.</t> | |||
| </section> | </section> | |||
| <section anchor="extValueApproach" numbered="true" toc="default"> | <section anchor="extValueApproach" numbered="true" toc="default"> | |||
| <name>Use of EPP <extValue> for Unhandled Namespace Data</name> | <name>Use of EPP <extValue> for Unhandled Namespace Data</name> | |||
| <t>In <xref target="RFC5730" format="default"/>, the <extValue> elem ent is used to provide additional | <t>In <xref target="RFC5730" format="default"/>, the <extValue> elem ent is used to provide additional | |||
| error diagnostic information, including the <value> element that ide ntifies the client-provided element that caused | error diagnostic information, including the <value> element that ide ntifies the client-provided element that caused | |||
| a server error condition and the <reason> element containing the hum an-readable message that describes the reason for | a server error condition and the <reason> element containing the hum an-readable message that describes the reason for | |||
| the error. This operational practice extends the use of the <extValue& gt; element for the purpose of returning | the error. This operational practice extends the use of the <extValue& gt; element for the purpose of returning | |||
| unhandled namespace information in a successful response.</t> | unhandled namespace information in a successful response.</t> | |||
| <t>When a server has data to return to the client that the client does not support based on the login services, | <t>When a server has data to return to the client that the client does not support based on the login services, | |||
| the server MAY return a successful response, with the data for each unsupp | the server <bcp14>MAY</bcp14> return a successful response with the data f | |||
| orted namespace moved into an | or each unsupported namespace moved into an <extValue> element <xref targe | |||
| <xref target="RFC5730" format="default"/> <extValue> element. The u | t="RFC5730" format="default"/>. The unhandled namespace will not cause an error | |||
| nhandled namespace will not cause an error response, | response, | |||
| but the unhandled namespace data will instead be moved to an <extValue& gt; element, along with a reason why | but the unhandled namespace data will instead be moved to an <extValue& gt; element, along with a reason why | |||
| the unhandled namespace data could not be included in the appropriate loca tion of the response. | the unhandled namespace data could not be included in the appropriate loca tion of the response. | |||
| The <extValue> element XML will not be processed by the XML processo r. The <extValue> | The <extValue> element will not be processed by the XML processor. The <extValue> | |||
| element contains the following child elements: | element contains the following child elements: | |||
| </t> | </t> | |||
| <dl newline="false" spacing="compact" indent="4"> | <dl newline="false" spacing="normal" indent="4"> | |||
| <dt><value>:</dt> | <dt><value>:</dt> | |||
| <dd>Contains a child-element with the unhandled namespace XML. | <dd>Contains a child element with the unhandled namespace XML. | |||
| The unhandled namespace MUST be declared in the child element or any | The unhandled namespace <bcp14>MUST</bcp14> be declared in the child | |||
| containing element including the root element. | element or any | |||
| containing element, including the root element. | ||||
| XML processing of the <value> element is | XML processing of the <value> element is | |||
| disabled by the XML schema in <xref target="RFC5730" format="default" />, so the information can | disabled by the XML schema in <xref target="RFC5730" format="default" />, so the information can | |||
| safely be returned in the <value> element.</dd> | safely be returned in the <value> element.</dd> | |||
| <dt><reason>:</dt> | <dt><reason>:</dt> | |||
| <dd>A formatted human-readable message that indicates the reason the | <dd>A formatted, human-readable message that indicates the reason the | |||
| unhandled namespace data was not returned in the appropriate location of the response. The formatted reason | unhandled namespace data was not returned in the appropriate location of the response. The formatted reason | |||
| SHOULD follow the <xref target="RFC5234" format="default">Augmented Ba | <bcp14>SHOULD</bcp14> follow the <xref target="RFC5234" format="defaul | |||
| ckus-Naur Form (ABNF) grammar</xref> format: NAMESPACE-URI "not in login service | t">Augmented Backus-Naur Form (ABNF) grammar</xref> format: NAMESPACE-URI " not | |||
| s", | in login services", | |||
| where NAMESPACE-URI is the unhandled XML namespace like "urn:ietf:para | where NAMESPACE-URI is the unhandled XML namespace like "urn:ietf:para | |||
| ms:xml:ns:domain-1.0" for <xref target="RFC5731" format="default"/>.</dd> | ms:xml:ns:domain-1.0" in <xref target="RFC5731" format="default"/>.</dd> | |||
| </dl> | </dl> | |||
| <t>This document applies to the handling of unsupported namespaces for <xr | <t>This document applies to the handling of unsupported namespaces for obj | |||
| ef target="RFC3735" format="default"/> object-level extensions and command-respo | ect-level extensions and command-response extensions <xref target="RFC3735" form | |||
| nse extensions. | at="default"/>. | |||
| This document does not apply to the handling of unsupported namespaces for | This document does not apply to the handling of unsupported namespaces for | |||
| <xref target="RFC3735" format="default"/> protocol-level extensions or authenti | protocol-level extensions or authentication-information extensions <xref target | |||
| cation information extensions. | ="RFC3735" format="default"/>. | |||
| Refer to the following sections on how to handle an unsupported object-lev el extension namespace or an unsupported command-response extension namespace.</ t> | Refer to the following sections on how to handle an unsupported object-lev el extension namespace or an unsupported command-response extension namespace.</ t> | |||
| <section anchor="objectLevelExtension" numbered="true" toc="default"> | <section anchor="objectLevelExtension" numbered="true" toc="default"> | |||
| <name>Unhandled Object-Level Extension</name> | <name>Unhandled Object-Level Extension</name> | |||
| <t>An object-level extension in <xref target="RFC5730" format="default"/ > is a child element of the <resData> element. If the client does not han dle | <t>An object-level extension in <xref target="RFC5730" format="default"/ > is a child element of the <resData> element. If the client does not han dle | |||
| the namespace of the object-level extension, then the <resData> el | the namespace of the object-level extension, then the <resData> el | |||
| ement is removed and its object-level extension child element is moved into a | ement is removed and its object-level extension child element is moved into an & | |||
| <xref target="RFC5730" format="default"/> <extValue> <value> | lt;extValue> <value> element <xref target="RFC5730" format="default"/>, | |||
| element, with the namespace URI included in the corresponding <extValue> | with the namespace URI included in the corresponding <extValue> <reaso | |||
| <reason> element. | n> element. | |||
| The response becomes a general EPP response without the <resData> element.</t> | The response becomes a general EPP response without the <resData> element.</t> | |||
| <t keepWithNext="true">Template response for a supported object-level ex tension. | <t keepWithNext="true">Below is a template response for a supported obje ct-level extension. | |||
| The [NAMESPACE-XML] variable represents the object-level extension XML.< /t> | The [NAMESPACE-XML] variable represents the object-level extension XML.< /t> | |||
| <artwork name="" type="" align="left" alt=""><![CDATA[ | <sourcecode type="xml"><![CDATA[ | |||
| S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
| S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: </result> | S: </result> | |||
| S: <resData> | S: <resData> | |||
| S: [NAMESPACE-XML] | S: [NAMESPACE-XML] | |||
| S: </resData> | S: </resData> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S:</epp> | S:</epp> | |||
| ]]></artwork> | ]]></sourcecode> | |||
| <t keepWithNext="true">Template for an unhandled namespace response for | <t keepWithNext="true">Below is a template for an unhandled namespace re | |||
| an unsupported object-level extension. | sponse for an unsupported object-level extension. | |||
| The [NAMESPACE-XML] variable represents the object-level extension XML and | The [NAMESPACE-XML] variable represents the object-level extension XML, an | |||
| the [NAMESPACE-URI] | d the [NAMESPACE-URI] | |||
| variable represents the object-level extension XML namespace URI.</t> | variable represents the object-level extension XML namespace URI.</t> | |||
| <artwork name="" type="" align="left" alt=""><![CDATA[ | <sourcecode type="xml"><![CDATA[ | |||
| S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
| S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: <extValue> | S: <extValue> | |||
| S: <value> | S: <value> | |||
| S: [NAMESPACE-XML] | S: [NAMESPACE-XML] | |||
| S: </value> | S: </value> | |||
| S: <reason> | S: <reason> | |||
| S: [NAMESPACE-URI] not in login services | S: [NAMESPACE-URI] not in login services | |||
| S: </reason> | S: </reason> | |||
| S: </extValue> | S: </extValue> | |||
| S: </result> | S: </result> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S:</epp> | S:</epp> | |||
| ]]></artwork> | ]]></sourcecode> | |||
| <t>The EPP response is converted from an object response to a general EP | <t>The EPP response is converted from an object response to a general EP | |||
| P response by the server when the client does not support the object-level exten | P response by the server when the client does not support the object-level exten | |||
| sion namespace URI. | sion namespace URI.</t> | |||
| Below is an example of converting the <transfer> query response ex | <t keepWithNext="true">Below is an example of a <transfer> query r | |||
| ample in Section 3.1.3 of <xref target="RFC5731" format="default"/> to an unhand | esponse (see <xref target="RFC5731" sectionFormat="of" section="3.1.3"/>) conver | |||
| led namespace response.</t> | ted into an unhandled namespace response.</t> | |||
| <t keepWithNext="true"><xref target="RFC5731" format="default"/> example | <sourcecode type="xml"><![CDATA[ | |||
| <transfer> query response converted into an unhandled namespace response: | ||||
| </t> | ||||
| <artwork name="" type="" align="left" alt=""><![CDATA[ | ||||
| S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
| S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: <extValue> | S: <extValue> | |||
| S: <value> | S: <value> | |||
| S: <domain:trnData | S: <domain:trnData | |||
| S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| S: <domain:name>example.com</domain:name> | S: <domain:name>example.com</domain:name> | |||
| skipping to change at line 290 ¶ | skipping to change at line 253 ¶ | |||
| S: urn:ietf:params:xml:ns:domain-1.0 not in login services | S: urn:ietf:params:xml:ns:domain-1.0 not in login services | |||
| S: </reason> | S: </reason> | |||
| S: </extValue> | S: </extValue> | |||
| S: </result> | S: </result> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S:</epp> | S:</epp> | |||
| ]]></artwork> | ]]></sourcecode> | |||
| </section> | </section> | |||
| <section anchor="commandResponseLevelExtension" numbered="true" toc="defau lt"> | <section anchor="commandResponseLevelExtension" numbered="true" toc="defau lt"> | |||
| <name>Unhandled Command-Response Extension</name> | <name>Unhandled Command-Response Extension</name> | |||
| <t>A command-response extension in <xref target="RFC5730" format="defaul t"/> is a child element of the <extension> element. If the client does no t handle | <t>A command-response extension in <xref target="RFC5730" format="defaul t"/> is a child element of the <extension> element. If the client does no t handle | |||
| the namespace of the command-response extension, the command-response ch | the namespace of the command-response extension, the command-response ch | |||
| ild element is moved into an <xref target="RFC5730" format="default"/> <extVa | ild element is moved into an <extValue> <value> | |||
| lue> <value> | element <xref target="RFC5730" format="default"/>, with the namespace UR | |||
| element, with the namespace URI included in the corresponding <extVal | I included in the corresponding <extValue> <reason> element. Afterw | |||
| ue> <reason> element. If after moving the command-response child eleme | ards, if there | |||
| nt there | are no additional command-response child elements, the <extension> | |||
| are no additional command-response child elements, the <extension> | element <bcp14>MUST</bcp14> be removed.</t> | |||
| element MUST be removed.</t> | <t keepWithNext="true">Below is a template response for a supported comm | |||
| <t keepWithNext="true">Template response for a supported command-respons | and-response extension. | |||
| e extension. | ||||
| The [NAMESPACE-XML] variable represents the command-response extension X ML.</t> | The [NAMESPACE-XML] variable represents the command-response extension X ML.</t> | |||
| <artwork name="" type="" align="left" alt=""><![CDATA[ | <sourcecode type="xml"><![CDATA[ | |||
| S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
| S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: </result> | S: </result> | |||
| S: <extension> | S: <extension> | |||
| S: [NAMESPACE-XML] | S: [NAMESPACE-XML] | |||
| S: </extension> | S: </extension> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S:</epp> | S:</epp> | |||
| ]]></artwork> | ]]></sourcecode> | |||
| <t keepWithNext="true">Template unhandled namespace response for an unsu | <t keepWithNext="true">Below is a template of an unhandled namespace res | |||
| pported command-response extension. The [NAMESPACE-XML] variable represents the | ponse for an unsupported command-response extension. The [NAMESPACE-XML] variab | |||
| command-response extension XML and the | le represents the | |||
| command-response extension XML, and the | ||||
| [NAMESPACE-URI] variable represents the command-response extension XML n amespace URI.</t> | [NAMESPACE-URI] variable represents the command-response extension XML n amespace URI.</t> | |||
| <artwork name="" type="" align="left" alt=""><![CDATA[ | <sourcecode type="xml"><![CDATA[ | |||
| S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
| S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: <extValue> | S: <extValue> | |||
| S: <value> | S: <value> | |||
| S: [NAMESPACE-XML] | S: [NAMESPACE-XML] | |||
| S: </value> | S: </value> | |||
| S: <reason> | S: <reason> | |||
| S: [NAMESPACE-URI] not in login services | S: [NAMESPACE-URI] not in login services | |||
| S: </reason> | S: </reason> | |||
| S: </extValue> | S: </extValue> | |||
| S: </result> | S: </result> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S:</epp> | S:</epp> | |||
| ]]></artwork> | ]]></sourcecode> | |||
| <t>The EPP response is converted to an unhandled namespace response by m | <t>The EPP response is converted to an unhandled namespace response by m | |||
| oving the unhandled command-response extension from under the <extension> | oving the unhandled command-response extension from under the <extension> | |||
| to an <extValue> element. | to an <extValue> element.</t> | |||
| Below is example of converting the DS Data Interface <info> respon | <t keepWithNext="true">Below is example of the Delegation Signer (DS) Da | |||
| se example in Section 5.1.2 of <xref target="RFC5910" format="default"/> to an u | ta Interface <info> response (see <xref target="RFC5910" sectionFormat="of | |||
| nhandled namespace response.</t> | " section="5.1.2"/>) converted to an unhandled namespace response.</t> | |||
| <t keepWithNext="true"><xref target="RFC5910" format="default"/> DS Data | <sourcecode type="xml"><![CDATA[ | |||
| Interface <info> response converted into an unhandled namespace response: | ||||
| </t> | ||||
| <artwork name="" type="" align="left" alt=""><![CDATA[ | ||||
| S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
| S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" | S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" | |||
| S: xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> | S: xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: <extValue> | S: <extValue> | |||
| S: <value> | S: <value> | |||
| S: <secDNS:infData | S: <secDNS:infData | |||
| S: xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1"> | S: xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1"> | |||
| skipping to change at line 401 ¶ | skipping to change at line 363 ¶ | |||
| S: <domain:authInfo> | S: <domain:authInfo> | |||
| S: <domain:pw>2fooBAR</domain:pw> | S: <domain:pw>2fooBAR</domain:pw> | |||
| S: </domain:authInfo> | S: </domain:authInfo> | |||
| S: </domain:infData> | S: </domain:infData> | |||
| S: </resData> | S: </resData> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S:</epp>]]></artwork> | S:</epp> | |||
| ]]></sourcecode> | ||||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="signal-client-server-support" numbered="true" toc="default" > | <section anchor="signal-client-server-support" numbered="true" toc="default" > | |||
| <name>Signaling Client and Server Support</name> | <name>Signaling Client and Server Support</name> | |||
| <t>This document does not define new EPP protocol elements but rather spec ifies an operational practice using the existing EPP protocol, where | <t>This document does not define new EPP protocol elements but rather spec ifies an operational practice using the existing EPP protocol, where | |||
| the client and the server can signal support for the operational practic e using a namespace URI in the login and greeting extension services. | the client and the server can signal support for the operational practic e using a namespace URI in the login and greeting extension services. | |||
| The namespace URI "urn:ietf:params:xml:ns:epp:unhandled-namespaces-1.0" is used to signal support for the operational practice. The | The namespace URI "urn:ietf:params:xml:ns:epp:unhandled-namespaces-1.0" is used to signal support for the operational practice. The | |||
| client includes the namespace URI in an <svcExtension> <extURI& | client includes the namespace URI in an <svcExtension> <extURI& | |||
| gt; element of the <xref target="RFC5730" format="default"/> <login> Comma | gt; element of the <login> command <xref target="RFC5730" format="default" | |||
| nd. | />. | |||
| The server includes the namespace URI in an <svcExtension> <ext | The server includes the namespace URI in an <svcExtension> <ext | |||
| URI> element of the <xref target="RFC5730" format="default"/> Greeting.</t> | URI> element of the greeting <xref target="RFC5730" format="default"/>.</t> | |||
| <t>A client that receives the namespace URI in the server's Greeting exten | <t>A client that receives the namespace URI in the server's greeting exten | |||
| sion services can expect the following supported behavior by the server: | sion services can expect the following supported behavior by the server: | |||
| </t> | </t> | |||
| <ol spacing="compact" type="1"> | <ul spacing="normal"> | |||
| <li>Support unhandled namespace object-level extensions and command-resp | <li>support unhandled namespace object-level extensions and command-resp | |||
| onse extensions in EPP poll messages, per <xref target="usagePollMessages" forma | onse extensions in EPP poll messages, per <xref target="usagePollMessages" forma | |||
| t="default"/>.</li> | t="default"/></li> | |||
| <li>Support the option of unhandled namespace command-response extension | <li>support the option of unhandled namespace command-response extension | |||
| s in general EPP responses, per <xref target="usageGeneralResponses" format="def | s in general EPP responses, per <xref target="usageGeneralResponses" format="def | |||
| ault"/>.</li> | ault"/></li> | |||
| </ol> | </ul> | |||
| <t>A server that receives the namespace URI in the client's <login> | <t>A server that receives the namespace URI in the client's <login> | |||
| Command extension services can expect the following supported behavior by the cl | command extension services can expect the following supported behavior by the cl | |||
| ient: | ient: | |||
| </t> | </t> | |||
| <ol spacing="compact" type="1"> | <ul spacing="normal"> | |||
| <li>Support monitoring the EPP poll messages and general EPP responses f | <li>support monitoring the EPP poll messages and general EPP responses f | |||
| or unhandled namespaces.</li> | or unhandled namespaces</li> | |||
| </ol> | </ul> | |||
| </section> | </section> | |||
| <section anchor="usageGeneralResponses" numbered="true" toc="default"> | <section anchor="usageGeneralResponses" numbered="true" toc="default"> | |||
| <name>Usage with General EPP Responses</name> | <name>Usage with General EPP Responses</name> | |||
| <t>The unhandled namespace approach defined in <xref target="extValueAppro ach" format="default"/> | <t>The unhandled namespace approach defined in <xref target="extValueAppro ach" format="default"/> | |||
| MAY be used for a general EPP response to an EPP command. A general EPP r | <bcp14>MAY</bcp14> be used for a general EPP response to an EPP command. | |||
| esponse | A general EPP response | |||
| includes any non-poll message EPP response. The use of the unhandled name | includes any EPP response that is not a poll message. The use of the unha | |||
| space approach | ndled namespace approach | |||
| for poll message EPP responses is defined in <xref target="usagePollMessag | for poll-message EPP responses is defined in <xref target="usagePollMessag | |||
| es" format="default"/>. | es" format="default"/>. | |||
| The server MAY exclude the unhandled namespace information in the general | The server <bcp14>MAY</bcp14> exclude the unhandled namespace information | |||
| EPP response | in the general EPP response | |||
| or MAY include it using the unhandled namespace approach.</t> | or <bcp14>MAY</bcp14> include it using the unhandled namespace approach.</ | |||
| <t>The unhandled namespace approach for general EPP responses SHOULD only | t> | |||
| be applicable | <t>The unhandled namespace approach for general EPP responses <bcp14>SHOUL | |||
| D</bcp14> only be applicable | ||||
| to command-response extensions, defined in <xref target="commandResponseLe velExtension" format="default"/>, | to command-response extensions, defined in <xref target="commandResponseLe velExtension" format="default"/>, | |||
| since the server SHOULD NOT accept an object-level EPP command if the clie nt did not | since the server <bcp14>SHOULD NOT</bcp14> accept an object-level EPP comm and if the client did not | |||
| include the object-level namespace URI in the login services. An object-l evel | include the object-level namespace URI in the login services. An object-l evel | |||
| EPP response extension is returned when the server successfully executes a n | EPP response extension is returned when the server successfully executes a n | |||
| object-level EPP command extension. The server MAY return an unhandled | object-level EPP command extension. The server <bcp14>MAY</bcp14> return | |||
| object-level extension to the client as defined in <xref target="objectLev | an unhandled | |||
| elExtension" format="default"/>.</t> | object-level extension to the client, as defined in <xref target="objectLe | |||
| velExtension" format="default"/>.</t> | ||||
| <t>Returning domain name Redemption Grace Period (RGP) data, based on <xre f target="RFC3915" format="default"/>, | <t>Returning domain name Redemption Grace Period (RGP) data, based on <xre f target="RFC3915" format="default"/>, | |||
| provides an example of applying the unhandled namespace approach for a gen eral EPP response. | provides an example of applying the unhandled namespace approach for a gen eral EPP response. | |||
| If the client | If the client | |||
| does not include the "urn:ietf:params:xml:ns:rgp-1.0" namespace URI in the login | does not include the "urn:ietf:params:xml:ns:rgp-1.0" namespace URI in the login | |||
| services, and the domain <info> response of a domain name does have | services and the domain <info> response of a domain name does have R | |||
| RGP | GP | |||
| information, the server MAY exclude the <rgp:infData> element from t | information, the server <bcp14>MAY</bcp14> exclude the <rgp:infData> | |||
| he EPP response | element from the EPP response | |||
| or MAY include it under the <extValue> element per <xref target="com | or <bcp14>MAY</bcp14> include it under the <extValue> element, per < | |||
| mandResponseLevelExtension" format="default"/>. | xref target="commandResponseLevelExtension" format="default"/>.</t> | |||
| Below is example of converting the domain name <info> response examp | <t keepWithNext="true">Below is an example of a domain name <info> r | |||
| le in Section 4.1.2 of <xref target="RFC3915" format="default"/> to an unhandled | esponse <xref target="RFC5731" format="default"/> converted to an unhandled < | |||
| namespace response.</t> | rgp:infData> element (see <xref target="RFC3915" sectionFormat="of" section=" | |||
| <t keepWithNext="true"><xref target="RFC5731" format="default"/> domain na | 4.1.1"/>) included under an <extValue> element: | |||
| me <info> response with the unhandled | ||||
| <xref target="RFC3915" format="default"/> <rgp:infData> element incl | ||||
| uded under an <extValue> element: | ||||
| </t> | </t> | |||
| <artwork name="" type="" align="left" alt=""><![CDATA[ | <sourcecode type="xml"><![CDATA[ | |||
| S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
| S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" | S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" | |||
| S: xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" | S: xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" | |||
| S: xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 | S: xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 | |||
| S: epp-1.0.xsd"> | S: epp-1.0.xsd"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1000"> | S: <result code="1000"> | |||
| S: <msg>Command completed successfully</msg> | S: <msg>Command completed successfully</msg> | |||
| S: <extValue> | S: <extValue> | |||
| S: <value> | S: <value> | |||
| skipping to change at line 505 ¶ | skipping to change at line 466 ¶ | |||
| S: <domain:authInfo> | S: <domain:authInfo> | |||
| S: <domain:pw>2fooBAR</domain:pw> | S: <domain:pw>2fooBAR</domain:pw> | |||
| S: </domain:authInfo> | S: </domain:authInfo> | |||
| S: </domain:infData> | S: </domain:infData> | |||
| S: </resData> | S: </resData> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S:</epp>]]></artwork> | S:</epp> | |||
| ]]></sourcecode> | ||||
| </section> | </section> | |||
| <section anchor="usagePollMessages" numbered="true" toc="default"> | <section anchor="usagePollMessages" numbered="true" toc="default"> | |||
| <name>Usage with Poll Message EPP Responses</name> | <name>Usage with Poll-Message EPP Responses</name> | |||
| <t>The unhandled namespace approach, defined in <xref target="extValueAppr oach" format="default"/>, | <t>The unhandled namespace approach, defined in <xref target="extValueAppr oach" format="default"/>, | |||
| MUST be used if there is unhandled namespace information included in an EP P <poll> message response. | <bcp14>MUST</bcp14> be used if there is unhandled namespace information in cluded in a <poll> response. | |||
| The server inserts poll messages into the client's poll queue independent of knowing the supported | The server inserts poll messages into the client's poll queue independent of knowing the supported | |||
| client login services, therefore there may be unhandled object-level and c ommand-response | client login services; therefore, there may be unhandled object-level exte nsions and command-response | |||
| extensions included in a client's poll queue. In <xref target="RFC5730" f ormat="default"/>, the <poll> command | extensions included in a client's poll queue. In <xref target="RFC5730" f ormat="default"/>, the <poll> command | |||
| is used by the client to retrieve and acknowledge poll messages that have been | is used by the client to retrieve and acknowledge poll messages that have been | |||
| inserted by the server. The <poll> message response is an EPP respo | inserted by the server. The <poll> response is an EPP response that | |||
| nse that includes the | includes the | |||
| <msgQ> element that provides poll queue meta-data about the message. | <msgQ> element that provides poll queue metadata about the message. | |||
| The | The | |||
| unhandled namespace approach, defined in <xref target="extValueApproach" f ormat="default"/>, is used | unhandled namespace approach, defined in <xref target="extValueApproach" f ormat="default"/>, is used | |||
| for an unhandled object-level extension and for each of the | for an unhandled object-level extension and for each of the | |||
| unhandled command-response extensions attached to the <poll> message | unhandled command-response extensions attached to the <poll> respons | |||
| response. The resulting | e. The resulting | |||
| EPP <poll> message response MAY have either or both the object-level | <poll> response <bcp14>MAY</bcp14> have either or both the object-le | |||
| extension or | vel extension or | |||
| command-response extensions moved to <extValue> elements, as defined in | command-response extensions moved to <extValue> elements, as defined in | |||
| <xref target="extValueApproach" format="default"/>.</t> | <xref target="extValueApproach" format="default"/>.</t> | |||
| <t>The Change Poll Message, as defined in Section 3.1.2 of <xref target="R | <t>The change poll message, as defined in <xref target="RFC8590" sectionFo | |||
| FC8590" format="default"/>, which is an extension of any EPP object, | rmat="of" section="3.1.2"/>, which is an extension of any EPP object, | |||
| is an example of applying the unhandled namespace approach for EPP <pol | is an example of applying the unhandled namespace approach for <poll> | |||
| l> message responses. | ; responses. | |||
| Below are examples of converting the domain name <info> response exa | Below are examples of converting the domain name <info> response exa | |||
| mple in Section 3.1.2 of <xref target="RFC8590" format="default"/> to an unhandl | mple in <xref target="RFC8590" sectionFormat="of" section="3.1.2"/> to an unhand | |||
| ed namespace response. | led namespace response. | |||
| The object that will be used in the examples is a <xref target="RFC5731" f | The object that will be used in the examples is a domain name object <xref | |||
| ormat="default"/> domain name object.</t> | target="RFC5731" format="default"/>.</t> | |||
| <t keepWithNext="true"><xref target="RFC5731" format="default"/> domain na | <t keepWithNext="true">Below is a domain name <info> <poll> re | |||
| me <info> <poll> message response with the unhandled | sponse <xref target="RFC5731" format="default"/> with the unhandled <changePo | |||
| <xref target="RFC8590" format="default"/> <changePoll:changeData> el | ll:changeData> element <xref target="RFC8590" format="default"/> included und | |||
| ement included under an <extValue> element: | er an <extValue> element.</t> | |||
| </t> | <sourcecode type="xml"><![CDATA[ | |||
| <artwork name="" type="" align="left" alt=""><![CDATA[ | ||||
| S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
| S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1301"> | S: <result code="1301"> | |||
| S: <msg lang="en-US"> | S: <msg lang="en-US"> | |||
| S: Command completed successfully; ack to dequeue</msg> | S: Command completed successfully; ack to dequeue</msg> | |||
| S: <extValue> | S: <extValue> | |||
| S: <value> | S: <value> | |||
| S: <changePoll:changeData | S: <changePoll:changeData | |||
| S: xmlns:changePoll="urn:ietf:params:xml:ns:changePoll-1.0" | S: xmlns:changePoll="urn:ietf:params:xml:ns:changePoll-1.0" | |||
| skipping to change at line 581 ¶ | skipping to change at line 541 ¶ | |||
| S: <domain:crID>ClientY</domain:crID> | S: <domain:crID>ClientY</domain:crID> | |||
| S: <domain:crDate>2012-04-03T22:00:00.0Z</domain:crDate> | S: <domain:crDate>2012-04-03T22:00:00.0Z</domain:crDate> | |||
| S: <domain:exDate>2014-04-03T22:00:00.0Z</domain:exDate> | S: <domain:exDate>2014-04-03T22:00:00.0Z</domain:exDate> | |||
| S: </domain:infData> | S: </domain:infData> | |||
| S: </resData> | S: </resData> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S:</epp>]]></artwork> | S:</epp> | |||
| <t keepWithNext="true">Unhandled <xref target="RFC5731" format="default"/> | ]]></sourcecode> | |||
| domain name <info> <poll> message response and the unhandled | <t keepWithNext="true">Below is an unhandled domain name <info> < | |||
| <xref target="RFC8590" format="default"/> <changePoll:changeData> el | poll> response <xref target="RFC5731" format="default"/> and the unhandled | |||
| ement included under an <extValue> element: | <changePoll:changeData> element <xref target="RFC8590" format="defau | |||
| </t> | lt"/> included under an <extValue> element.</t> | |||
| <artwork name="" type="" align="left" alt=""><![CDATA[ | <sourcecode type="xml"><![CDATA[ | |||
| S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> | |||
| S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> | |||
| S: <response> | S: <response> | |||
| S: <result code="1301"> | S: <result code="1301"> | |||
| S: <msg>Command completed successfully; ack to dequeue</msg> | S: <msg>Command completed successfully; ack to dequeue</msg> | |||
| S: <extValue> | S: <extValue> | |||
| S: <value> | S: <value> | |||
| S: <domain:infData | S: <domain:infData | |||
| S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | S: xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"> | |||
| S: <domain:name>domain.example</domain:name> | S: <domain:name>domain.example</domain:name> | |||
| skipping to change at line 641 ¶ | skipping to change at line 601 ¶ | |||
| S: </result> | S: </result> | |||
| S: <msgQ count="201" id="1"> | S: <msgQ count="201" id="1"> | |||
| S: <qDate>2013-10-22T14:25:57.0Z</qDate> | S: <qDate>2013-10-22T14:25:57.0Z</qDate> | |||
| S: <msg>Registry initiated update of domain.</msg> | S: <msg>Registry initiated update of domain.</msg> | |||
| S: </msgQ> | S: </msgQ> | |||
| S: <trID> | S: <trID> | |||
| S: <clTRID>ABC-12345</clTRID> | S: <clTRID>ABC-12345</clTRID> | |||
| S: <svTRID>54322-XYZ</svTRID> | S: <svTRID>54322-XYZ</svTRID> | |||
| S: </trID> | S: </trID> | |||
| S: </response> | S: </response> | |||
| S:</epp>]]></artwork> | S:</epp> | |||
| ]]></sourcecode> | ||||
| </section> | </section> | |||
| <section anchor="ImplementationConsiderations" numbered="true" toc="default" > | <section anchor="ImplementationConsiderations" numbered="true" toc="default" > | |||
| <name>Implementation Considerations</name> | <name>Implementation Considerations</name> | |||
| <t>There are implementation considerations for the client and the server t o help address | <t>There are implementation considerations for the client and the server t o help address | |||
| the risk of the client ignoring unhandled namespace information included in an EPP response | the risk of the client ignoring unhandled namespace information included in an EPP response | |||
| that is needed to meet technical, policy, or legal requirements. | that is needed to meet technical, policy, or legal requirements. | |||
| </t> | </t> | |||
| <section anchor="ClientImplementationConsiderations" numbered="true" toc=" default"> | <section anchor="ClientImplementationConsiderations" numbered="true" toc=" default"> | |||
| <name>Client Implementation Considerations</name> | <name>Client Implementation Considerations</name> | |||
| <t>To reduce the likelihood of a client receiving unhandled namespace in formation, the | <t>To reduce the likelihood of a client receiving unhandled namespace in formation, the | |||
| client should consider implementing the following:</t> | client should consider implementing the following:</t> | |||
| <ol spacing="compact" type="1"> | <ol spacing="normal"> | |||
| <li>Ensure that the client presents the complete set of what it supp orts when presenting its login services. | <li>Ensure that the client presents the complete set of what it supp orts when presenting its login services. | |||
| If there are gaps between the services supported by the client and the login | If there are gaps between the services supported by the client and the login | |||
| services included in the login command, the client may | services included in the login command, the client may | |||
| receive unhandled namespace information that the client could have supported. | receive unhandled namespace information that the client could have supported. | |||
| </li> | </li> | |||
| <li>Support all of the services included in the server greeting serv ices that | <li>Support all of the services included in the server greeting serv ices that | |||
| may be included in an EPP response, including the poll queue respo nses. | may be included in an EPP response, including the <poll> res ponses. | |||
| The client should evaluate the gaps between the greeting services and the | The client should evaluate the gaps between the greeting services and the | |||
| login services provided in the login command to identify extension s that need | login services provided in the login command to identify extension s that need | |||
| to be supported.</li> | to be supported.</li> | |||
| <li>Proactively monitor for unhandled namespace information in the E PP | <li>Proactively monitor for unhandled namespace information in the E PP | |||
| responses by looking for the inclusion of the <extValue> eleme nt in | responses by looking for the inclusion of the <extValue> eleme nt in | |||
| successful responses, recording the unsupported namespace included i | successful responses, record the unsupported namespace included in t | |||
| n the | he | |||
| <reason> element, and recording the unhandled namespace inform | <reason> element, and record the unhandled namespace informati | |||
| ation included in the | on included in the | |||
| <value> element for later processing. The unhandled namespace should be implemented | <value> element for later processing. The unhandled namespace should be implemented | |||
| by the client to ensure that information is processed fully in futur e EPP responses.</li> | by the client to ensure that information is processed fully in futur e EPP responses.</li> | |||
| </ol> | </ol> | |||
| </section> | </section> | |||
| <section anchor="ServerImplementationConsiderations" numbered="true" toc=" default"> | <section anchor="ServerImplementationConsiderations" numbered="true" toc=" default"> | |||
| <name>Server Implementation Considerations</name> | <name>Server Implementation Considerations</name> | |||
| <t>To assist the clients in recognizing unhandled namespaces, the server should consider implementing the following:</t> | <t>To assist the clients in recognizing unhandled namespaces, the server should consider implementing the following:</t> | |||
| <ol spacing="compact" type="1"> | <ol spacing="normal" type="1"> | |||
| <li>Monitor for returning unhandled namespace information to clients and report it | <li>Monitor for returning unhandled namespace information to clients and report it | |||
| to the clients out-of-band to EPP so the clients can add support f | to the clients out of band to EPP, so the clients can add support | |||
| or | for | |||
| the unhandled namespaces. | the unhandled namespaces.</li> | |||
| </li> | ||||
| <li>Look for the unhandled namespace support in the login services w hen | <li>Look for the unhandled namespace support in the login services w hen | |||
| returning optional unhandled namespace information in General EPP | returning optional unhandled namespace information in general EPP | |||
| Responses. | responses.</li> | |||
| </li> | ||||
| </ol> | </ol> | |||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="IANA" numbered="true" toc="default"> | <section anchor="IANA" numbered="true" toc="default"> | |||
| <name>IANA Considerations</name> | <name>IANA Considerations</name> | |||
| <section anchor="IANA-XML-Namespace" numbered="true" toc="default"> | <section anchor="IANA-XML-Namespace" numbered="true" toc="default"> | |||
| <name>XML Namespace</name> | <name>XML Namespace</name> | |||
| <t> | <t> | |||
| This document uses URNs to describe XML namespaces | This document uses URNs to describe XML namespaces | |||
| conforming to a registry mechanism described in <xref target="RFC36 88" format="default"/>. | conforming to a registry mechanism described in <xref target="RFC36 88" format="default"/>. | |||
| The following URI assignment is requested of IANA: | The following URI assignment has been made by IANA. | |||
| </t> | </t> | |||
| <t>Registration request for the unhandled namespaces namespace:</t> | <dl newline="false" spacing="compact"> | |||
| <ul empty="true" spacing="compact"> | <dt>URI:</dt> | |||
| <li>URI: urn:ietf:params:xml:ns:epp:unhandled-namespaces-1.0</li> | <dd>urn:ietf:params:xml:ns:epp:unhandled-namespaces-1.0</dd> | |||
| <li>Registrant Contact: IESG</li> | <dt>Registrant Contact:</dt> | |||
| <li>XML: None. Namespace URIs do not represent an XML specification.</ | <dd>IESG</dd> | |||
| li> | <dt>XML:</dt> | |||
| </ul> | <dd>None. Namespace URIs do not represent an XML specification.</dd> | |||
| </dl> | ||||
| </section> | </section> | |||
| <section anchor="EPP-Extension-Registry" numbered="true" toc="default"> | <section anchor="EPP-Extension-Registry" numbered="true" toc="default"> | |||
| <name>EPP Extension Registry</name> | <name>EPP Extension Registry</name> | |||
| <t> | <t> | |||
| The EPP operational practice described in this document should be registered | The EPP operational practice described in this document has been registered b | |||
| by | y | |||
| the IANA in the EPP Extension Registry described in <xref target="RFC7451" fo | IANA in the "Extensions for the Extensible Provisioning Protocol (EPP)" regis | |||
| rmat="default"/>. The | try described in <xref target="RFC7451" format="default"/>. The | |||
| details of the registration are as follows: | details of the registration are as follows: | |||
| </t> | </t> | |||
| <t> | <dl newline="false" spacing="compact"> | |||
| Name of Extension: "Extensible Provisioning Protocol (EPP) Unhandled Namespac | <dt>Name of Extension:</dt> | |||
| es" | <dd>"Extensible Provisioning Protocol (EPP) Unhandled Namespaces"</dd> | |||
| </t> | <dt>Document Status:</dt> | |||
| <t> | <dd>Standards Track</dd> | |||
| Document status: Standards Track | <dt>Reference:</dt> | |||
| </t> | <dd>RFC 9038</dd> | |||
| <t> | <dt>Registrant:</dt> | |||
| Reference: (insert reference to RFC version of this document) | <dd>IETF, <iesg@ietf.org></dd> | |||
| </t> | <dt>TLDs:</dt> | |||
| <t> | <dd>Any</dd> | |||
| Registrant Name and Email Address: IETF, <iesg@ietf.org> | <dt>IPR Disclosure:</dt> | |||
| </t> | <dd>None</dd> | |||
| <t> | <dt>Status:</dt> | |||
| TLDs: Any | <dd>Active</dd> | |||
| </t> | <dt>Notes:</dt> | |||
| <t> | <dd>None</dd> | |||
| IPR Disclosure: None | </dl> | |||
| </t> | ||||
| <t> | ||||
| Status: Active | ||||
| </t> | ||||
| <t> | ||||
| Notes: None | ||||
| </t> | ||||
| </section> | ||||
| </section> | ||||
| <section anchor="Implementation" numbered="true" toc="default"> | ||||
| <name>Implementation Status</name> | ||||
| <t>Note to RFC Editor: Please remove this section and the reference to | ||||
| <xref target="RFC7942" format="default">RFC 7942</xref> before publicat | ||||
| ion.</t> | ||||
| <t>This section records the status of known implementations of the | ||||
| protocol defined by this specification at the time of posting of | ||||
| this Internet-Draft, and is based on a proposal described in <xref target= | ||||
| "RFC7942" format="default">RFC | ||||
| 7942</xref>. The description of implementations in this section is | ||||
| intended to assist the IETF in its decision processes in | ||||
| progressing drafts to RFCs. Please note that the listing of any | ||||
| individual implementation here does not imply endorsement by the | ||||
| IETF. Furthermore, no effort has been spent to verify the | ||||
| information presented here that was supplied by IETF contributors. | ||||
| This is not intended as, and must not be construed to be, a | ||||
| catalog of available implementations or their features. Readers | ||||
| are advised to note that other implementations may exist.</t> | ||||
| <t>According to <xref target="RFC7942" format="default">RFC 7942</xref>, " | ||||
| this will allow reviewers and working | ||||
| groups to assign due consideration to documents that have the | ||||
| benefit of running code, which may serve as evidence of valuable | ||||
| experimentation and feedback that have made the implemented | ||||
| protocols more mature. It is up to the individual working groups | ||||
| to use this information as they see fit".</t> | ||||
| <section numbered="true" toc="default"> | ||||
| <name>Verisign EPP SDK</name> | ||||
| <t>Organization: Verisign Inc.</t> | ||||
| <t>Name: Verisign EPP SDK</t> | ||||
| <t>Description: The Verisign EPP SDK includes an implementation of the | ||||
| unhandled namespaces for the processing of the poll queue messages.</t> | ||||
| <t>Level of maturity: Development</t> | ||||
| <t>Coverage: All aspects of the protocol are implemented.</t> | ||||
| <t>Licensing: GNU Lesser General Public License</t> | ||||
| <t>Contact: jgould@verisign.com</t> | ||||
| <t>URL: https://www.verisign.com/en_US/channel-resources/domain-registry | ||||
| -products/epp-sdks</t> | ||||
| </section> | ||||
| <section numbered="true" toc="default"> | ||||
| <name>SWITCH Automated DNSSEC Provisioning Process</name> | ||||
| <t>Organization: SWITCH</t> | ||||
| <t>Name: Registry of .CH and .LI</t> | ||||
| <t>Description: SWITCH uses poll messages to inform the registrar about | ||||
| DNSSEC changes at the registry triggered by CDS records. These poll messages are | ||||
| enriched with the 'urn:ietf:params:xml:ns:changePoll-1.0' and the 'urn:ietf:par | ||||
| ams:xml:ns:secDNS-1.1' extension that are rendered in the poll msg response acco | ||||
| rding to this draft.</t> | ||||
| <t>Level of maturity: Operational</t> | ||||
| <t>Coverage: All aspects of the protocol are implemented.</t> | ||||
| <t>Licensing: Proprietary</t> | ||||
| <t>Contact: martin.casanova@switch.ch</t> | ||||
| <t>URL: https://www.nic.ch/cds</t> | ||||
| </section> | </section> | |||
| </section> | </section> | |||
| <section anchor="Security" numbered="true" toc="default"> | <section anchor="Security" numbered="true" toc="default"> | |||
| <name>Security Considerations</name> | <name>Security Considerations</name> | |||
| <t>This document does not provide any | <t>This document does not provide any | |||
| security services beyond those described by <xref target="RFC5730" format= "default">EPP</xref> and protocol layers used by EPP. The security | security services beyond those described by <xref target="RFC5730" format= "default">EPP</xref> and protocol layers used by EPP. The security | |||
| considerations described in these other specifications apply to this | considerations described in these other specifications apply to this | |||
| specification as well. Since the unhandled namespace context is XML that | specification as well. Since the unhandled namespace content is XML that | |||
| is not processed in the first pass by the XML parser, | is not processed in the first pass by the XML parser, | |||
| the client SHOULD validate the XML when the content is processed to protec | the client <bcp14>SHOULD</bcp14> validate the XML when the content is proc | |||
| t against the inclusion of malicious content.</t> | essed to protect against the inclusion of malicious content.</t> | |||
| </section> | ||||
| <section anchor="Acknowledgements" numbered="true" toc="default"> | ||||
| <name>Acknowledgements</name> | ||||
| <t>The authors wish to thank the following persons for their feedback and | ||||
| suggestions: | ||||
| <contact fullname="Thomas Corte"/>, | ||||
| <contact fullname="Scott Hollenbeck"/>, | ||||
| <contact fullname="Patrick Mevzek"/>, | ||||
| and <contact fullname="Marcel Parodi"/>. | ||||
| </t> | ||||
| </section> | </section> | |||
| </middle> | </middle> | |||
| <!-- *****BACK MATTER ***** --> | ||||
| <back> | <back> | |||
| <!-- References split into informative and normative --> | ||||
| <!-- There are 2 ways to insert reference entries from the citation librarie | ||||
| s: | ||||
| 1. define an ENTITY at the top, and use "ampersand character"RFC2629; here | ||||
| (as shown) | ||||
| 2. simply use a PI "less than character"?rfc include="reference.RFC.2119.xm | ||||
| l"?> here | ||||
| (for I-Ds: include="reference.I-D.narten-iana-considerations-rfc2434bis. | ||||
| xml") | ||||
| Both are cited textually in the same manner: by using xref elements. | ||||
| If you use the PI option, xml2rfc will, by default, try to find included fi | ||||
| les in the same | ||||
| directory as the including file. You can also define the XML_LIBRARY enviro | ||||
| nment variable | ||||
| with a value containing a set of directories to search. These can be eithe | ||||
| r in the local | ||||
| filing system or remote ones accessed by http (http://domain/dir/... ).--> | ||||
| <references> | <references> | |||
| <name>References</name> | <name>References</name> | |||
| <references> | <references> | |||
| <name>Normative References</name> | <name>Normative References</name> | |||
| &RFC2119; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.2119.xml"/> | |||
| &RFC3688; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.3688.xml"/> | |||
| &RFC5234; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.5234.xml"/> | |||
| &RFC5730; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.5730.xml"/> | |||
| &RFC5731; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.5731.xml"/> | |||
| &RFC7942; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.8174.xml"/> | |||
| &RFC8174; | <reference anchor='W3C.REC-xml11-20060816' | |||
| target='https://www.w3.org/TR/2006/REC-xml11-20060816'> | ||||
| <front> | ||||
| <title>Extensible Markup Language (XML) 1.1 (Second Edition)</title> | ||||
| <author initials='T.' surname='Bray' fullname='Tim Bray'> | ||||
| <organization /> | ||||
| </author> | ||||
| <author initials='J.' surname='Paoli' fullname='Jean Paoli'> | ||||
| <organization /> | ||||
| </author> | ||||
| <author initials='M.' surname='Sperberg-McQueen' fullname='Michael Sperberg-McQu | ||||
| een'> | ||||
| <organization /> | ||||
| </author> | ||||
| <author initials='E.' surname='Maler' fullname='Eve Maler'> | ||||
| <organization /> | ||||
| </author> | ||||
| <author initials='F.' surname='Yergeau' fullname='François Yergeau'> | ||||
| <organization /> | ||||
| </author> | ||||
| <author initials='J.' surname='Cowan' fullname='John Cowan'> | ||||
| <organization /> | ||||
| </author> | ||||
| <date month='August' day='16' year='2006' /> | ||||
| </front> | ||||
| <seriesInfo name='World Wide Web Consortium Recommendation' value='REC-xml11-200 | ||||
| 60816' /> | ||||
| <format type='HTML' target='https://www.w3.org/TR/2006/REC-xml11-20060816' /> | ||||
| </reference> | ||||
| </references> | </references> | |||
| <references> | <references> | |||
| <name>Informative References</name> | <name>Informative References</name> | |||
| &RFC3735; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.3735.xml"/> | |||
| &RFC3915; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.3915.xml"/> | |||
| &RFC5910; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.5910.xml"/> | |||
| &RFC7451; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.7451.xml"/> | |||
| &RFC8590; | <xi:include href="https://xml2rfc.ietf.org/public/rfc/bibxml/reference.R FC.8590.xml"/> | |||
| </references> | </references> | |||
| </references> | </references> | |||
| <section numbered="true" toc="default"> | ||||
| <name>Change History</name> | <section anchor="Acknowledgements" numbered="false" toc="default"> | |||
| <section anchor="version-00-to-01" numbered="true" toc="default"> | <name>Acknowledgements</name> | |||
| <name>Change from 00 to 01</name> | <t>The authors wish to thank the following people for their feedback and s | |||
| <ol spacing="compact" type="1"> | uggestions: | |||
| <li>Removed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" refe | <contact fullname="Thomas Corte"/>, | |||
| rence from examples.</li> | <contact fullname="Scott Hollenbeck"/>, | |||
| <li>removed <extension></extension> block from example.</l | <contact fullname="Patrick Mevzek"/>, | |||
| i> | and <contact fullname="Marcel Parodi"/>. | |||
| <li>added SWITCH Automated DNSSEC Provisioning Process at Implementati | </t> | |||
| on Status</li> | ||||
| </ol> | ||||
| </section> | ||||
| <section anchor="version-01-to-02" numbered="true" toc="default"> | ||||
| <name>Change from 01 to 02</name> | ||||
| <ol spacing="compact" type="1"> | ||||
| <li>Ping update</li> | ||||
| </ol> | ||||
| </section> | ||||
| <section anchor="change-02-to-WG00" numbered="true" toc="default"> | ||||
| <name>Change from 02 to REGEXT 00</name> | ||||
| <ol spacing="compact" type="1"> | ||||
| <li>Changed to regext working group draft by changing draft-gould-casa | ||||
| nova-regext-unhandled-namespaces to draft-ietf-regext-unhandled-namespaces.</li> | ||||
| </ol> | ||||
| </section> | ||||
| <section anchor="change-WG00-to-WG01" numbered="true" toc="default"> | ||||
| <name>Change from REGEXT 00 to REGEXT 01</name> | ||||
| <ol spacing="compact" type="1"> | ||||
| <li>Added the "Signaling Client and Server Support" section to describ | ||||
| e the mechanism to signal support for the BCP by the client and the server.</li> | ||||
| <li>Added the IANA Considerations section with the registration of the | ||||
| unhandled namespaces | ||||
| XML namespace and the registration of the EPP Best Current Practice | ||||
| (BCP) in the EPP Extension Registry.</li> | ||||
| </ol> | ||||
| </section> | ||||
| <section anchor="change-WG01-to-WG02" numbered="true" toc="default"> | ||||
| <name>Change from REGEXT 01 to REGEXT 02</name> | ||||
| <ol spacing="compact" type="1"> | ||||
| <li>Filled in the acknowledgements section.</li> | ||||
| <li>Changed the reference from RFC 5730 to RFC 5731 for the transfer e | ||||
| xample in section 3.1 "Unhandled Object-Level" Extension.</li> | ||||
| <li>Updated the XML namespace to urn:ietf:params:xml:ns:epp:unhandled- | ||||
| namespaces-1.0, which removed bcp from the namespace and bumped the version from | ||||
| 0.1 and 1.0. | ||||
| Inclusion of bcp in the XML namespace was discussed at the REGEXT inte | ||||
| rim meeting.</li> | ||||
| </ol> | ||||
| </section> | ||||
| <section anchor="change-WG02-to-WG03" numbered="true" toc="default"> | ||||
| <name>Change from REGEXT 02 to REGEXT 03</name> | ||||
| <ol spacing="compact" type="1"> | ||||
| <li>Converted from xml2rfc v2 to v3.</li> | ||||
| <li>Updated Acknowledgements to match the approach taken by the RFC Ed | ||||
| itor with draft-ietf-regext-login-security.</li> | ||||
| <li>Changed reference of ietf-regext-change-poll to RFC 8590.</li> | ||||
| </ol> | ||||
| </section> | ||||
| <section anchor="change-WG03-to-WG04" numbered="true" toc="default"> | ||||
| <name>Change from REGEXT 03 to REGEXT 04</name> | ||||
| <ol spacing="compact" type="1"> | ||||
| <li>Changed from Best Current Practice (BCP) to Standards Track based | ||||
| on mailing list discussion.</li> | ||||
| <li>Revised the dates in the examples to be more up-to-date.</li> | ||||
| </ol> | ||||
| </section> | ||||
| <section anchor="change-WG04-to-WG05" numbered="true" toc="default"> | ||||
| <name>Change from REGEXT 04 to REGEXT 05</name> | ||||
| <ol spacing="compact" type="1"> | ||||
| <li>Based on feedback from Thomas Corte, added a description of the &l | ||||
| t;extValue> element in RFC 5730 and | ||||
| it being extended to support returning unhandled namespace informati | ||||
| on.</li> | ||||
| <li>Based on feedback from Thomas Corte, added a Implementation Consid | ||||
| erations section to cover client and server | ||||
| implementation recommendations such as monitoring unhandled namespaces | ||||
| in the server to report to the clients out-of-band and | ||||
| monitoring for responses containing unhanded namespace information in | ||||
| the client to proactively add support | ||||
| for the unhandled namespaces.</li> | ||||
| <li>Moved RFC 3735 and RFC 7451 to informative references to address d | ||||
| own reference errors in idnits.</li> | ||||
| </ol> | ||||
| </section> | ||||
| <section anchor="change-WG05-to-WG06" numbered="true" toc="default"> | ||||
| <name>Change from REGEXT 05 to REGEXT 06</name> | ||||
| <ol spacing="compact" type="1"> | ||||
| <li>Nit updates made based on the feedback provided by the Document Sh | ||||
| epherd, David Smith.</li> | ||||
| </ol> | ||||
| </section> | ||||
| <section anchor="change-WG06-to-WG07" numbered="true" toc="default"> | ||||
| <name>Change from REGEXT 06 to REGEXT 07</name> | ||||
| <t>Updates based on the Barry Leiba (AD) feedback: | ||||
| </t> | ||||
| <ol spacing="compact" type="1"> | ||||
| <li>Simplified the abstract based on the proposal provided by the AD.< | ||||
| /li> | ||||
| <li>In section 1.1, updated to use the new BCP 14 boilerplate and add | ||||
| a normative reference to RFC 8174.</li> | ||||
| <li>In section 1.1, changed "REQUIRED feature of this protocol" to "re | ||||
| quired feature of this protocol".</li> | ||||
| <li>In section 3, added "by the XML schema" in "disabled by the XML sc | ||||
| hema in [RFC5730]" to clarify the statement.</li> | ||||
| <li>In section 8.2, changed the Registrant Name from "IESG" to "IETF". | ||||
| </li> | ||||
| <li>In section 10, changed "The document do not provide" to "This docu | ||||
| ment does not provide".</li> | ||||
| <li>In section 10, added the sentence "Since the unhandled namespace c | ||||
| ontext is XML that is not processed in the first pass by the XML parser, | ||||
| the client SHOULD consider validating the XML when the content is pr | ||||
| ocessed to protect against the inclusion of malicious content.".</li> | ||||
| </ol> | ||||
| </section> | ||||
| <section anchor="change-WG07-to-WG08" numbered="true" toc="default"> | ||||
| <name>Change from REGEXT 07 to REGEXT 08</name> | ||||
| <ol spacing="compact" type="1"> | ||||
| <li>Nit updates made based on the feedback provided by Peter Yee.</li> | ||||
| <li>Update to the definition of the <value> element based on fee | ||||
| dback from Sabrina Tanamal.</li> | ||||
| <li>Added a sentence in the Introduction section to cover the poison p | ||||
| oll message motivation based on feedback from Qin Wu.</li> | ||||
| <li>Changed "does not define new protocol" to "does not define new EPP | ||||
| protocol elements" based on feedback from Erik Kline.</li> | ||||
| <li>Changed to use "apply" instead of "support" language in Section 3 | ||||
| based on feedback from Benjamin Kaduk.</li> | ||||
| <li>Updated the examples that reference RFC examples to reference the | ||||
| RFC section of the example and have the starting XML match based on feedback fro | ||||
| m Benjamin Kaduk.</li> | ||||
| <li>Changed "SHOULD consider validating" to "SHOULD validate" in the S | ||||
| ecurity Considerations section based on feedback from Benjamin Kaduk.</li> | ||||
| <li>Moved RFC 3915, RFC 5910, and RFC 8590 as informational references | ||||
| based on feedback from Benjamin Kaduk.</li> | ||||
| </ol> | ||||
| </section> | ||||
| </section> | </section> | |||
| </back> | </back> | |||
| <!-- vim: set ts=2 sw=2 expandtab: --> | ||||
| </rfc> | </rfc> | |||
| End of changes. 88 change blocks. | ||||
| 557 lines changed or deleted | 323 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||