idnits 2.17.1 draft-farinacci-lisp-name-encoding-14.txt: Checking boilerplate required by RFC 5378 and the IETF Trust (see https://trustee.ietf.org/license-info): ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/1id-guidelines.txt: ---------------------------------------------------------------------------- No issues found here. Checking nits according to https://www.ietf.org/id-info/checklist : ---------------------------------------------------------------------------- No issues found here. Miscellaneous warnings: ---------------------------------------------------------------------------- == The copyright year in the IETF Trust and authors Copyright Line does not match the current year -- The document date (May 1, 2022) is 726 days in the past. Is this intentional? Checking references for intended status: Experimental ---------------------------------------------------------------------------- == Outdated reference: A later version (-31) exists of draft-ietf-lisp-rfc6833bis-30 ** Obsolete normative reference: RFC 1700 (Obsoleted by RFC 3232) ** Obsolete normative reference: RFC 6830 (Obsoleted by RFC 9300, RFC 9301) == Outdated reference: A later version (-15) exists of draft-farinacci-lisp-geo-13 == Outdated reference: A later version (-06) exists of draft-farinacci-lisp-simple-nat-03 == Outdated reference: A later version (-12) exists of draft-ietf-lisp-ecdsa-auth-07 Summary: 2 errors (**), 0 flaws (~~), 5 warnings (==), 1 comment (--). Run idnits with the --verbose option for more detailed information about the items above. -------------------------------------------------------------------------------- 2 Network Working Group D. Farinacci 3 Internet-Draft lispers.net 4 Intended status: Experimental May 1, 2022 5 Expires: November 2, 2022 7 LISP Distinguished Name Encoding 8 draft-farinacci-lisp-name-encoding-14 10 Abstract 12 This draft defines how to use the AFI=17 Distinguished Names in LISP. 14 Status of This Memo 16 This Internet-Draft is submitted in full conformance with the 17 provisions of BCP 78 and BCP 79. 19 Internet-Drafts are working documents of the Internet Engineering 20 Task Force (IETF). Note that other groups may also distribute 21 working documents as Internet-Drafts. The list of current Internet- 22 Drafts is at https://datatracker.ietf.org/drafts/current/. 24 Internet-Drafts are draft documents valid for a maximum of six months 25 and may be updated, replaced, or obsoleted by other documents at any 26 time. It is inappropriate to use Internet-Drafts as reference 27 material or to cite them other than as "work in progress." 29 This Internet-Draft will expire on November 2, 2022. 31 Copyright Notice 33 Copyright (c) 2022 IETF Trust and the persons identified as the 34 document authors. All rights reserved. 36 This document is subject to BCP 78 and the IETF Trust's Legal 37 Provisions Relating to IETF Documents 38 (https://trustee.ietf.org/license-info) in effect on the date of 39 publication of this document. Please review these documents 40 carefully, as they describe your rights and restrictions with respect 41 to this document. Code Components extracted from this document must 42 include Simplified BSD License text as described in Section 4.e of 43 the Trust Legal Provisions and are provided without warranty as 44 described in the Simplified BSD License. 46 Table of Contents 48 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2 49 2. Definition of Terms . . . . . . . . . . . . . . . . . . . . . 3 50 3. Distinguished Name Format . . . . . . . . . . . . . . . . . . 4 51 4. Example Use-Cases . . . . . . . . . . . . . . . . . . . . . . 5 52 5. Name Collision Considerations . . . . . . . . . . . . . . . . 5 53 6. Security Considerations . . . . . . . . . . . . . . . . . . . 5 54 7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 5 55 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 5 56 8.1. Normative References . . . . . . . . . . . . . . . . . . 5 57 8.2. Informative References . . . . . . . . . . . . . . . . . 6 58 Appendix A. Acknowledgments . . . . . . . . . . . . . . . . . . 6 59 Appendix B. Document Change Log . . . . . . . . . . . . . . . . 6 60 B.1. Changes to draft-farinacci-lisp-name-encoding-14 . . . . 6 61 B.2. Changes to draft-farinacci-lisp-name-encoding-13 . . . . 6 62 B.3. Changes to draft-farinacci-lisp-name-encoding-12 . . . . 7 63 B.4. Changes to draft-farinacci-lisp-name-encoding-11 . . . . 7 64 B.5. Changes to draft-farinacci-lisp-name-encoding-10 . . . . 7 65 B.6. Changes to draft-farinacci-lisp-name-encoding-09 . . . . 7 66 B.7. Changes to draft-farinacci-lisp-name-encoding-08 . . . . 7 67 B.8. Changes to draft-farinacci-lisp-name-encoding-07 . . . . 7 68 B.9. Changes to draft-farinacci-lisp-name-encoding-06 . . . . 7 69 B.10. Changes to draft-farinacci-lisp-name-encoding-05 . . . . 8 70 B.11. Changes to draft-farinacci-lisp-name-encoding-04 . . . . 8 71 B.12. Changes to draft-farinacci-lisp-name-encoding-03 . . . . 8 72 B.13. Changes to draft-farinacci-lisp-name-encoding-02 . . . . 8 73 B.14. Changes to draft-farinacci-lisp-name-encoding-01 . . . . 8 74 B.15. Changes to draft-farinacci-lisp-name-encoding-00 . . . . 8 75 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 8 77 1. Introduction 79 The LISP architecture and protocols [RFC6830] introduces two new 80 numbering spaces, Endpoint Identifiers (EIDs) and Routing Locators 81 (RLOCs) which are intended to replace most use of IP addresses on the 82 Internet. To provide flexibility for current and future 83 applications, these values can be encoded in LISP control messages 84 using a general syntax that includes Address Family Identifier (AFI) 85 [RFC1700]. 87 The length of the value field is implicit in the type of address that 88 follows. For AFI 17, a Distinguished Name can be encoded. A name 89 can be a variable length field so the length cannot be determined 90 solely from the AFI value 17. This draft defines a termination 91 character, an 8-bit value of 0 to be used as a string terminator so 92 the length can be determined. 94 LISP Distinguished Names are useful when encoded either in EID- 95 records or RLOC-records in LISP control messages. As EIDs, they can 96 be registered in the mapping system to find resources, services, or 97 simply used as a self-documenting feature that accompany other 98 address specific EIDs. As RLOCs, Distinguished Names, along with 99 RLOC specific addresses and parameters, can be used as labels to 100 identify equipment type, location, or any self-documenting string a 101 registering device desires to convey. 103 2. Definition of Terms 105 Address Family Identifier (AFI): a term used to describe an address 106 encoding in a packet. An address family currently defined for 107 IPv4 or IPv6 addresses. See [AFI] and [RFC1700] for details on 108 other types of information that can be AFI encoded. 110 3. Distinguished Name Format 112 An AFI=17 Distinguished Name is encoded as: 114 0 1 2 3 115 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 116 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ 117 | AFI = 17 | ASCII String ... | 118 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ 119 | ... ASCII String | 0 | 120 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ 122 The string of characters are encoded in the ASCII character-set 123 definition [RFC0020]. 125 When Distinguished Names are encoded for EIDs, the EID-prefix length 126 of the EIDs as they appear in EID-records for all LISP control 127 messages is the length of the string in bits (include the null 0 128 byte). Where Distinguished Names are encoded anywhere else (i.e. 129 nested in LCAF encodings), then any length field is the length of the 130 ASCII string including the null 0 byte in units of bytes. 132 When Map-Requests are sent for an EID encoded in Distinguished Name 133 format, an exact match request is performed. So the Map-Server (when 134 configured for proxy-Map-Replying) or the ETR will return a Map-Reply 135 with the same EID-prefix length. 137 4. Example Use-Cases 139 This section identifies three specific use-cases for the 140 Distinguished Name format. Two are used for an EID encoding and one 141 for a RLOC-record encoding. When storing public keys in the mapping 142 system, as in [I-D.ietf-lisp-ecdsa-auth], a well known format for a 143 public-key hash can be encoded as a Distinguished Name. When street 144 location to GPS coordinate mappings exist in the mapping system, as 145 in [I-D.farinacci-lisp-geo], the street location can be a free form 146 ascii representation (with whitespace characters) encoded as a 147 Distinguished Name. An RLOC that describes an xTR behind a NAT 148 device can be identified by its router name, as in 149 [I-D.farinacci-lisp-simple-nat], uses a Distinguished Name encoding. 150 As well as identifying the router name (neither an EID or an RLOC) in 151 NAT Info-Request messages uses Distinguished Name encodings. 153 5. Name Collision Considerations 155 When a Distinguished Name encoding is used to format an EID, the 156 uniqueness and allocation concerns are no different than registering 157 IPv4 or IPv6 EIDs to the mapping system. See 158 [I-D.ietf-lisp-rfc6833bis] for more details. Also, the use-case 159 documents specified in Section 4 provide allocation recommendations 160 for their specific uses. 162 6. Security Considerations 164 There are no security considerations. 166 7. IANA Considerations 168 The code-point values in this specification are already allocated in 169 [AFI]. 171 8. References 173 8.1. Normative References 175 [AFI] "Address Family Identifier (AFIs)", ADDRESS FAMILY 176 NUMBERS http://www.iana.org/numbers.html, Febuary 2007. 178 [I-D.ietf-lisp-rfc6833bis] 179 Farinacci, D., Maino, F., Fuller, V., and A. Cabellos, 180 "Locator/ID Separation Protocol (LISP) Control-Plane", 181 draft-ietf-lisp-rfc6833bis-30 (work in progress), November 182 2020. 184 [RFC0020] Cerf, V., "ASCII format for network interchange", STD 80, 185 RFC 20, DOI 10.17487/RFC0020, October 1969, 186 . 188 [RFC1700] Reynolds, J. and J. Postel, "Assigned Numbers", RFC 1700, 189 DOI 10.17487/RFC1700, October 1994, 190 . 192 [RFC6830] Farinacci, D., Fuller, V., Meyer, D., and D. Lewis, "The 193 Locator/ID Separation Protocol (LISP)", RFC 6830, 194 DOI 10.17487/RFC6830, January 2013, 195 . 197 8.2. Informative References 199 [I-D.farinacci-lisp-geo] 200 Farinacci, D., "LISP Geo-Coordinate Use-Cases", draft- 201 farinacci-lisp-geo-13 (work in progress), March 2022. 203 [I-D.farinacci-lisp-simple-nat] 204 Farinacci, D., "A Simple LISP NAT-Traversal 205 Implementation", draft-farinacci-lisp-simple-nat-03 (work 206 in progress), November 2021. 208 [I-D.ietf-lisp-ecdsa-auth] 209 Farinacci, D. and E. Nordmark, "LISP Control-Plane ECDSA 210 Authentication and Authorization", draft-ietf-lisp-ecdsa- 211 auth-07 (work in progress), February 2022. 213 Appendix A. Acknowledgments 215 The author would like to thank the LISP WG for their review and 216 acceptance of this draft. 218 Appendix B. Document Change Log 220 B.1. Changes to draft-farinacci-lisp-name-encoding-14 222 o Submitted May 2022. 224 o Update references and document expiry timer. 226 B.2. Changes to draft-farinacci-lisp-name-encoding-13 228 o Submitted November 2021. 230 o Update references and document expiry timer. 232 B.3. Changes to draft-farinacci-lisp-name-encoding-12 234 o Submitted May 2021. 236 o Update references and document expiry timer. 238 B.4. Changes to draft-farinacci-lisp-name-encoding-11 240 o Submitted November 2020. 242 o Made changes to reflect working group comments. 244 o Update references and document expiry timer. 246 B.5. Changes to draft-farinacci-lisp-name-encoding-10 248 o Submitted August 2020. 250 o Update references and document expiry timer. 252 B.6. Changes to draft-farinacci-lisp-name-encoding-09 254 o Submitted March 2020. 256 o Update references and document expiry timer. 258 B.7. Changes to draft-farinacci-lisp-name-encoding-08 260 o Submitted September 2019. 262 o Update references and document expiry timer. 264 B.8. Changes to draft-farinacci-lisp-name-encoding-07 266 o Submitted March 2019. 268 o Update referenes and document expiry timer. 270 B.9. Changes to draft-farinacci-lisp-name-encoding-06 272 o Submitted September 2018. 274 o Update document expiry timer. 276 B.10. Changes to draft-farinacci-lisp-name-encoding-05 278 o Submitted March 2018. 280 o Update document expiry timer. 282 B.11. Changes to draft-farinacci-lisp-name-encoding-04 284 o Submitted September 2017. 286 o Update document expiry timer. 288 B.12. Changes to draft-farinacci-lisp-name-encoding-03 290 o Submitted March 2017. 292 o Update document expiry timer. 294 B.13. Changes to draft-farinacci-lisp-name-encoding-02 296 o Submitted October 2016. 298 o Add a comment that the distinguished-name encoding is restricted 299 to ASCII character encodings only. 301 B.14. Changes to draft-farinacci-lisp-name-encoding-01 303 o Submitted October 2016. 305 o Update document timer. 307 B.15. Changes to draft-farinacci-lisp-name-encoding-00 309 o Initial draft submitted April 2016. 311 Author's Address 313 Dino Farinacci 314 lispers.net 315 San Jose, CA 316 USA 318 Email: farinacci@gmail.com