Internet Engineering Task Force (IETF) C. Bormann
Request for Comments: 9423 Universität Bremen TZI
Category: Informational April 2024
ISSN: 2070-1721
The Constrained RESTful Environments (CoRE) specifications apply web technologies to constrained environments. One such important technology is Web Linking (RFC 8288), which CoRE specifications use as the basis for a number of discovery protocols, such as the Link Format (RFC 6690) in the Constrained Application Protocol's (CoAP's) resource discovery process (Section 7.2 of RFC 7252) and the Resource Directory (RD) (RFC 9176).
制約されたRESTFUL環境（コア）仕様は、制約された環境にWebテクノロジーを適用します。このような重要なテクノロジーの1つは、Webリンク（RFC 8288）です。これは、制約付きアプリケーションプロトコル（COAPの）リソース発見プロセスのリンク形式（RFC 6690）など、多くの発見プロトコルの基礎としてコア仕様を使用することです。RFC 7252）およびリソースディレクトリ（RD）（RFC 9176）。
Web Links can have target attributes, the names of which are not generally coordinated by the Web Linking specification (Section 2.2 of RFC 8288). This document introduces an IANA registry for coordinating names of target attributes when used in CoRE. It updates the "RD Parameters" IANA registry created by RFC 9176 to coordinate with this registry.
Webリンクにはターゲット属性がありますが、その名前は一般にWebリンク仕様によって調整されていません（RFC 8288のセクション2.2）。このドキュメントでは、Coreで使用された場合、ターゲット属性の名前を調整するためのIANAレジストリを紹介します。このレジストリと調整するために、RFC 9176によって作成された「RDパラメーター」IANAレジストリを更新します。
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/rfc9423.
このドキュメントの現在のステータス、任意のERRATA、およびそのフィードバックを提供する方法に関する情報は、https://www.rfc-editor.org/info/rfc9423で取得できます。
Copyright (c) 2024 IETF Trust and the persons identified as the document authors. All rights reserved.
著作権（c）2024 IETF Trustおよび文書著者として特定された人。無断転載を禁じます。
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 Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.
このドキュメントは、BCP 78およびIETFドキュメント（https://trustee.ietf.org/license-info）に関連するIETF Trustの法的規定の対象となります。この文書に関するあなたの権利と制限を説明するので、これらの文書を注意深く確認してください。このドキュメントから抽出されたコードコンポーネントには、セクション4.Eで説明されている法的規定のセクション4.Eで説明されており、改訂されたBSDライセンスで説明されている保証なしで提供されるように、改訂されたBSDライセンステキストを含める必要があります。
1. Introduction
1.1. Terminology
2. IANA Considerations
2.1. Instructions for the Designated Expert
2.2. Structure of Entries
2.3. Initial Entries
3. Security Considerations
4. References
4.1. Normative References
4.2. Informative References
Acknowledgements
Contributors
Author's Address
The Constrained RESTful Environments (CoRE) specifications apply web technologies to constrained environments. One such important technology is Web Linking [RFC8288], which CoRE specifications use as the basis for a number of discovery protocols, such as the Link Format [RFC6690] in the Constrained Application Protocol's (CoAP's) resource discovery process (Section 7.2 of [RFC7252]) and the Resource Directory (RD) [RFC9176].
制約されたRESTFUL環境（コア）仕様は、制約された環境にWebテクノロジーを適用します。このような重要なテクノロジーの1つは、Webリンク[RFC8288]です。これは、制約付きアプリケーションプロトコル（COAPの）リソース発見プロセスのリンク形式[RFC6690]など、多くの発見プロトコルの基礎としてコア仕様を使用することです。]）およびリソースディレクトリ（RD）[RFC9176]。
Web Links can have target attributes. The original Web Linking specification (Section 3 of [RFC5988]) did not attempt to coordinate names of target attributes except for providing common target attributes for use in the Link HTTP header. The current revision of that specification (Section 2.2 of [RFC8288]) clarifies as follows:
Webリンクには、ターゲット属性を持つことができます。元のWebリンク仕様（[RFC5988]のセクション3）は、リンクHTTPヘッダーで使用する一般的なターゲット属性を提供することを除き、ターゲット属性の名前を調整しようとしませんでした。その仕様の現在の改訂（[RFC8288]のセクション2.2）は、次のように明確になります。
This specification does not attempt to coordinate the name of target attributes, their cardinality, or use. Those creating and maintaining serialisations SHOULD coordinate their target attributes to avoid conflicts in semantics or syntax and MAY define their own registries of target attributes.
この仕様では、ターゲット属性の名前、その枢機inal、または使用の名前を調整しようとはしません。シリアル化を作成および維持する人は、セマンティクスまたは構文の競合を回避するためにターゲット属性を調整し、ターゲット属性の独自のレジストリを定義する必要があります。
This document introduces an IANA registry for coordinating names of target attributes when used in CoRE, with specific instructions for the designated expert for this registry (Section 2.1). It updates the "RD Parameters" IANA registry created by [RFC9176] to coordinate with this registry.
このドキュメントでは、このレジストリの指定された専門家の特定の指示を使用して、Coreで使用された場合にターゲット属性の名前を調整するためのIANAレジストリを紹介します（セクション2.1）。[RFC9176]によって作成された「RDパラメーター」IANAレジストリを更新して、このレジストリと調整します。
With this registry now available, registration of target attributes is strongly encouraged. The incentive is that an unregistered attribute name might be registered with a different meaning at any time.
このレジストリが利用可能になると、ターゲット属性の登録が強く奨励されています。インセンティブは、未登録の属性名がいつでも異なる意味で登録される可能性があることです。
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.
「必須」、「必要」、「必須」、「shall」、「shall」、「suff」、 "not"、 "becommended"、 "becommented"、 "may"、 "optional「このドキュメントでは、BCP 14 [RFC2119] [RFC8174]で説明されているように解釈されます。
Per this specification, IANA has created a new "Target Attributes" registry in the "Constrained RESTful Environments (CoRE) Parameters" registry group [IANA.core-parameters], with the policy "Expert Review" (Section 4.5 of RFC 8126 [BCP26]).
この仕様に従って、IANAは「制約付きのRESTFUL環境（CORE）パラメーター」レジストリグループ[IANA.CORE-PARAMETERS]に新しい「ターゲット属性」レジストリを作成しました。]）。
The expert is requested to guide the registrant towards reasonably short target attribute names where the shortness will help conserve resources in constrained systems, but to also be frugal in the allocation of very short names, keeping them in reserve for applications that are likely to enjoy wide use and can make good use of their shortness.
専門家は、登録者を制約されたシステムのリソースを節約するのに役立つ合理的に短いターゲット属性名に登録者を導くように要求されますが、非常に短い名前の割り当てにおいても質素になり、広く楽しむ可能性のあるアプリケーションのためにそれらを保存することもできます。使用し、彼らの短さをうまく利用することができます。
The expert is also instructed to direct the registrant to provide a specification (Section 4.6 of RFC 8126 [BCP26]) but can make exceptions -- for instance, when a specification is not available at the time of registration but is likely forthcoming.
また、専門家は、登録者に仕様を提供するよう指示するように指示されます（RFC 8126 [BCP26]のセクション4.6）が、たとえば登録時に仕様が利用できないが、おそらく近づいている場合は例外を作成できます。
Any questions or issues that might interest a wider audience might be raised by the expert on the core-parameters@ietf.org mailing list for a time-limited discussion. This might include security considerations, or opportunities for orchestration, e.g., when different names with similar intent are being or could be registered.
より多くの視聴者に興味を持っている可能性のある質問や問題は、Core-Parameters@ietf.orgメーリングリストの専門家によって提起される可能性があります。これには、セキュリティ上の考慮事項、または同様の意図を持つ異なる名前が登録されている場合、または登録される可能性のあるオーケストレーションの機会が含まれる場合があります。
If the expert becomes aware of target attributes that are deployed and in use, they may also initiate a registration on their own if they deem that such a registration can avert potential future collisions.
専門家が展開され、使用中のターゲット属性を認識した場合、そのような登録が潜在的な将来の衝突を回避できると考える場合、彼らは自分で登録を開始することもあります。
Each entry in the registry must include the following:
レジストリ内の各エントリには、以下を含める必要があります。
Attribute Name:
属性名：
A lowercase ASCII string [STD80] that starts with a letter and can contain digits and hyphen-minus characters afterward ([a-z][-a-z0-9]*). (Note that [RFC8288] requires target attribute names to be interpreted in a case-insensitive way; the restriction to lowercase here ensures that they are registered in a predictable form.)
手紙から始まり、その後数字とハイフン - マイナス文字を含めることができる小文字ASCII文字列[std80]（[a-z] [-a-z0-9]*）。（[RFC8288]は、ターゲット属性名をケースに依存しない方法で解釈する必要があることに注意してください。ここでの小文字の制限により、予測可能な形式で登録されることが保証されます。）
Brief Description:
簡単な説明：
A brief description.
簡単な説明。
Change Controller:
Change Controller：
See Section 2.3 of RFC 8126 [BCP26].
RFC 8126 [BCP26]のセクション2.3を参照してください。
Reference:
参照：
A reference document that provides a description of the target attribute, including the semantics for when the target attribute appears more than once in a link.
ターゲット属性がリンクに複数回表示されるときのセマンティクスを含む、ターゲット属性の説明を提供する参照ドキュメント。
Initial entries in this registry are listed in Table 1.
このレジストリの初期エントリを表1に示します。
+===========+=========================+============+===============+
| Attribute | Brief Description | Change | Reference |
| Name | | Controller | |
+===========+=========================+============+===============+
| href | reserved (not useful as | IETF | [RFC6690] |
| | target attribute name) | | |
+-----------+-------------------------+------------+---------------+
| anchor | reserved (not useful as | IETF | [RFC6690] |
| | target attribute name) | | |
+-----------+-------------------------+------------+---------------+
| rel | reserved (not useful as | IETF | [RFC6690] |
| | target attribute name) | | |
+-----------+-------------------------+------------+---------------+
| rev | reserved (not useful as | IETF | [RFC6690] |
| | target attribute name) | | |
+-----------+-------------------------+------------+---------------+
| hreflang | (Web Linking) | IETF | [RFC8288] |
+-----------+-------------------------+------------+---------------+
| media | (Web Linking) | IETF | [RFC8288] |
+-----------+-------------------------+------------+---------------+
| title | (Web Linking) | IETF | [RFC8288] |
+-----------+-------------------------+------------+---------------+
| type | (Web Linking) | IETF | [RFC8288] |
+-----------+-------------------------+------------+---------------+
| rt | resource type | IETF | Section 3.1 |
| | | | of [RFC6690] |
+-----------+-------------------------+------------+---------------+
| if | interface description | IETF | Section 3.2 |
| | | | of [RFC6690] |
+-----------+-------------------------+------------+---------------+
| sz | maximum size estimate | IETF | Section 3.3 |
| | | | of [RFC6690] |
+-----------+-------------------------+------------+---------------+
| ct | Content-Format hint | IETF | Section 7.2.1 |
| | | | of [RFC7252] |
+-----------+-------------------------+------------+---------------+
| obs | observable resource | IETF | Section 6 of |
| | | | [RFC7641] |
+-----------+-------------------------+------------+---------------+
| hct | HTTP-CoAP URI mapping | IETF | Section 5.5 |
| | template | | of [RFC8075] |
+-----------+-------------------------+------------+---------------+
| osc | hint: resource only | IETF | Section 9 of |
| | accessible using OSCORE | | [RFC8613] |
+-----------+-------------------------+------------+---------------+
| ep | Endpoint Name (with | IETF | Section 9.3 |
| | rt="core.rd-ep") | | of [RFC9176] |
+-----------+-------------------------+------------+---------------+
| d | Sector (with | IETF | Section 9.3 |
| | rt="core.rd-ep") | | of [RFC9176] |
+-----------+-------------------------+------------+---------------+
| base | Registration Base URI | IETF | Section 9.3 |
| | (with rt="core.rd-ep") | | of [RFC9176] |
+-----------+-------------------------+------------+---------------+
| et | Endpoint Type (with | IETF | Section 9.3 |
| | rt="core.rd-ep") | | of [RFC9176] |
+-----------+-------------------------+------------+---------------+
Table 1: Initial Entries in the Target Attributes Registry
表1：ターゲット属性レジストリの初期エントリ
A number of names are reserved, as they are used for parameters in links other than target attributes. A further set of target attributes is predefined in [RFC8288] and is imported into this registry.
ターゲット属性以外のリンクのパラメーターに使用されるため、多くの名前が予約されています。さらに一連のターゲット属性は[RFC8288]で事前に定義されており、このレジストリにインポートされます。
Section 9.3 of [RFC9176] created the "RD Parameters" IANA registry. Per this document, IANA has added the following note to that registry:
[RFC9176]のセクション9.3は、「RDパラメーター」IANAレジストリを作成しました。このドキュメントに従って、IANAは次のメモをそのレジストリに追加しました。
Note: In accordance with RFC 9423, all entries with the "A" flag set, including new ones, MUST also be registered in the "Target Attributes" registry [IANA.core-parameters].
注：RFC 9423に従って、新しいフラグセットを含む「A」フラグセットを含むすべてのエントリも、「ターゲット属性」レジストリ[iana.core-parameters]に登録する必要があります。
The security considerations of [RFC8288] apply, as do those of the discovery specifications [RFC6690], [RFC7252], and [RFC9176].
[RFC8288]のセキュリティ上の考慮事項は、発見仕様[RFC6690]、[RFC7252]、および[RFC9176]のセキュリティに関する考慮事項と同様に適用されます。
[BCP26] Best Current Practice 26,
<https://www.rfc-editor.org/info/bcp26>.
At the time of writing, this BCP comprises the following:
Cotton, M., Leiba, B., and T. Narten, "Guidelines for
Writing an IANA Considerations Section in RFCs", BCP 26,
RFC 8126, DOI 10.17487/RFC8126, June 2017,
<https://www.rfc-editor.org/info/rfc8126>.
[IANA.core-parameters]
IANA, "Constrained RESTful Environments (CoRE)
Parameters",
<https://www.iana.org/assignments/core-parameters>.
[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>.
[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>.
[RFC8288] Nottingham, M., "Web Linking", RFC 8288,
DOI 10.17487/RFC8288, October 2017,
<https://www.rfc-editor.org/info/rfc8288>.
[STD80] Internet Standard 80,
<https://www.rfc-editor.org/info/std80>.
At the time of writing, this STD comprises the following:
Cerf, V., "ASCII format for network interchange", STD 80,
RFC 20, DOI 10.17487/RFC0020, October 1969,
<https://www.rfc-editor.org/info/rfc20>.
[RFC5988] Nottingham, M., "Web Linking", RFC 5988,
DOI 10.17487/RFC5988, October 2010,
<https://www.rfc-editor.org/info/rfc5988>.
[RFC6690] Shelby, Z., "Constrained RESTful Environments (CoRE) Link
Format", RFC 6690, DOI 10.17487/RFC6690, August 2012,
<https://www.rfc-editor.org/info/rfc6690>.
[RFC7252] Shelby, Z., Hartke, K., and C. Bormann, "The Constrained
Application Protocol (CoAP)", RFC 7252,
DOI 10.17487/RFC7252, June 2014,
<https://www.rfc-editor.org/info/rfc7252>.
[RFC7641] Hartke, K., "Observing Resources in the Constrained
Application Protocol (CoAP)", RFC 7641,
DOI 10.17487/RFC7641, September 2015,
<https://www.rfc-editor.org/info/rfc7641>.
[RFC8075] Castellani, A., Loreto, S., Rahman, A., Fossati, T., and
E. Dijk, "Guidelines for Mapping Implementations: HTTP to
the Constrained Application Protocol (CoAP)", RFC 8075,
DOI 10.17487/RFC8075, February 2017,
<https://www.rfc-editor.org/info/rfc8075>.
[RFC8613] Selander, G., Mattsson, J., Palombini, F., and L. Seitz,
"Object Security for Constrained RESTful Environments
(OSCORE)", RFC 8613, DOI 10.17487/RFC8613, July 2019,
<https://www.rfc-editor.org/info/rfc8613>.
[RFC9176] Amsüss, C., Ed., Shelby, Z., Koster, M., Bormann, C., and
P. van der Stok, "Constrained RESTful Environments (CoRE)
Resource Directory", RFC 9176, DOI 10.17487/RFC9176, April
2022, <https://www.rfc-editor.org/info/rfc9176>.
The CoRE Working Group had been discussing setting up a registry for target attributes since the final touches were made on [RFC6690]. The update of the Web Linking specification to [RFC8288] provided the formal setting, but it took until Jaime Jiménez provided the set of initial registrations to generate a first draft version of this specification. The current document addresses additional input and Working Group Last Call comments by Esko Dijk, Marco Tiloca, Thomas Fossati, and Mohamed Boucadair, as well as Area Director review comments from Rob Wilton.
コアワーキンググループは、[RFC6690]で最終的なタッチが作成されて以来、ターゲット属性のレジストリのセットアップについて議論していました。仕様を[RFC8288]にリンクするWebの更新は正式な設定を提供しましたが、JaimeJiménezがこの仕様の最初のドラフトバージョンを生成するための初期登録のセットを提供するまでかかりました。現在の文書は、Esko Dijk、Marco Tiloca、Thomas Fossati、Mohamed Boucadairによる追加の入力およびワーキンググループの最後のコールコメント、およびRob Wiltonからのエリアディレクターのレビューコメントを扱っています。
Jaime Jiménez
Ericsson
Email: jaime@iki.fi
Jaime provided the list of initial registrations.
ハイメは初期登録のリストを提供しました。
Carsten Bormann
Universität Bremen TZI
Postfach 330440
D-28359 Bremen
Germany
Phone: +49-421-218-63921
Email: cabo@tzi.org