A YANG Data Model for Traffic Engineering Tunnels and Interfaces
draft-ietf-teas-yang-te-18

Network Working Group                                         S. Kille
Request for Comments: 2164                                  Isode Ltd.
Obsoletes: 1838                                           January 1998
Category: Standards Track

    Use of an X.500/LDAP directory to support MIXER address mapping

Status of this Memo

   This document specifies an Internet standards track protocol for the
   Internet community, and requests discussion and suggestions for
   improvements.  Please refer to the current edition of the "Internet
   Official Protocol Standards" (STD 1) for the standardization state
   and status of this protocol.  Distribution of this memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (1998).  All Rights Reserved.

1  MIXER X.400/RFC 822 Mappings

   MIXER (RFC 2156) defines an algorithm for use of a set of global
   mapping between X.400 and RFC 822 addresses [4].  This specification
   defines how to represent and maintain these mappings (MIXER
   Conformant Global Address Mappings of MCGAMs) in an X.500 or LDAP
   directory.  Mechanisms for representing OR Address and Domain
   hierarchies within the DIT are defined in [5, 2].  These techniques
   are used to define two independent subtrees in the DIT, which contain
   the mapping information.  The benefits of this approach are:

   1.  The mapping information is kept in a clearly defined area which
       can be widely replicated in an efficient manner.  The tree is
       constrained to hold only information needed to support the
       mapping.  This is important as gateways need good access to the
       entire mapping.

   2.  It facilitates migration from a table-based approach.

   3.  It handles the issues of "missing components" in a natural
       manner.

          An alternative approach which is not taken is to locate the
          information in the routing subtrees.  The benefits of this
          would be:

Kille                       Standards Track                     [Page 1]
RFC 2164         X.500/LDAP Directory to Support MIXER      January 1998

        o  It is the "natural" location, and will also help to
           ensure correct administrative authority for a mapping
           definition.

        o  The tree will usually be accessed for routing, and so it
           will be efficient for addresses which are being routed.

          This is not done, as the benefits of the approach proposed are
          greater.

   MCGAMs are global.  A MIXER gateway may use any set of MCGAMs.  A key
   use of the directory is to enable MIXER gateways to share MCGAMs and
   to share the effort of maintaining and publishing MCGAMs.  This
   specification and MIXER also recognise that there is not a single
   unique location for publication of all MCGAMs.  This specification
   allows for multiple sets of MCGAMs to be published.  Each set of
   MCGAMs is published under a single part of the directory.  There are
   four mappings, which are represented by two subtrees located under
   any part of the DIT. For the examples the location defined below is
   used:

   OU=MIXER MCGAMs, O=Zydeco Plc,  C=GB

   These subtree roots are of object class subtree, and use the
   mechanism for representing subtrees defined in [1].

   X.400 to RFC 822 This table gives the equivalence mapping from X.400
       to RFC 822.  There is an OR Address tree under this.  An example
       entry is:

       PRMD=Isode, ADMD=Mailnet, C=FI, CN=X.400 to RFC 822,
       OU=MIXER MCGAMs, O=Zydeco Plc,  C=GB

   RFC 822 to X.400 There is a domain tree under this.  This table holds
       the equivalence mapping from RFC 822 to X.400, and the gateway
       mapping defined in RFC 1327.  An example entry is:

       DomainComponent=ISODE, DomainComponent=COM,
       CN=RFC 822 to X.400,
       OU=MIXER MCGAMs, O=Zydeco Plc,  C=GB

   The values of the table mapping are defined by use of two new object
   classes, as specified in Figure 1.  The objects give pointers to the
   mapped components.

Kille                       Standards Track                     [Page 2]
RFC 2164         X.500/LDAP Directory to Support MIXER      January 1998

2  Omitted Components

   In MIXER, it is possible to have omitted components in OR Addresses
   on either side of the mapping.  A mechanism to represent such omitted
   components is defined in Figure 2.  The attribute at-or-address-
   component-type is set to the X.500 attribute type associated with the
   omitted component (e.g.,

rFC822ToX400Mapping OBJECT-CLASS ::= {
    SUBCLASS OF {domain-component}
    MAY CONTAIN {
        associatedORAddress|
        associatedX400Gateway}
    ID oc-rfc822-to-x400-mapping}

x400ToRFC822Mapping OBJECT-CLASS ::= {
    SUBCLASS OF {top}
    MAY CONTAIN {                                                   10
        associatedDomain|
        associatedInternetGateway}
    ID oc-x400-to-rfc822-mapping}

associatedORAddress ATTRIBUTE ::= {
    SUBTYPE OF distinguishedName
    SINGLE VALUE
    ID at-associated-or-address}

                                                                    20
associatedX400Gateway ATTRIBUTE ::= {
    SUBTYPE OF mhs-or-addresses
    MULTI VALUE
    ID at-associated-x400-gateway}

associatedDomain ATTRIBUTE ::= {
    SUBTYPE OF name
    WITH SYNTAX caseIgnoreIA5String
    SINGLE VALUE
    ID at-associated-domain}                                        30

associatedInternetGateway ATTRIBUTE ::= {
    SUBTYPE OF name
    WITH SYNTAX caseIgnoreIA5String
    MULTI VALUE
    ID at-associated-internet-gateway}

              Figure 1:  Object Classes for MIXER mappings

Kille                       Standards Track                     [Page 3]
RFC 2164         X.500/LDAP Directory to Support MIXER      January 1998

omittedORAddressComponent OBJECT-CLASS ::=
        SUBCLASS OF {top}
        MUST Contain {
                oRAddressComponentType
        }
        ID oc-omitted-or-address-component}

oRAddressComponentType ATTRIBUTE ::= {
        SUBTYPE OF  objectIdentifier                                10
        SINGLE VALUE
        ID at-or-address-component-type}

                Figure 2:  Omitted OR Address Component

   at-prmd-name).  This mechanism is for use only within the X.400 to
   RFC 822 subtree and for the at-associated-or-address attribute.

3  Mapping from X.400 to RFC 822

   As an example, consider the mapping from the OR Address:

   P=Isode; A=Mailnet; C=FI

   This would be keyed by the directory entry:

   PRMD=Isode, ADMD=Mailnet, C=FI, CN=X.400 to RFC 822,
   OU=MIXER MCGAMs, O=Zydeco Plc,  C=GB

   and return the mapping from the associatedDomain attribute, which
   gives the domain which this OR address maps to.  This attribute is
   used to define authoritative mappings, which are placed in the open
   community tree.  The manager of an MCGAM shall make the appropriate
   entry.

   The Internet gateway mapping defined in MIXER[4] is provided by the
   associatedInternetGateway attribute.  This value may identify
   multiple possible associated gateways.  This information is looked up
   at the same time as mapped OR addresses.  In effect, this provides a
   fallback mapping, which is found if there is no equivalence mapping.
   Because of the nature of the mapping an OR Address will map to either
   a gateway or a domain, but not both.  Thus, there shall never be both

Kille                       Standards Track                     [Page 4]
RFC 2164         X.500/LDAP Directory to Support MIXER      January 1998

   an associatedDomain and associatedInternetGateway attribute present
   in the same entry.  Functionally, mapping takes place exactly
   according to MIXER. The longest match is found by the following
   algorithm.

   1.  Take the OR Address, and derive a directory name.  This will be
       the OR Address as far as the lowest OU.

   2.  Look up the entire name derived from the MIXER key in the in the
       X.400 to RFC 822 subtree.  This lookup will either succeed, or it
       will fail and indicate the longest possible match, which can then
       be looked up.

   3.  Check for an associatedDomain or associatedInternetGateway
       attribute in the matched entry.

   The mapping can always be achieved with two lookups.  Because of the
   availability of aliases, some of the table mappings may be
   simplified.  In addition, the directory can support mapping from
   addresses using the numeric country codes.

4  Mapping from RFC 822 to X.400

   There is an analogous structure for mappings in the reverse
   direction.  The domain hierarchy is represented in the DIT according
   to RFC 1279.  The domain:

   ISODE.COM

   Is represented in the DIT as:

   DomainComponent=ISODE, DomainComponent=COM,  CN=RFC 822 to X.400,
   OU=MIXER MCGAMs, O=Zydeco Plc,  C=GB

   This has associated with it the attribute associatedORAddress encoded
   as a distinguished name with a value: PRMD=Isode, ADMD=Mailnet, C=FI

   The X.400 gateway mapping defined in MIXER[4] is provided by the
   associatedX400Gateway attribute.  This value may identify multiple
   possible associated gateways.  This information is looked up at the
   same time as mapped OR addresses.  In effect, this provides a
   fallback mapping, which is found if there is no equivalence mapping.
   Because of the nature of the mapping a domain will map to either a
   gateway or a domain, but not both.  Thus, there shall never be both
   an associatedX400Gateway and associatedORAddress attribute present in
   the same entry.  Functionally, mapping takes place exactly according
   to MIXER. The longest match is found by the following algorithm.

Kille                       Standards Track                     [Page 5]
RFC 2164         X.500/LDAP Directory to Support MIXER      January 1998

   1.  Derive a directory name from the domain part of the RFC 822
       address.

   2.  Look up this name in the RFC 822 to X.400 subtree to find the
       mapped value (either associatedORAddress or
       associatedX400Gateway.).  If the lookup fails, the error will
       indicate the longest match, which can then be looked up.

   If associatedORAddress is found, this will define the mapped OR
   Address.  The mapping can always be achieved with two lookups.  If an
   associatedX400Gateway is present, the address in question will be
   encoded as a domain defined attribute, relative to the OR Address
   defined by this attribute.  If multiple associatedX400Gateway
   attributes are found, the MTA may select the one it chooses to use.

   Because of the availability of aliases, some of the table mappings
   may be simplified.  In addition, the directory can support mapping
   from addresses using the numeric country codes.

5  Gateway Selection of MCGAMs

   The directory information to support identification of MCGAMs is
   given in Figure 3.  A MIXER gateway simply identifies the an ordered
   lists of MCGAM collections that it will use for lookup.  These are
   referenced by name.  A gateway is not required to use any MCGAMs.
   Where MCGAMs are accessed from multiple sources, it is recommended
   that all of the sources be accessed in order to determine the MCGAM
   which gives the

mixerGateway OBJECT-CLASS ::=
        KIND auxiliary
        SUBCLASS OF {mhs-message-transfer-agent}
        MUST Contain {
                mcgamTables
        }
        ID oc-mixer-gateway}

mcgamTables ATTRIBUTE ::= {                                         10
        WITH SYNTAX SEQUENCE OF DistinguishedName
        SINGLE VALUE
        ID at-mcgam-tables}

             Figure 3:  Object Classes for MCGAM selection

best match.

Kille                       Standards Track                     [Page 6]
RFC 2164         X.500/LDAP Directory to Support MIXER      January 1998

6  Acknowledgements

   Acknowledgements for work on this document are given in [3].

References

   [1] Kille, S., "Representing tables and subtrees in the X.500
       directory", RFC 1837, August 1995.

   [2] Kille, S., "Representing the O/R Address hierarchy in the X.500
       directory information tree," RFC 1836, August 1995.

   [3] Kille, S., " X.400-MHS use of the X.500 directory to support
       X.400-MHS routing," RFC 1801, June 1995.

   [4] Kille, S., "MIXER (Mime Internet X.400 Enhanced Relay):
       Mapping between X.400 and RFC 822/MIME," RFC 2156, January 1998.

   [5] Kille, S., Wahl, M., Grimsatd, A., Huber, R., and S. Sataluri,
       "Using Domains in LDAP/X.500 Distinguished Names", RFC 2247,
       January 1998.

7  Security Considerations

   This document specifies a means by which the X.500/LDAP directory
   service can direct the translation between X.400 and Internet mail
   addresses.  This can indirectly affect the routing of messages across
   a gateway between X.400 and Internet Mail.  A succesful attack on
   this service could cause incorrect translation of an originator
   address (thus "forging&Saad, et al.             Expires August 19, 2019               [Page 98]
Internet-Draft             TE YANG Data Model              February 2019

   [RFC8294]  Liu, X., Qu, Y., Lindem, A., Hopps, C., and L. Berger,
              "Common YANG Data Types for the Routing Area", RFC 8294,
              DOI 10.17487/RFC8294, December 2017,
              <https://www.rfc-editor.org/info/rfc8294>.

   [RFC8341]  Bierman, A. and M. Bjorklund, "Network Configuration
              Access Control Model", STD 91, RFC 8341,
              DOI 10.17487/RFC8341, March 2018,
              <https://www.rfc-editor.org/info/rfc8341>.

   [RFC8342]  Bjorklund, M., Schoenwaelder, J., Shafer, P., Watsen, K.,
              and R. Wilton, "Network Management Datastore Architecture
              (NMDA)", RFC 8342, DOI 10.17487/RFC8342, March 2018,
              <https://www.rfc-editor.org/info/rfc8342>.

   [RFC8343]  Bjorklund, M., "A YANG Data Model for Interface
              Management", RFC 8343, DOI 10.17487/RFC8343, March 2018,
              <https://www.rfc-editor.org/info/rfc8343>.

9.2.  Informative References

   [RFC4427]  Mannie, E., Ed. and D. Papadimitriou, Ed., "Recovery
              (Protection and Restoration) Terminology for Generalized
              Multi-Protocol Label Switching (GMPLS)", RFC 4427,
              DOI 10.17487/RFC4427, March 2006,
              <https://www.rfc-editor.org/info/rfc4427>.

Authors' Addresses

   Tarek Saad
   Cisco Systems Inc

   Email: tsaad@cisco.com

   Rakesh Gandhi
   Cisco Systems Inc

   Email: rgandhi@cisco.com

   Xufeng Liu
   Volta Networks

   Email: xufeng.liu.ietf@gmail.com

Saad, et al.             Expires August 19, 2019               [Page 99]
Internet-Draft             TE YANG Data Model              February 2019

   Vishnu Pavan Beeram
   Juniper Networks

   Email: vbeeram@juniper.net

   Igor Bryskin
   Huawei Technologies

   Email: Igor.Bryskin@huawei.com

Saad, et al.             Expires August 19, 2019              [Page 100]