RFC 8983 PROPOSED STANDARD IKEV2 · IPV6 · ADDRESS ASSIGNMENT

IKEv2 IPv4/IPv6: Internet Key Exchange Protocol Version 2 (IKEv2) Notification Status Types for IPv4/IPv6 Coexistence

New IKEv2 notifications let a VPN responder tell the initiator which of IPv4 and IPv6 it will hand out.

On rfc-editor.org ↗
PUBLISHED
February 2021
AUTHORS
M. Boucadair
STREAM
IETF
BUILDS ON
RFC 7296 — IKEv2
IP4_ALLOWED VALUE
16439
IP6_ALLOWED VALUE
16440
DATA IN NOTIFICATION
None
3GPP CAUSE CODES CITED
#50, #51, #52
DOI
10.17487/RFC8983

RFC text

Contents
Original text · RFC Editor View on rfc-editor.org ↗
Internet Engineering Task Force (IETF)                      M. Boucadair
Request for Comments: 8983                                        Orange
Updates: 7296                                              February 2021
Category: Standards Track
ISSN: 2070-1721


  Internet Key Exchange Protocol Version 2 (IKEv2) Notification Status
                    Types for IPv4/IPv6 Coexistence

Abstract

   This document specifies new Internet Key Exchange Protocol Version 2
   (IKEv2) notification status types to better manage IPv4 and IPv6
   coexistence by allowing the responder to signal to the initiator
   which address families are allowed.

   This document updates RFC 7296.

Status of This Memo

   This is an Internet Standards Track document.

   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).  Further information on
   Internet Standards is available in Section 2 of RFC 7841.

   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/rfc8983.

Copyright Notice

   Copyright (c) 2021 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   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 Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Table of Contents

   1.  Introduction
   2.  Terminology
   3.  Why Not INTERNAL_ADDRESS_FAILURE?
   4.  IP6_ALLOWED and IP4_ALLOWED Status Types
   5.  Update to RFC 7296
   6.  Security Considerations
   7.  IANA Considerations
   8.  References
     8.1.  Normative References
     8.2.  Informative References
   Acknowledgements
   Author's Address

1.  Introduction

   As described in [RFC7849], if the subscription data or network
   configuration allows only one IP address family (IPv4 or IPv6), the
   cellular host must not request a second PDP-Context (Section 3.2 of
   [RFC6459]) to the same Access Point Name (APN) for the other IP
   address family (AF).  The Third Generation Partnership Project (3GPP)
   network informs the cellular host about allowed Packet Data Protocol
   (PDP) types by means of Session Management (SM) cause codes.  In
   particular, the following cause codes can be returned:

   cause #50 "PDP type IPv4 only allowed":  This cause code is used by
      the network to indicate that only PDP type IPv4 is allowed for the
      requested Public Data Network (PDN) connectivity.

   cause #51 "PDP type IPv6 only allowed":  This cause code is used by
      the network to indicate that only PDP type IPv6 is allowed for the
      requested PDN connectivity.

   cause #52 "single address bearers only allowed":  This cause code is
      used by the network to indicate that the requested PDN
      connectivity is accepted with the restriction that only single IP
      version bearers are allowed.

   If the requested IPv4v6 PDP-Context is not supported by the network
   but IPv4 and IPv6 PDP types are allowed, then the cellular host will
   be configured with an IPv4 address or an IPv6 prefix by the network.
   It must initiate another PDP-Context activation of the other address
   family in addition to the one already activated for a given APN.  The
   purpose of initiating a second PDP-Context is to achieve dual-stack
   connectivity (that is, IPv4 and IPv6 connectivity) by means of two
   PDP-Contexts.

   When the User Equipment (UE) attaches to the 3GPP network using a
   non-3GPP access network (e.g., Wireless Local Area Network (WLAN)),
   there are no equivalent IKEv2 capabilities [RFC7296] notification
   codes for the 3GPP network to inform the UE why an IP address family
   is not assigned or whether that UE should retry with another address
   family.

   This document fills that void by introducing new IKEv2 notification
   status types for the sake of deterministic UE behaviors (Section 4).

   These notification status types are not specific to 3GPP
   architectures but can be used in other deployment contexts.  Cellular
   networks are provided as an illustration example.

2.  Terminology

   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.

   This document makes use of the terms defined in [RFC7296].  In
   particular, readers should be familiar with "initiator" and
   "responder" terms used in that document.

3.  Why Not INTERNAL_ADDRESS_FAILURE?

   The following address assignment failures may be encountered when an
   initiator requests assignment of IP addresses/prefixes:

   *  An initiator asks for IPvx, but IPvx address assignment is not
      supported by the responder.

   *  An initiator requests both IPv4 and IPv6 addresses, but only IPv4
      address assignment is supported by the responder.

   *  An initiator requests both IPv4 and IPv6 addresses, but only IPv6
      prefix assignment is supported by the responder.

   *  An initiator asks for both IPv4 and IPv6 addresses, but only one
      address family can be assigned by the responder for policy
      reasons.

   Section 3.15.4 of [RFC7296] defines a generic notification error type
   (INTERNAL_ADDRESS_FAILURE) that is related to a failure to handle an
   address assignment request.  The responder sends
   INTERNAL_ADDRESS_FAILURE only if no addresses can be assigned.  This
   behavior does not explicitly allow an initiator to determine why a
   given address family is not assigned, nor whether it should try using
   another address family.  INTERNAL_ADDRESS_FAILURE is a catch-all
   error type when an address-related issue is encountered by an IKEv2
   responder.

   INTERNAL_ADDRESS_FAILURE does not provide sufficient hints to the
   IKEv2 initiator to adjust its behavior.

4.  IP6_ALLOWED and IP4_ALLOWED Status Types

   IP6_ALLOWED and IP4_ALLOWED notification status types (see Section 7)
   are defined to inform the initiator about the responder's address
   family assignment support capabilities and to report to the initiator
   the reason why an address assignment failed.  These notification
   status types are used by the initiator to adjust its behavior
   accordingly (Section 5).

   No data is associated with these notifications.

5.  Update to RFC 7296

   If the initiator is dual stack (i.e., supports both IPv4 and IPv6),
   it MUST include configuration attributes for both address families in
   its configuration request (absent explicit policy/configuration
   otherwise).  More details about IPv4 and IPv6 configuration
   attributes are provided in Section 3.15 of [RFC7296].  These
   attributes are used to infer the requested/assigned AFs listed in
   Table 1.

   The responder MUST include the IP6_ALLOWED and/or IP4_ALLOWED
   notification status type in a response to an address assignment
   request as indicated in Table 1.

    +=============+==============+=============+=====================+
    | Requested   | Supported    | Assigned    | Returned            |
    | AF(s)       | AF(s)        | AF(s)       | Notification Status |
    | (Initiator) | (Responder)  | (Responder) | Type(s) (Responder) |
    +=============+==============+=============+=====================+
    | IPv4        | IPv6         | None        | IP6_ALLOWED         |
    +-------------+--------------+-------------+---------------------+
    | IPv4        | IPv4         | IPv4        | IP4_ALLOWED         |
    +-------------+--------------+-------------+---------------------+
    | IPv4        | IPv4 and     | IPv4        | IP4_ALLOWED,        |
    |             | IPv6         |             | IP6_ALLOWED         |
    +-------------+--------------+-------------+---------------------+
    | IPv6        | IPv6         | IPv6        | IP6_ALLOWED         |
    +-------------+--------------+-------------+---------------------+
    | IPv6        | IPv4         | None        | IP4_ALLOWED         |
    +-------------+--------------+-------------+---------------------+
    | IPv6        | IPv4 and     | IPv6        | IP4_ALLOWED,        |
    |             | IPv6         |             | IP6_ALLOWED         |
    +-------------+--------------+-------------+---------------------+
    | IPv4 and    | IPv4         | IPv4        | IP4_ALLOWED         |
    | IPv6        |              |             |                     |
    +-------------+--------------+-------------+---------------------+
    | IPv4 and    | IPv6         | IPv6        | IP6_ALLOWED         |
    | IPv6        |              |             |                     |
    +-------------+--------------+-------------+---------------------+
    | IPv4 and    | IPv4 and     | IPv4 and    | IP4_ALLOWED,        |
    | IPv6        | IPv6         | IPv6        | IP6_ALLOWED         |
    +-------------+--------------+-------------+---------------------+
    | IPv4 and    | IPv4 or IPv6 | IPv4 or     | IP4_ALLOWED,        |
    | IPv6        | (policy      | IPv6        | IP6_ALLOWED         |
    |             | based)       |             |                     |
    +-------------+--------------+-------------+---------------------+

               Table 1: Returned Notification Status Types

   If the initiator only receives one single IP4_ALLOWED or IP6_ALLOWED
   notification from the responder, the initiator MUST NOT send a
   subsequent request for an alternate address family not supported by
   the responder.

   If a dual-stack initiator requests only an IPv6 prefix (or an IPv4
   address) but only receives an IP4_ALLOWED (or IP6_ALLOWED)
   notification status type from the responder, the initiator MUST send
   a request for IPv4 address(es) (or IPv6 prefix(es)).

   If a dual-stack initiator requests both an IPv6 prefix and an IPv4
   address but receives an IPv6 prefix (or an IPv4 address) only with
   both IP4_ALLOWED and IP6_ALLOWED notification status types from the
   responder, the initiator MAY send a request for the other AF (i.e.,
   IPv4 address (or IPv6 prefix)).  In such case, the initiator MUST
   create a new IKE Security Association (SA) and request another
   address family using the new IKE SA.

   For other address-related error cases that have not been covered by
   the aforementioned notification status types, the responder/initiator
   MUST follow the procedure defined in Section 3.15.4 of [RFC7296].

6.  Security Considerations

   Since the IPv4/IPv6 capabilities of a node are readily determined
   from the traffic it generates, this document does not introduce any
   new security considerations compared to the ones described in
   [RFC7296], which continue to apply.

7.  IANA Considerations

   IANA has updated the "IKEv2 Notify Message Types - Status Types"
   registry (available at <https://www.iana.org/assignments/
   ikev2-parameters/>) with the following status types:

          +=======+================================+===========+
          | Value | NOTIFY MESSAGES - STATUS TYPES | Reference |
          +=======+================================+===========+
          | 16439 | IP4_ALLOWED                    | RFC 8983  |
          +-------+--------------------------------+-----------+
          | 16440 | IP6_ALLOWED                    | RFC 8983  |
          +-------+--------------------------------+-----------+

            Table 2: Updates to "IKEv2 Notify Message Types -
                          Status Types" Registry

8.  References

8.1.  Normative References

   [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>.

   [RFC7296]  Kaufman, C., Hoffman, P., Nir, Y., Eronen, P., and T.
              Kivinen, "Internet Key Exchange Protocol Version 2
              (IKEv2)", STD 79, RFC 7296, DOI 10.17487/RFC7296, October
              2014, <https://www.rfc-editor.org/info/rfc7296>.

   [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>.

8.2.  Informative References

   [RFC6459]  Korhonen, J., Ed., Soininen, J., Patil, B., Savolainen,
              T., Bajko, G., and K. Iisakkila, "IPv6 in 3rd Generation
              Partnership Project (3GPP) Evolved Packet System (EPS)",
              RFC 6459, DOI 10.17487/RFC6459, January 2012,
              <https://www.rfc-editor.org/info/rfc6459>.

   [RFC7849]  Binet, D., Boucadair, M., Vizdal, A., Chen, G., Heatley,
              N., Chandler, R., Michaud, D., Lopez, D., and W. Haeffner,
              "An IPv6 Profile for 3GPP Mobile Devices", RFC 7849,
              DOI 10.17487/RFC7849, May 2016,
              <https://www.rfc-editor.org/info/rfc7849>.

Acknowledgements

   Many thanks to Christian Jacquenet for the review.

   Thanks to Paul Wouters, Yaov Nir, Valery Smyslov, Daniel Migault,
   Tero Kivinen, and Michael Richardson for the comments and review.

   Thanks to Benjamin Kaduk for the AD review.

   Thanks to Murray Kucherawy, Éric Vyncke, and Robert Wilton for the
   IESG review.

Author's Address

   Mohamed Boucadair
   Orange
   35000 Rennes
   France

   Email: mohamed.boucadair@orange.com

AI ELI5

On this page
PROBLEMWhen an IKEv2 initiator asks for IPv4 and/or IPv6 addresses, the only generic failure signal is INTERNAL_ADDRESS_FAILURE, which does not say why an address family was not assigned or what to try next.
MECHANISMThe responder adds IP4_ALLOWED and/or IP6_ALLOWED notification status types to its response, following a table that maps what was requested and supported to what is returned. The initiator uses them to decide whether to ask again.
WHY IT MATTERSInitiators get deterministic behavior for address-family mismatches. The RFC is a Proposed Standard that updates RFC 7296 and has not been obsoleted.

§1Introduction

RFC 8983 adds two small notification status types to IKEv2, the key exchange protocol defined in RFC 7296. They let the responder tell the initiator which IP address families (IPv4 or IPv6) it allows.

The motivating case comes from cellular networks. A phone attached through a non-3GPP access network such as a WLAN has no IKEv2 notification that explains why an address family was not assigned, or whether it should retry with the other one. The RFC fills that gap, and notes that the new types are not specific to 3GPP and can be used in other deployments.

Two computers set up a private tunnel. This RFC gives one of them a way to say which kinds of addresses it is willing to give out.

§1The Cellular Precedent

Per RFC 7849, if subscription data or network configuration allows only one address family, a cellular host must not request a second PDP-Context to the same Access Point Name for the other family. The 3GPP network says what is allowed using Session Management cause codes:

  • #50 "PDP type IPv4 only allowed"
  • #51 "PDP type IPv6 only allowed"
  • #52 "single address bearers only allowed"

If a requested IPv4v6 PDP-Context is not supported but both IPv4 and IPv6 PDP types are allowed, the host gets one family and must start a second PDP-Context for the other, to reach dual-stack connectivity with two PDP-Contexts. IKEv2 had nothing equivalent.

Phone networks already tell your phone which kinds of connections it may use. The tunnel protocol had no way to say the same thing.

§3Why Not INTERNAL_ADDRESS_FAILURE?

An initiator can hit several address assignment failures: it asks for one family the responder does not support, asks for both but only IPv4 or only IPv6 can be assigned, or asks for both but policy lets the responder assign only one.

Section 3.15.4 of RFC 7296 defines the generic error INTERNAL_ADDRESS_FAILURE, and the responder sends it only if no addresses can be assigned. It is a catch-all, so it does not tell the initiator why a family was not assigned or whether to try another. The RFC concludes it does not give enough hints for the initiator to adjust its behavior.

Saying only "something went wrong with addresses" is like a shop that just says "no". You still do not know what to ask for instead.

§4IP4_ALLOWED and IP6_ALLOWED

IP4_ALLOWED and IP6_ALLOWED are notification status types that inform the initiator about the responder's address family assignment support and report why an assignment failed. The initiator uses them to adjust its behavior.

No data is associated with either notification. Their presence is the whole message.

They are like two little flags the responder can raise: one for the older kind of address, one for the newer kind.

§5Responder and Initiator Behavior

A dual-stack initiator MUST include configuration attributes for both address families in its configuration request, unless explicit policy or configuration says otherwise. The responder MUST include IP6_ALLOWED and/or IP4_ALLOWED in its response, as the table below shows.

The initiator then follows these rules:

  • If it receives just one IP4_ALLOWED or IP6_ALLOWED, it MUST NOT send a later request for the other family.
  • If a dual-stack initiator asked for only one family and receives only the notification for the other, it MUST send a request for the other family.
  • If it asked for both, got one family, and received both notifications, it MAY ask for the other family, but then MUST create a new IKE Security Association and ask on that.

For other address-related errors, both sides follow Section 3.15.4 of RFC 7296.

If the doorman says only one kind of pass exists, do not ask for the other. If you asked for the wrong one, ask for the right one. If both exist but you only got one, you may start a fresh visit to get the other.

RETURNED NOTIFICATIONS (RFC 8983, TABLE 1)
Requested (initiator)Supported (responder)AssignedReturned
IPv4IPv6NoneIP6_ALLOWED
IPv4IPv4IPv4IP4_ALLOWED
IPv4IPv4 and IPv6IPv4IP4_ALLOWED, IP6_ALLOWED
IPv6IPv6IPv6IP6_ALLOWED
IPv6IPv4NoneIP4_ALLOWED
IPv6IPv4 and IPv6IPv6IP4_ALLOWED, IP6_ALLOWED
IPv4 and IPv6IPv4IPv4IP4_ALLOWED
IPv4 and IPv6IPv6IPv6IP6_ALLOWED
IPv4 and IPv6IPv4 and IPv6IPv4 and IPv6IP4_ALLOWED, IP6_ALLOWED
IPv4 and IPv6IPv4 or IPv6 (policy based)IPv4 or IPv6IP4_ALLOWED, IP6_ALLOWED

§6Security Considerations

The RFC says that a node's IPv4/IPv6 capabilities are readily determined from the traffic it generates. It therefore introduces no new security considerations compared with RFC 7296, whose considerations continue to apply.

Anyone watching can already tell which kinds of addresses a computer uses, so these flags reveal nothing new.

§7IANA Registrations

IANA has added two entries to the "IKEv2 Notify Message Types - Status Types" registry: IP4_ALLOWED with value 16439 and IP6_ALLOWED with value 16440, both referencing RFC 8983.

Each flag got an official number in the public list of IKEv2 messages, so everyone uses the same ones.

NEW IKEV2 STATUS TYPES (RFC 8983, TABLE 2)
  • 16439IP4_ALLOWED — Responder allows IPv4 address assignment.
  • 16440IP6_ALLOWED — Responder allows IPv6 address assignment.

§8References