Network Working Group | J. Gould |
Internet-Draft | M. Pozun |
Intended status: Standards Track | VeriSign, Inc. |
Expires: December 16, 2018 | June 14, 2018 |
Login Security Extension for the Extensible Provisioning Protocol (EPP)
draft-gould-regext-login-security-01
The Extensible Provisioning Protocol (EPP) includes a client authentication scheme that is based on a user identifier and password. The structure of the password field is defined by an XML Schema data type that specifies minimum and maximum password length values, but there are no other provisions for password management other than changing the password. This document describes an EPP extension that allows longer passwords to be created and adds additional security features to the EPP login command and response.
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."
This Internet-Draft will expire on December 16, 2018.
Copyright (c) 2018 IETF Trust and the persons identified as the document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.
This document describes an Extensible Provisioning Protocol (EPP) extension for enhancing the security of the EPP login command in EPP RFC 5730. The enhancements include supporting longer passwords (or passphrases) than the 16-character maximum and providing a list of security events in the login response. The password (current and new) in EPP RFC 5730 can be overridden by the password included in the extension to extend past the 16-character maximum. The security events supported include: password expiry, client certificate expiry, insecure cipher, insecure TLS protocol, new pasword complexity, login security statistical warning, and a custom event. The attributes supported by the security events include identifying the event type or sub-type, indicating the security level of warning or error, a future or past-due expiration date, the value that resulted in the event, the duration of the statistical event, and a free-form description with an optional language.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
XML is case sensitive. Unless stated otherwise, XML specifications and examples provided in this document MUST be interpreted in the character case presented in order to develop a conforming implementation.
In examples, "C:" represents lines sent by a protocol client and "S:" represents lines returned by a protocol server. Indentation and white space in examples are provided only to illustrate element relationships and are not a REQUIRED feature of this protocol.
"loginSec-0.2" is used as an abbreviation for "urn:ietf:params:xml:ns:loginSec-0.2". The XML namespace prefix "loginSec" is used, but implementations MUST NOT depend on it and instead employ a proper namespace-aware XML parser and serializer to interpret and output the XML documents.
(Note to RFC Editor: remove this section before publication as an RFC.)
Servers which implement this extension SHOULD provide a way for clients to progressively update their implementations when a new version of the extension is deployed.
Servers SHOULD (for a temporary migration period) provide support for older versions of the extension in parallel to the newest version, and allow clients to select their preferred version via the <svcExtension> element of the <login> command.
If a client requests multiple versions of the extension at login, then, when preparing responses to commands which do not include extension elements, the server SHOULD only include extension elements in the namespace of the newest version of the extension requested by the client.
When preparing responses to commands which do include extension elements, the server SHOULD only include extension elements for the extension versions present in the command.
This extension adds additional elements to [RFC5730] login command and response. Only those new elements are described here.
A security event, using the <loginSec:event> element, represents either a warning or error identified by the server after the client has connected and submitted the login command. There MAY be multiple events returned that provides information for the client to address. The <loginSec:event> MAY include a free form description. All of the security events use a consistent set of attributes, where the exact set of applicable attributes is based on the event type. The supported set of <loginSec:event> element attributes include:
Example login security event for a password expiring in a week:
<loginSec:event type="password" level="warning" exDate="2018-04-01T22:00:00.0Z" lang="en"> Password expiration soon </loginSec:event>
Example login security event for identifying 100 failed logins over the last day, using the "stat" sub-type of "failedLogins":
<loginSec:event type="stat" name="failedLogins" level="warning" value="100" duration="P1D"> Excessive invalid daily logins </loginSec:event>
The <loginSec:pw> element MUST override the [RFC5730] <pw> element only if the <pw> contains the predefined value of "[LOGIN-SECURITY]", which is a constant value for the server to use the <loginSec:pw> element for the password. Similarly, the <loginSec:newPw> element MUST override the [RFC5730] <newPw> element only if the <newPw> contains the predefined value of "[LOGIN-SECURITY]", which is a constant value for the server to use the <loginSec:newPw> element for the new password. The "[LOGIN-SECURITY]" pre-defined string MUST be supported by the server for the client to explicitly indicate to the server whether to use <loginSec:pw> element in place of the [RFC5730] <pw> element or to use the <loginSec:newPW> in place of the [RFC5730] <newPW> element.
Date and time attribute values MUST be represented in Universal Coordinated Time (UTC) using the Gregorian calendar. The extended date-time form using upper case "T" and "Z" characters defined in [W3C.REC-xmlschema-2-20041028] MUST be used to represent date-time values, as XML Schema does not support truncated date-time forms or lower case "T" and "Z" characters.
A detailed description of the EPP syntax and semantics can be found in the EPP core protocol specification [RFC5730].
This extension defines additional elements to extend the EPP <login> command and response to be used in conjunction with [RFC5730].
The EPP <login> command is used to establish a session with an EPP server. This extension overrides the password that is passed with the [RFC5730] <pw> or the <newPw> element as defined in Section 3.2. A <loginSec:loginSec> element is sent along with the [RFC5730] <login> command and contains the following child elements:
Example login command that uses the <loginSec:pw> element instead of the [RFC5730] <pw> element to establish the session and includes the <loginSec:userAgent> element:
C:<?xml version="1.0" encoding="UTF-8" standalone="no"?> C:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> C: <command> C: <login> C: <clID>ClientX</clID> C: <pw>[LOGIN-SECURITY]</pw> C: <options> C: <version>1.0</version> C: <lang>en</lang> C: </options> C: <svcs> C: <objURI>urn:ietf:params:xml:ns:obj1</objURI> C: <objURI>urn:ietf:params:xml:ns:obj2</objURI> C: <objURI>urn:ietf:params:xml:ns:obj3</objURI> C: <svcExtension> C: <extURI>urn:ietf:params:xml:ns:loginSec-0.2</extURI> C: </svcExtension> C: </svcs> C: </login> C: <extension> C: <loginSec:loginSec C: xmlns:loginSec= C: "urn:ietf:params:xml:ns:loginSec-0.2"> C: <loginSec:userAgent>EPP SDK/1.0.0 C: (Java 1.7.0_15; x86_64 Mac OS X 10.11.6) C: </loginSec:userAgent> C: <loginSec:pw>this is a long password</loginSec:pw> C: </loginSec:loginSec> C: </extension> C: <clTRID>ABC-12345</clTRID> C: </command> C:</epp>
Example login command that uses the <loginSec:pw> element instead of the [RFC5730] <pw> element to establish the session, and uses the <loginSec:newPw> element instead of the [RFC5730] <newPw> element to set the new password:
C:<?xml version="1.0" encoding="UTF-8" standalone="no"?> C:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> C: <command> C: <login> C: <clID>ClientX</clID> C: <pw>[LOGIN-SECURITY]</pw> C: <newPW>[LOGIN-SECURITY]</newPW> C: <options> C: <version>1.0</version> C: <lang>en</lang> C: </options> C: <svcs> C: <objURI>urn:ietf:params:xml:ns:obj1</objURI> C: <objURI>urn:ietf:params:xml:ns:obj2</objURI> C: <objURI>urn:ietf:params:xml:ns:obj3</objURI> C: <svcExtension> C: <extURI>urn:ietf:params:xml:ns:loginSec-0.2</extURI> C: </svcExtension> C: </svcs> C: </login> C: <extension> C: <loginSec:loginSec C: xmlns:loginSec= C: "urn:ietf:params:xml:ns:loginSec-0.2"> C: <loginSec:pw>this is a long password C: </loginSec:pw> C: <loginSec:newPW>new password that is still long C: </loginSec:newPW> C: </loginSec:loginSec> C: </extension> C: <clTRID>ABC-12345</clTRID> C: </command> C:</epp>
Example login command that uses the [RFC5730] <pw> element to establish the session, and uses the <loginSec:newPw> element instead of the [RFC5730] <newPw> element to set the new password:
C:<?xml version="1.0" encoding="UTF-8" standalone="no"?> C:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> C: <command> C: <login> C: <clID>ClientX</clID> C: <pw>shortpassword</pw> C: <newPW>[LOGIN-SECURITY]</newPW> C: <options> C: <version>1.0</version> C: <lang>en</lang> C: </options> C: <svcs> C: <objURI>urn:ietf:params:xml:ns:obj1</objURI> C: <objURI>urn:ietf:params:xml:ns:obj2</objURI> C: <objURI>urn:ietf:params:xml:ns:obj3</objURI> C: <svcExtension> C: <extURI>urn:ietf:params:xml:ns:loginSec-0.2</extURI> C: </svcExtension> C: </svcs> C: </login> C: <extension> C: <loginSec:loginSec C: xmlns:loginSec= C: "urn:ietf:params:xml:ns:loginSec-0.2"> C: <loginSec:newPW>new password that is still long C: </loginSec:newPW> C: </loginSec:loginSec> C: </extension> C: <clTRID>ABC-12345</clTRID> C: </command> C:</epp>
Upon a completed login command (success or failed), the extension MUST be included in the response based on the following conditions:
The extension to the EPP response uses the <loginSec:loginSecData> element that contains the following child elements:
Example EPP response to a successful login command where the password will expire in a week:
S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> S: <response> S: <result code="1000"> S: <msg>Command completed successfully</msg> S: </result> S: <extension> S: <loginSec:loginSecData S: xmlns:loginSec= S: "urn:ietf:params:xml:ns:loginSec-0.2"> S: <loginSec:event S: type="password" S: level="warning" S: exDate="2018-04-01T22:00:00.0Z" S: lang="en"> S: Password expiring in a week S: </loginSec:event> S: </loginSec:loginSecData> S: </extension> S: <trID> S: <clTRID>ABC-12345</clTRID> S: <svTRID>54321-XYZ</svTRID> S: </trID> S: </response> S:</epp>
Example EPP response to a failed login command where the password has expired and the new password does not meet the server complexity requirements:
S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> S: <response> S: <result code="2200"> S: <msg>Authentication error</msg> S: </result> S: <extension> S: <loginSec:loginSecData S: xmlns:loginSec= S: "urn:ietf:params:xml:ns:loginSec-0.2"> S: <loginSec:event S: type="password" S: level="error" S: exDate="2018-03-26T22:00:00.0Z"> S: Password has expired S: </loginSec:event> S: <loginSec:event S: type="newPw" S: level="error"> S: New password does not meet complexity requirements S: </loginSec:event> S: </loginSec:loginSecData> S: </extension> S: <trID> S: <clTRID>ABC-12345</clTRID> S: <svTRID>54321-XYZ</svTRID> S: </trID> S: </response> S:</epp>
Example EPP response to a successful login command where there is a set of login security events:
S:<?xml version="1.0" encoding="UTF-8" standalone="no"?> S:<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"> S: <response> S: <result code="1000"> S: <msg>Command completed successfully</msg> S: </result> S: <extension> S: <loginSec:loginSecData S: xmlns:loginSec= S: "urn:ietf:params:xml:ns:loginSec-0.2"> S: <loginSec:event S: type="password" S: level="warning" S: exDate="2018-04-01T22:00:00.0Z" S: lang="en"> S: Password expiration soon S: </loginSec:event> S: <loginSec:event S: type="certificate" S: level="warning" S: exDate="2018-04-02T22:00:00.0Z"/> S: <loginSec:event S: type="cipher" S: level="warning" S: value="TLS_RSA_WITH_AES_128_CBC_SHA"> S: Non-PFS Cipher negotiated S: </loginSec:event> S: <loginSec:event S: type="tlsProtocol" S: level="warning" S: value="TLSv1.0"> S: Insecure TLS protocol negotiated S: </loginSec:event> S: <loginSec:event S: type="stat" S: name="failedLogins" S: level="warning" S: value="100" S: duration="P1D"> S: Excessive invalid daily logins S: </loginSec:event> S: <loginSec:event S: type="custom" S: name="myCustomEvent" S: level="warning"> S: A custom login security event occured S: </loginSec:event> S: </loginSec:loginSecData> S: </extension> S: <trID> S: <clTRID>ABC-12345</clTRID> S: <svTRID>54321-XYZ</svTRID> S: </trID> S: </response> S:</epp>
One schema is presented here that is the EPP Login Security Extension schema.
The formal syntax presented here is a complete schema representation of the object mapping suitable for automated validation of EPP XML instances. The BEGIN and END tags are not part of the schema; they are used to note the beginning and ending of the schema for URI registration purposes.
BEGIN <?xml version="1.0" encoding="UTF-8"?> <schema targetNamespace="urn:ietf:params:xml:ns:loginSec-0.2" xmlns:eppcom="urn:ietf:params:xml:ns:eppcom-1.0" xmlns:epp="urn:ietf:params:xml:ns:epp-1.0" xmlns:loginSec="urn:ietf:params:xml:ns:loginSec-0.2" xmlns="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <!-- Import common element types. --> <import namespace="urn:ietf:params:xml:ns:eppcom-1.0"/> <import namespace="urn:ietf:params:xml:ns:epp-1.0"/> <annotation> <documentation> Extensible Provisioning Protocol v1.0 Login Security Extension Schema. </documentation> </annotation> <!-- login command extension elements --> <element name="loginSec" type="loginSec:loginSecType"/> <!-- Attributes associated with the login command extension. --> <complexType name="loginSecType"> <sequence> <element name="userAgent" type="token" minOccurs="0"/> <element name="pw" type="loginSec:pwType" minOccurs="0"/> <element name="newPW" type="loginSec:pwType" minOccurs="0"/> </sequence> </complexType> <simpleType name="pwType"> <restriction base="token"> <minLength value="6"/> </restriction> </simpleType> <!-- login response extension elements --> <element name="loginSecData" type="loginSec:loginSecDataType"/> <!-- Attributes associated with the change. --> <complexType name="loginSecDataType"> <sequence> <element name="event" type="loginSec:eventType" minOccurs="1" maxOccurs="unbounded"/> </sequence> </complexType> <complexType name="eventType"> <simpleContent> <extension base="normalizedString"> <attribute name="type" type="loginSec:typeEnum" use="required"/> <attribute name="name" type="token"/> <attribute name="level" type="loginSec:levelEnum" use="required"/> <attribute name="exDate" type="dateTime"/> <attribute name="value" type="token"/> <attribute name="duration" type="duration"/> <attribute name="lang" type="language" default="en"/> </extension> </simpleContent> </complexType> <!-- Enumerated list of event types, with extensibility via "custom". --> <simpleType name="typeEnum"> <restriction base="token"> <enumeration value="password"/> <enumeration value="certificate"/> <enumeration value="cipher"/> <enumeration value="tlsProtocol"/> <enumeration value="newPw"/> <enumeration value="stat"/> <enumeration value="custom"/> </restriction> </simpleType> <!-- Enumerated list of levels. --> <simpleType name="levelEnum"> <restriction base="token"> <enumeration value="warning"/> <enumeration value="error"/> </restriction> </simpleType> <!-- End of schema. --> </schema> END
This document uses URNs to describe XML namespaces and XML schemas conforming to a registry mechanism described in [RFC3688]. The following URI assignment is requested of IANA:
Registration request for the loginSec namespace:
Registration request for the loginSec XML schema:
The EPP extension described in this document should be registered by the IANA in the EPP Extension Registry described in [RFC7451]. The details of the registration are as follows:
Name of Extension: "Login Security Extension for the Extensible Provisioning Protocol (EPP)"
Document status: Standards Track
Reference: (insert reference to RFC version of this document)
Registrant Name and Email Address: IESG, <iesg@ietf.org>
TLDs: Any
IPR Disclosure: None
Status: Active
Notes: None
Note to RFC Editor: Please remove this section and the reference to RFC 7942 before publication.
TBD
The extension leaves the password (<pw> element) and new password (<newPw> element) minimum length beyond 6 characters and the maximum length up to sever policy. The server SHOULD enforce minimum and maximum length requirements that are appropriate for their operating environment. One example of a guideline for password length policies can be found in section 5 of NIST Special Publication 800-63B.
The extension provides an extensible list of login security events to inform clients of connection and login warnings and errors.
The authors wish to thank the following persons for their feedback and suggestions:
[RFC2119] | Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997. |
[RFC3688] | Mealling, M., "The IETF XML Registry", BCP 81, RFC 3688, DOI 10.17487/RFC3688, January 2004. |
[RFC5730] | Hollenbeck, S., "Extensible Provisioning Protocol (EPP)", STD 69, RFC 5730, DOI 10.17487/RFC5730, August 2009. |
[RFC7942] | Sheffer, Y. and A. Farrel, "Improving Awareness of Running Code: The Implementation Status Section", BCP 205, RFC 7942, DOI 10.17487/RFC7942, July 2016. |
[W3C.REC-xmlschema-2-20041028] | Biron, P. and A. Malhotra, "XML Schema Part 2: Datatypes Second Edition", World Wide Web Consortium Recommendation REC-xmlschema-2-20041028, October 2004. |
[RFC7451] | Hollenbeck, S., "Extension Registry for the Extensible Provisioning Protocol", RFC 7451, DOI 10.17487/RFC7451, February 2015. |