Internet Engineering Task Force (IETF) S. Hollenbeck
Request for Comments: 8605 Verisign Labs
Category: Informational R. Carney
ISSN: 2070-1721 GoDaddy Inc.
May 2019
Internet Engineering Task Force (IETF) S. Hollenbeck
Request for Comments: 8605 Verisign Labs
Category: Informational R. Carney
ISSN: 2070-1721 GoDaddy Inc.
May 2019
vCard Format Extensions: ICANN Extensions for the Registration Data Access Protocol (RDAP)
vCard格式扩展：注册数据访问协议（RDAP）的ICANN扩展
Abstract
摘要
This document defines extensions to the vCard data format for representing and exchanging contact information used to implement the Internet Corporation for Assigned Names and Numbers (ICANN) operational profile for the Registration Data Access Protocol (RDAP). The property and parameter defined here are used to add values to RDAP responses that are consistent with ICANN policies.
本文档定义了vCard数据格式的扩展，用于表示和交换用于实施注册数据访问协议（RDAP）的Internet名称和号码分配公司（ICANN）操作配置文件的联系信息。此处定义的属性和参数用于向RDAP响应添加符合ICANN策略的值。
Status of This Memo
关于下段备忘
This document is not an Internet Standards Track specification; it is published for informational purposes.
本文件不是互联网标准跟踪规范；它是为了提供信息而发布的。
This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Not all documents approved by the IESG are candidates for any level of Internet Standard; see Section 2 of RFC 7841.
本文件是互联网工程任务组（IETF）的产品。它代表了IETF社区的共识。它已经接受了公众审查，并已被互联网工程指导小组（IESG）批准出版。并非IESG批准的所有文件都适用于任何级别的互联网标准；见RFC 7841第2节。
Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at https://www.rfc-editor.org/info/rfc8605.
有关本文件当前状态、任何勘误表以及如何提供反馈的信息，请访问https://www.rfc-editor.org/info/rfc8605.
Copyright Notice
版权公告
Copyright (c) 2019 IETF Trust and the persons identified as the document authors. All rights reserved.
版权（c）2019 IETF信托基金和被确定为文件作者的人员。版权所有。
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.
本文件受BCP 78和IETF信托有关IETF文件的法律规定的约束(https://trustee.ietf.org/license-info)自本文件出版之日起生效。请仔细阅读这些文件，因为它们描述了您对本文件的权利和限制。从本文件中提取的代码组件必须包括信托法律条款第4.e节中所述的简化BSD许可证文本，并提供简化BSD许可证中所述的无担保。
Table of Contents
目录
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1. Terminology Used in This Document . . . . . . . . . . . . 3
2. vCard Extensions: Properties . . . . . . . . . . . . . . . . 3
2.1. Property: CONTACT-URI . . . . . . . . . . . . . . . . . . 3
3. vCard Extensions: Parameters . . . . . . . . . . . . . . . . 4
3.1. Parameter: CC . . . . . . . . . . . . . . . . . . . . . . 4
4. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 5
5. Security Considerations . . . . . . . . . . . . . . . . . . . 5
6. References . . . . . . . . . . . . . . . . . . . . . . . . . 5
6.1. Normative References . . . . . . . . . . . . . . . . . . 5
6.2. Informative References . . . . . . . . . . . . . . . . . 6
Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 6
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 7
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1. Terminology Used in This Document . . . . . . . . . . . . 3
2. vCard Extensions: Properties . . . . . . . . . . . . . . . . 3
2.1. Property: CONTACT-URI . . . . . . . . . . . . . . . . . . 3
3. vCard Extensions: Parameters . . . . . . . . . . . . . . . . 4
3.1. Parameter: CC . . . . . . . . . . . . . . . . . . . . . . 4
4. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 5
5. Security Considerations . . . . . . . . . . . . . . . . . . . 5
6. References . . . . . . . . . . . . . . . . . . . . . . . . . 5
6.1. Normative References . . . . . . . . . . . . . . . . . . 5
6.2. Informative References . . . . . . . . . . . . . . . . . 6
Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . . 6
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 7
The "Temporary Specification for gTLD Registration Data" available at <https://www.icann.org/resources/pages/gtld-registration-data-specs-en> was published by the Internet Corporation for Assigned Named and Numbers (ICANN) in 2018. The Temporary Specification includes requirements that cannot currently be met by the Registration Data Access Protocol (RDAP, [RFC7483]) without extending the underlying vCard [RFC6350] specification used to represent RDAP entity objects. This document includes specifications for an additional vCard property and an additional vCard parameter to meet the requirements of the Temporary Specification.
“gTLD注册数据临时规范”可在<https://www.icann.org/resources/pages/gtld-registration-data-specs-en>由互联网命名和编号分配公司（ICANN）于2018年发布。临时规范包括注册数据访问协议（RDAP，[RFC7483]）目前无法满足的要求，如果不扩展用于表示RDAP实体对象的基础vCard[RFC6350]规范。本文件包括额外vCard属性和额外vCard参数的规范，以满足临时规范的要求。
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.
本文件中的关键词“必须”、“不得”、“必需”、“应”、“不应”、“建议”、“不建议”、“可”和“可选”在所有大写字母出现时（如图所示）应按照BCP 14[RFC2119][RFC8174]所述进行解释。
Syntax specifications shown here use the augmented Backus-Naur Form (ABNF) as described in [RFC5234] and are specified as in the base vCard specification [RFC6350].
此处显示的语法规范使用[RFC5234]中所述的增广巴科斯诺尔形式（ABNF），并在基本vCard规范[RFC6350]中指定。
This document describes one new vCard extension property.
本文档介绍了一个新的vCard扩展属性。
Namespace:
名称空间：
Property name: CONTACT-URI
属性名称：CONTACT-URI
Purpose: RDAP entity information can be redacted under certain circumstances (e.g., privacy). The Temporary Specification requires that RDAP entity objects representing "Registrant", "Admin", and "Tech" contacts contain an email address or a location for a web form to facilitate email communication with the relevant contact in a way that does not identify the associated individual. The CONTACT-URI property can be used to include URIs representing an email address or a location for a web form.
目的：RDAP实体信息可以在某些情况下进行编辑（例如，隐私）。临时规范要求代表“注册人”、“管理员”和“技术”联系人的RDAP实体对象包含一个电子邮件地址或web表单的位置，以便于以不识别相关个人的方式与相关联系人进行电子邮件通信。CONTACT-URI属性可用于包含表示电子邮件地址或web表单位置的URI。
Value type: A single URI value.
值类型：单个URI值。
Cardinality: *
基数：*
Property parameters: PREF
属性参数：PREF
Description: At least one "mailto", "http", or "https" URI value MUST be provided. Additional CONTACT-URI properties MAY be provided to describe other contact methods. If multiple CONTACT-URI properties are used, the vCard PREF parameter MUST be used to describe the most preferred property as described in Section 5.3 of RFC 6350 [RFC6350].
说明：必须至少提供一个“mailto”、“http”或“https”URI值。可以提供额外的CONTACT-URI属性来描述其他联系人方法。如果使用多个CONTACT-URI属性，则必须使用vCard PREF参数来描述RFC 6350[RFC6350]第5.3节中所述的最首选属性。
Format definition:
格式定义：
CONTACT-URI-param = "VALUE=uri" / pref-param ; pref-param from
[RFC6350]
CONTACT-URI-param = "VALUE=uri" / pref-param ; pref-param from
[RFC6350]
CONTACT-URI-value = uri ; uri from [RFC3986]
联系人URI值=URI；来自[RFC3986]的uri
Examples:
示例：
CONTACT-URI:https://contact.example.com
CONTACT-URI:https://contact.example.com
CONTACT-URI;PREF=1:mailto:contact@example.com
CONTACT-URI;PREF=1:mailto:contact@example.com
This document describes one new vCard extension parameter.
本文档介绍了一个新的vCard扩展参数。
Namespace:
名称空间：
Parameter name: CC
参数名称：CC
Purpose: ICANN requires the use of ISO 3166 [ISO.3166.1988] two-letter codes, not "country names", in RDAP entity responses. This parameter is used to extend the ADR property described in Section 6.3.1 of RFC 6350 [RFC6350].
目的：ICANN要求在RDAP实体回复中使用ISO 3166[ISO.3166.1988]双字母代码，而不是“国家名称”。此参数用于扩展RFC 6350[RFC6350]第6.3.1节中所述的ADR属性。
Description: This parameter contains the ISO 3166 [ISO.3166.1988] two-character country code associated with the "country name" ADR component described in Section 6.3.1 of RFC 6350 [RFC6350].
描述：此参数包含与RFC 6350[RFC6350]第6.3.1节中描述的“国家名称”ADR组件相关的ISO 3166[ISO.3166.1988]双字符国家代码。
Format definition:
格式定义：
CC-param = "CC=" 2ALPHA
CC param=“CC=”2ALPHA
Examples:
示例：
ADR;TYPE=work;CC=US:;;54321 Oak St;Reston;VA;20190;USA
ADR;TYPE=work;CC=US:;;54321 Oak St;Reston;VA;20190;USA
ADR;TYPE=home;CC=US:;;12345 Elm St;Reston;VA;20190;USA
ADR;TYPE=home;CC=US:;;12345 Elm St;Reston;VA;20190;USA
IANA has added the following entry to the "vCard Properties" registry defined in Section 10.3.1 of RFC 6350 [RFC6350].
IANA已将以下条目添加到RFC 6350[RFC6350]第10.3.1节中定义的“vCard属性”注册表中。
Namespace:
名称空间：
Property: CONTACT-URI
属性：CONTACT-URI
Reference: Section 2.1 of RFC 8605 (this RFC)
参考：RFC 8605第2.1节（本RFC）
IANA is requested to add the following entry to the vCard Parameters registry defined in Section 10.3.2 of RFC 6350 [RFC6350].
请IANA将以下条目添加到RFC 6350[RFC6350]第10.3.2节中定义的vCard参数注册表中。
Namespace:
名称空间：
Property: CC
物业名称:CC
Reference: Section 3.1 of RFC 8605 (this RFC)
参考：RFC 8605第3.1节（本RFC）
The CONTACT-URI value is purposefully intended to be a publicly visible contact reference; as such, it cannot require confidentiality protection. There are, however, privacy implications in the choice of a URI scheme for the web form contact method. An "https" URI value can be used to indicate support for confidentiality protection for connections to the server that publishes the web form. This document presents no other security considerations beyond those described in Section 9 of the base vCard specification [RFC6350].
CONTACT-URI值有意成为公开可见的联系人引用；因此，它不需要保密保护。然而，在为web表单联系人方法选择URI方案时会涉及隐私问题。“https”URI值可用于指示对发布web表单的服务器连接的机密性保护的支持。除了基本vCard规范[RFC6350]第9节中所述的安全注意事项外，本文件不提供其他安全注意事项。
[ISO.3166.1988] International Organization for Standardization, "Codes for the representation of names of countries, 3rd edition", ISO Standard 3166, August 1988.
[ISO.3166.1988]国际标准化组织，“国家名称表示代码，第3版”，ISO标准3166，1988年8月。
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/RFC2119, March 1997, <https://www.rfc-editor.org/info/rfc2119>.
[RFC2119]Bradner，S.，“RFC中用于表示需求水平的关键词”，BCP 14，RFC 2119，DOI 10.17487/RFC2119，1997年3月<https://www.rfc-editor.org/info/rfc2119>.
[RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform Resource Identifier (URI): Generic Syntax", STD 66, RFC 3986, DOI 10.17487/RFC3986, January 2005, <https://www.rfc-editor.org/info/rfc3986>.
[RFC3986]Berners Lee，T.，Fielding，R.，和L.Masinter，“统一资源标识符（URI）：通用语法”，STD 66，RFC 3986，DOI 10.17487/RFC3986，2005年1月<https://www.rfc-editor.org/info/rfc3986>.
[RFC5234] Crocker, D., Ed. and P. Overell, "Augmented BNF for Syntax Specifications: ABNF", STD 68, RFC 5234, DOI 10.17487/RFC5234, January 2008, <https://www.rfc-editor.org/info/rfc5234>.
[RFC5234]Crocker，D.，Ed.和P.Overell，“语法规范的扩充BNF:ABNF”，STD 68，RFC 5234，DOI 10.17487/RFC5234，2008年1月<https://www.rfc-editor.org/info/rfc5234>.
[RFC6350] Perreault, S., "vCard Format Specification", RFC 6350, DOI 10.17487/RFC6350, August 2011, <https://www.rfc-editor.org/info/rfc6350>.
[RFC6350]Perreault，S.，“vCard格式规范”，RFC 6350，DOI 10.17487/RFC6350，2011年8月<https://www.rfc-editor.org/info/rfc6350>.
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, May 2017, <https://www.rfc-editor.org/info/rfc8174>.
[RFC8174]Leiba，B.，“RFC 2119关键词中大写与小写的歧义”，BCP 14，RFC 8174，DOI 10.17487/RFC8174，2017年5月<https://www.rfc-editor.org/info/rfc8174>.
[RFC7483] Newton, A. and S. Hollenbeck, "JSON Responses for the Registration Data Access Protocol (RDAP)", RFC 7483, DOI 10.17487/RFC7483, March 2015, <https://www.rfc-editor.org/info/rfc7483>.
[RFC7483]Newton，A.和S.Hollenbeck，“注册数据访问协议（RDAP）的JSON响应”，RFC 7483，DOI 10.17487/RFC7483，2015年3月<https://www.rfc-editor.org/info/rfc7483>.
Acknowledgements
致谢
The author would like to acknowledge the following individuals for their contributions to the development of this document: Rick Wilhelm.
作者要感谢以下个人对本文件的编写所作的贡献：里克·威廉。
Authors' Addresses
作者地址
Scott Hollenbeck Verisign Labs 12061 Bluemont Way Reston, VA 20190 United States of America
Scott Hollenbeck Verisign实验室12061美国弗吉尼亚州布鲁蒙特路莱斯顿20190
Email: shollenbeck@verisign.com
URI: https://www.verisignlabs.com/
Email: shollenbeck@verisign.com
URI: https://www.verisignlabs.com/
Roger Carney GoDaddy Inc. 14455 N. Hayden Rd. #219 Scottsdale, AZ 85260 United States of America
罗杰·卡尼·戈达迪公司，美国亚利桑那州斯科茨代尔市海登北路14455号，邮编：85260
Email: rcarney@godaddy.com
URI: http://www.godaddy.com
Email: rcarney@godaddy.com
URI: http://www.godaddy.com