Network Working Group                                           K. Leung
Request for Comments: 4332                                      A. Patel
Category: Informational                                    Cisco Systems
                                                            G. Tsirtsis
                                                   Flarion Technologies
                                                            E. Klovning
                                                Birdstep Technology ASA
                                                          December 2005


          Cisco's Mobile IPv4 Host Configuration Extensions

Status of This Memo

  This memo provides information for the Internet community.  It does
  not specify an Internet standard of any kind.  Distribution of this
  memo is unlimited.

Copyright Notice

  Copyright (C) The Internet Society (2005).

IESG Note

  This RFC is not a candidate for any level of Internet Standard.  The
  IETF disclaims any knowledge of the fitness of this RFC for any
  purpose and in particular notes that the decision to publish is not
  based on IETF review for such things as security, congestion control,
  or inappropriate interaction with deployed protocols.  The RFC Editor
  has chosen to publish this document at its discretion.  Readers of
  this document should exercise caution in evaluating its value for
  implementation and deployment.  See RFC 3932 for more information.

  This RFC does not offer any security mechanisms to provide data
  origin authentication and integrity, yet these security services are
  vitally important in this context.

Abstract

  An IP device requires basic host configuration to be able to
  communicate.  For example, it will typically require an IP address
  and the address of a DNS server.  This information is configured
  statically or obtained dynamically using Dynamic Host Configuration
  Protocol (DHCP) or Point-to-Point Protocol/IP Control Protocol
  (PPP/IPCP).  However, both DHCP and PPP/IPCP provide host
  configuration based on the access network.  In Mobile IPv4, the
  registration process boots up a Mobile Node at an access network,
  also known as a foreign network.  The information to configure the



Leung, et al.                Informational                      [Page 1]

RFC 4332                      Host Config                  December 2005


  host needs to be based on the home network.  This document describes
  the Cisco vendor-specific extensions to Mobile IPv4 to provide the
  base host configuration in Registration Request and Reply messages.

Table of Contents

  1. Introduction ....................................................2
  2. Host Configuration Extensions Summary ...........................3
  3. Host Configuration Extensions ...................................4
     3.1. Host Configuration Request Extension .......................5
     3.2. Home Network Length Prefix Extension .......................5
     3.3. DNS Server Extension .......................................6
     3.4. DHCP Server Extension ......................................6
     3.5. DHCP Client ID Extension ...................................7
     3.6. Default Gateway Extension ..................................7
     3.7. DNS Suffix Extension .......................................8
     3.8. Configuration URL Extension ................................8
  4. Security Considerations .........................................9
  5. Acknowledgements ................................................9
  6. Informative References ..........................................9

1.  Introduction

  An IPv4 device requires some basic configuration to communicate with
  other nodes.  Typically, it has an IP address for an interface and
  DNS server's IP address to resolve the peer's hostname to an IP
  address.  DHCP [RFC2131] and PPP/IPCP [RFC1332] provide host
  configuration information on the access network interface, but this
  is inadequate in a Mobile IPv4 environment.  In Mobile IPv4
  [RFC3344], a Mobile Node has a virtual network interface on the home
  network, anchored by the Home Agent.  The IP address, home subnet
  prefix, default gateway, and home network's DNS servers are essential
  in the boot up of a network interface.  In some cases, these are the
  only pieces of information needed by the Mobile Node.

  The Mobile IPv4 registration process provides the mechanism for a
  Mobile Node to boot up on a foreign network.  Upon the successful
  registration, the Mobile Node can communicate with the Correspondent
  Node.  The need to provide an efficient method to obtain the host
  configuration exists.  If the Mobile Node is a DHCP client, it can
  obtain configuration parameters from the DHCP server in the home
  network after the initial registration.

  This document introduces the Cisco vendor-specific extensions (VSEs)
  [RFC3115] to provide the means for a Mobile Node to download some
  fundamental configuration associated with the home network via the





Leung, et al.                Informational                      [Page 2]

RFC 4332                      Host Config                  December 2005


  Home Agent.  These extensions provide information for home subnet
  prefix, DNS server, DHCP server, DHCP client identifier, default
  gateway, DNS suffix, and configuration URL.

2.  Host Configuration Extensions Summary

  The following Cisco vendor-specific extensions provide the host
  configuration for a Mobile Node.  The "Host Configuration Request"
  extension is allowed only in the Registration Request.  The rest of
  the extensions are appended in the Registration Reply.

  o  Host Configuration Request

     *  Request for host configuration information from the Mobile Node
        to the Home Agent.

  o  Home Network Prefix Length

     *  The length of the subnet prefix on the home network.

  o  Default Gateway

     *  The default gateway's IP address on the home network.

  o  DNS Server

     *  The DNS server's IP address in the home network.

  o  DNS Suffix

     *  The DNS suffix for hostname resolution in the home network.

  o  DHCP Client ID

     *  The DHCP Client ID used to obtain the IP address.  When the
        Mobile Node returns home and is responsible for managing its
        own address, this information maps to the client identifier
        option as defined in section 9.14 of [RFC2132] and referenced
        in [RFC2131].

  o  DHCP Server

     *  The DHCP server's IP address in the home network.

  o  Configuration URL

     *  The URL for the Mobile Node to download configuration
        parameters from a server.



Leung, et al.                Informational                      [Page 3]

RFC 4332                      Host Config                  December 2005


  When the Mobile Node needs to obtain its host configuration, the Host
  Configuration Request VSE is appended to the Registration Request.
  This VSE indicates to the Home Agent that either all or selected host
  configuration VSEs need to be appended to the Registration Reply.  If
  the Home Agent retrieved the information from a DHCP server (in Proxy
  DHCP mode), then the DHCP Client ID and DHCP Server extensions are
  appended in the Registration Reply.  These DHCP-related extensions
  are populated with values that had been used in the DHCP messages
  exchanged between the Home Agent and the DHCP server.

  The VSEs are authenticated as part of the registration message using
  any of the authentication mechanism defined for Mobile IP ([RFC3344],
  [RFC3012]).

  This message MAY contain extensions defined in Mobile IP, including
  vendor-specific extensions [RFC3115].

3.  Host Configuration Extensions

  Cisco's host configuration extensions to Mobile IPv4 are based on the
  vendor-specific extensions defined in [RFC3115].  The format of the
  VSE TLV (Type-Length-Value) is as follows:

   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
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |     Type      |   Length      |          Reserved             |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |                          Vendor/Org-ID                        |
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
   |       Vendor-NVSE-Type        |     Vendor-NVSE-Value ...
   +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

    Type: 134

    Length:

       Indicates the length (in bytes) of the data field within this
       extension, excluding the Type and Length fields.

    Reserved:

       Reserved for future use.  To be set to 0 while sending, ignored
       on reception.

    Vendor/Org-ID:

       9 (Cisco Systems)



Leung, et al.                Informational                      [Page 4]

RFC 4332                      Host Config                  December 2005


    Vendor-NVSE-Type:

       14 (Host Configuration)

    Vendor-NVSE-Value:

       Format is shown below for each subtype.  The Sub-Type field is
       an integer from 0 to 255.

3.1.  Host Configuration Request Extension

  This format of the Host Configuration Request extension is shown
  below.

    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
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |           Sub-Type            |           Selector            |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

     Sub-Type:

        0

     Selector:

        0 indicates all host configuration available to the Home
        Agent (HA) is requested by the Mobile Node.

3.2.  Home Network Length Prefix Extension

  This format of the Home Network Prefix Length extension is shown
  below.

    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
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |           Sub-Type            |        Prefix Length          |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

     Sub-Type:

        1

     Prefix Length:

        The number of bits in the home subnet prefix.




Leung, et al.                Informational                      [Page 5]

RFC 4332                      Host Config                  December 2005


3.3.  DNS Server Extension

  This format of the DNS Server extension is shown below.

    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
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |           Sub-Type            |        Primary DNS Server
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
                . . .               |        Secondary DNS Server
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
                . . .               |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

     Sub-Type:

        2

     Primary DNS Server:

        The IP address of the primary DNS server.

     Secondary DNS Server:

        The IP address of the secondary DNS server.

3.4.  DHCP Server Extension

  This format of the DHCP Server extension is shown below.

    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
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |           Sub-Type            |          DHCP Server
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
                . . .               |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

     Sub-Type:

        3

     DHCP Server:

        The IP address of the DHCP server.






Leung, et al.                Informational                      [Page 6]

RFC 4332                      Host Config                  December 2005


3.5.  DHCP Client ID Extension

  This format of the DHCP Client ID extension is shown below.

    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
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |           Sub-Type            |          Client ID . . .
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

     Sub-Type:

        4

     Client ID:

        DHCP servers use this value to index their database of address
        bindings.  This value is expected to be unique for all clients
        in an administrative domain.  The size of field is between 2
        and 255 octets.

3.6.  Default Gateway Extension

  This format of the Default Gateway extension is shown below.

    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
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |           Sub-Type            |          Default Gateway
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
                . . .               |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

     Sub-Type:

        5

     Default Gateway:

        The IP address of the default gateway for the Mobile Node on
        the home network.










Leung, et al.                Informational                      [Page 7]

RFC 4332                      Host Config                  December 2005


3.7.  DNS Suffix Extension

  This format of the DNS Suffix extension is shown below.

    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
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |           Sub-Type            |         DNS Suffix . . .
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

     Sub-Type:

        6

     DNS Suffix:

        The DNS suffix to be appended to the name of Mobile Node when
        completing its fully qualified domain name (FQDN).  The size of
        field is between 1 and 246 octets.

3.8.  Configuration URL Extension

  This format of the Configuration URL extension is shown below.

    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
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |           Sub-Type            |         URL String . . .
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

     Sub-Type:

        7

     URL String:

        The Mobile Node can retrieve configuration parameters via the
        URL.  The URL is at most 246 bytes in length.













Leung, et al.                Informational                      [Page 8]

RFC 4332                      Host Config                  December 2005


4.  Security Considerations

  The host configuration extensions follow the same rules for Mobile IP
  extensions in registration messages.  See the Security Considerations
  section in RFC 3344.

  The Configuration URL extension may trigger the Mobile Node to
  download the configuration parameters from a server.  The protection
  of the data transfer is outside the scope of this document.  Possible
  options include encryption of data before transfer or using HTTPS.

5.  Acknowledgements

  The authors would like to acknowledge Jayshree Bharatia, Kuntal
  Chowdhury, Avi Lior, and Lila Madour for their contributions to the
  work in progress titled "Mobile IPv4 Extension for Configuration
  Options Exchange".

6.  Informative References

  [RFC1332]  McGregor, G., "The PPP Internet Protocol Control Protocol
             (IPCP)", RFC 1332, May 1992.

  [RFC2131]  Droms, R., "Dynamic Host Configuration Protocol",
             RFC 2131, March 1997.

  [RFC2132]  Alexander, S. and R. Droms, "DHCP Options and BOOTP Vendor
             Extensions", RFC 2132, March 1997.

  [RFC3012]  Perkins, C. and P. Calhoun, "Mobile IPv4 Challenge/
             Response Extensions", RFC 3012, November 2000.

  [RFC3115]  Dommety, G. and K. Leung, "Mobile IP Vendor/
             Organization-Specific Extensions", RFC 3115, April 2001.

  [RFC3344]  Perkins, C., "IP Mobility Support for IPv4", RFC 3344,
             August 2002.














Leung, et al.                Informational                      [Page 9]

RFC 4332                      Host Config                  December 2005


Authors' Addresses

  Kent Leung
  Cisco Systems
  170 W. Tasman Drive
  San Jose, CA  95134
  US

  Phone: +1 408-526-5030
  EMail: [email protected]


  Alpesh Patel
  Cisco Systems
  170 W. Tasman Drive
  San Jose, CA  95134
  US

  Phone: +1 408-853-9580
  EMail: [email protected]


  George Tsirtsis
  Flarion Technologies
  Bedminster One
  135 Route 202/206 South
  Bedminster, NJ  07921
  US

  Phone: +1 908-947-7059
  EMail: [email protected]


  Espen Klovning
  Birdstep Technology ASA
  Bryggegata 7
  Oslo,   0250
  Norway

  Phone: +47 95 20 26 29
  EMail: [email protected]










Leung, et al.                Informational                     [Page 10]

RFC 4332                      Host Config                  December 2005


Full Copyright Statement

  Copyright (C) The Internet Society (2005).

  This document is subject to the rights, licenses and restrictions
  contained in BCP 78 and at www.rfc-editor.org/copyright.html, and
  except as set forth therein, the authors retain all their rights.

  This document and the information contained herein are provided on an
  "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
  OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
  ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
  INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
  INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
  WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Intellectual Property

  The IETF takes no position regarding the validity or scope of any
  Intellectual Property Rights or other rights that might be claimed to
  pertain to the implementation or use of the technology described in
  this document or the extent to which any license under such rights
  might or might not be available; nor does it represent that it has
  made any independent effort to identify any such rights.  Information
  on the procedures with respect to rights in RFC documents can be
  found in BCP 78 and BCP 79.

  Copies of IPR disclosures made to the IETF Secretariat and any
  assurances of licenses to be made available, or the result of an
  attempt made to obtain a general license or permission for the use of
  such proprietary rights by implementers or users of this
  specification can be obtained from the IETF on-line IPR repository at
  http://www.ietf.org/ipr.

  The IETF invites any interested party to bring to its attention any
  copyrights, patents or patent applications, or other proprietary
  rights that may cover technology that may be required to implement
  this standard.  Please address the information to the IETF at ietf-
  [email protected].

Acknowledgement

  Funding for the RFC Editor function is currently provided by the
  Internet Society.







Leung, et al.                Informational                     [Page 11]