Internet-Draft LISP Distinguished Name Encoding August 2023
Farinacci Expires 21 February 2024 [Page]
Workgroup:
Internet Engineering Task Force
Internet-Draft:
draft-ietf-lisp-name-encoding-02
Published:
Intended Status:
Experimental
Expires:
Author:
D. Farinacci
lispers.net

LISP Distinguished Name Encoding

Abstract

This draft defines how to use the AFI=17 Distinguished Names in LISP.

Status of This Memo

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 21 February 2024.

Table of Contents

1. Introduction

The LISP architecture and protocols [RFC9300] introduces two new numbering spaces, Endpoint Identifiers (EIDs) and Routing Locators (RLOCs) which are intended to replace most use of IP addresses on the Internet. To provide flexibility for current and future applications, these values can be encoded in LISP control messages using a general syntax that includes Address Family Identifier (AFI) [RFC1700].

The length of the value field is implicit in the type of address that follows. For AFI 17, a Distinguished Name can be encoded. A name can be a variable length field so the length cannot be determined solely from the AFI value 17. This draft defines a termination character, an 8-bit value of 0 to be used as a string terminator so the length can be determined.

LISP Distinguished Names are useful when encoded either in EID-records or RLOC-records in LISP control messages. As EIDs, they can be registered in the mapping system to find resources, services, or simply used as a self-documenting feature that accompany other address specific EIDs. As RLOCs, Distinguished Names, along with RLOC specific addresses and parameters, can be used as labels to identify equipment type, location, or any self-documenting string a registering device desires to convey.

2. Definition of Terms

Address Family Identifier (AFI):
a term used to describe an address encoding in a packet. An address family currently defined for IPv4 or IPv6 addresses. See [AFI] and [RFC1700] for details on other types of information that can be AFI encoded.

3. Distinguished Name Format

An AFI=17 Distinguished Name is encoded as:

  0                   1                   2                   3
  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
 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 |            AFI = 17           |       ASCII String ...        |
 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 |               ...  ASCII String             |       0         |
 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

The string of characters are encoded in the ASCII character-set definition [RFC0020].

When Distinguished Names are encoded for EIDs, the EID-prefix length of the EIDs as they appear in EID-records for all LISP control messages is the length of the string in bits (include the null 0 byte). Where Distinguished Names are encoded anywhere else (i.e. nested in LCAF encodings), then any length field is the length of the ASCII string including the null 0 byte in units of bytes.

When Map-Requests are sent for an EID encoded in Distinguished Name format, an exact match request is performed. So the Map-Server (when configured for proxy-Map-Replying) or the ETR will return a Map-Reply with the same EID-prefix length.

4. Example Use-Cases

This section identifies three specific use-cases for the Distinguished Name format. Two are used for an EID encoding and one for a RLOC-record encoding. When storing public keys in the mapping system, as in [I-D.ietf-lisp-ecdsa-auth], a well known format for a public-key hash can be encoded as a Distinguished Name. When street location to GPS coordinate mappings exist in the mapping system, as in [I-D.farinacci-lisp-geo], the street location can be a free form ascii representation (with whitespace characters) encoded as a Distinguished Name. An RLOC that describes an xTR behind a NAT device can be identified by its router name, as in [I-D.farinacci-lisp-lispers-net-nat], uses a Distinguished Name encoding. As well as identifying the router name (neither an EID or an RLOC) in NAT Info-Request messages uses Distinguished Name encodings.

5. Name Collision Considerations

When a Distinguished Name encoding is used to format an EID, the uniqueness and allocation concerns are no different than registering IPv4 or IPv6 EIDs to the mapping system. See [RFC9301] for more details. Also, the use-case documents specified in Section 4 provide allocation recommendations for their specific uses.

It is recommended that each use-case register their distinguish-names in a unique VPN according to the encoding procedures in [I-D.ietf-lisp-vpn]. For any use-cases which require different uses for distinguish-names within a VPN MUST define their own structure syntax for the name registered to the mapping system.

6. Security Considerations

There are no security considerations.

7. IANA Considerations

The code-point values in this specification are already allocated in [AFI].

8. References

8.1. Normative References

[AFI]
IANA, "Address Family Identifier (AFIs)", ADDRESS FAMILY NUMBERS, http://www.iana.org/numbers.html, .
[I-D.ietf-lisp-vpn]
Moreno, V. and D. Farinacci, "LISP Virtual Private Networks (VPNs)", Work in Progress, Internet-Draft, draft-ietf-lisp-vpn-11, , <https://datatracker.ietf.org/doc/html/draft-ietf-lisp-vpn-11>.
[RFC0020]
Cerf, V., "ASCII format for network interchange", STD 80, RFC 20, DOI 10.17487/RFC0020, , <https://www.rfc-editor.org/info/rfc20>.
[RFC1700]
Reynolds, J. and J. Postel, "Assigned Numbers", RFC 1700, DOI 10.17487/RFC1700, , <https://www.rfc-editor.org/info/rfc1700>.
[RFC9300]
Farinacci, D., Fuller, V., Meyer, D., Lewis, D., and A. Cabellos, Ed., "The Locator/ID Separation Protocol (LISP)", RFC 9300, DOI 10.17487/RFC9300, , <https://www.rfc-editor.org/info/rfc9300>.
[RFC9301]
Farinacci, D., Maino, F., Fuller, V., and A. Cabellos, Ed., "Locator/ID Separation Protocol (LISP) Control Plane", RFC 9301, DOI 10.17487/RFC9301, , <https://www.rfc-editor.org/info/rfc9301>.

8.2. Informative References

[I-D.farinacci-lisp-geo]
Farinacci, D., "LISP Geo-Coordinate Use-Cases", Work in Progress, Internet-Draft, draft-farinacci-lisp-geo-15, , <https://datatracker.ietf.org/doc/html/draft-farinacci-lisp-geo-15>.
[I-D.farinacci-lisp-lispers-net-nat]
Farinacci, D., "lispers.net LISP NAT-Traversal Implementation Report", Work in Progress, Internet-Draft, draft-farinacci-lisp-lispers-net-nat-04, , <https://datatracker.ietf.org/doc/html/draft-farinacci-lisp-lispers-net-nat-04>.
[I-D.ietf-lisp-ecdsa-auth]
Farinacci, D. and E. Nordmark, "LISP Control-Plane ECDSA Authentication and Authorization", Work in Progress, Internet-Draft, draft-ietf-lisp-ecdsa-auth-10, , <https://datatracker.ietf.org/doc/html/draft-ietf-lisp-ecdsa-auth-10>.

Appendix A. Acknowledgments

The author would like to thank the LISP WG for their review and acceptance of this draft. And a special thank you goes to Marc Portoles for moving this document through the process.

Appendix B. Document Change Log

B.1. Changes to draft-ietf-lisp-name-encoding-02

B.2. Changes to draft-ietf-lisp-name-encoding-01

B.3. Changes to draft-ietf-lisp-name-encoding-00

B.4. Changes to draft-farinacci-lisp-name-encoding-15

B.5. Changes to draft-farinacci-lisp-name-encoding-14

B.6. Changes to draft-farinacci-lisp-name-encoding-13

B.7. Changes to draft-farinacci-lisp-name-encoding-12

B.8. Changes to draft-farinacci-lisp-name-encoding-11

B.9. Changes to draft-farinacci-lisp-name-encoding-10

B.10. Changes to draft-farinacci-lisp-name-encoding-09

B.11. Changes to draft-farinacci-lisp-name-encoding-08

B.12. Changes to draft-farinacci-lisp-name-encoding-07

B.13. Changes to draft-farinacci-lisp-name-encoding-06

B.14. Changes to draft-farinacci-lisp-name-encoding-05

B.15. Changes to draft-farinacci-lisp-name-encoding-04

B.16. Changes to draft-farinacci-lisp-name-encoding-03

B.17. Changes to draft-farinacci-lisp-name-encoding-02

B.18. Changes to draft-farinacci-lisp-name-encoding-01

B.19. Changes to draft-farinacci-lisp-name-encoding-00

Author's Address

Dino Farinacci
lispers.net
San Jose, CA
United States of America