doc/rfc/rfc4818.txt

   1
   2
   3
   4
   5
   6
   7 Network Working Group                                         J. Salowey
   8 Request for Comments: 4818                                      R. Droms
   9 Category: Standards Track                            Cisco Systems, Inc.
  10                                                               April 2007
  11
  12
  13                  RADIUS Delegated-IPv6-Prefix Attribute
  14
  15 Status of This Memo
  16
  17    This document specifies an Internet standards track protocol for the
  18    Internet community, and requests discussion and suggestions for
  19    improvements.  Please refer to the current edition of the "Internet
  20    Official Protocol Standards" (STD 1) for the standardization state
  21    and status of this protocol.  Distribution of this memo is unlimited.
  22
  23 Copyright Notice
  24
  25    Copyright (C) The IETF Trust (2007).
  26
  27 Abstract
  28
  29    This document defines a RADIUS (Remote Authentication Dial In User
  30    Service) attribute that carries an IPv6 prefix that is to be
  31    delegated to the user.  This attribute is usable within either RADIUS
  32    or Diameter.
  33
  34
  35
  36
  37
  38
  39
  40
  41
  42
  43
  44
  45
  46
  47
  48
  49
  50
  51
  52
  53
  54
  55
  56
  57
  58 Salowey & Droms             Standards Track                     [Page 1]
  59 \f
  60 RFC 4818            Delegated-IPv6-Prefix Attribute           April 2007
  61
  62
  63 1.  Introduction
  64
  65    This document defines the Delegated-IPv6-Prefix attribute as a RADIUS
  66    [1] attribute that carries an IPv6 prefix to be delegated to the
  67    user, for use in the user's network.  For example, the prefix in a
  68    Delegated-IPv6-Prefix attribute can be delegated to another node
  69    through DHCP Prefix Delegation [2].
  70
  71    The Delegated-IPv6-Prefix attribute can be used in DHCP Prefix
  72    Delegation between the delegating router and a RADIUS server, as
  73    illustrated in the following message sequence.
  74
  75
  76    Requesting Router   Delegating Router                   RADIUS Server
  77          |                     |                                 |
  78          |-Solicit------------>|                                 |
  79          |                     |-Request------------------------>|
  80          |                     |<--Accept(Delegated-IPv6-Prefix)-|
  81          |<--Advertise(Prefix)-|                                 |
  82          |-Request(Prefix)---->|                                 |
  83          |<--Reply(Prefix)-----|                                 |
  84          |                     |                                 |
  85                 DHCP PD                      RADIUS
  86
  87
  88    The Framed-IPv6-Prefix attribute [4] is not designed to support
  89    delegation of IPv6 prefixes to be used in the user's network, and
  90    therefore Framed-IPv6-Prefix and Delegated-IPv6-Prefix attributes may
  91    be included in the same RADIUS packet.
  92
  93 2.  Terminology
  94
  95    The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
  96    "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
  97    document are to be interpreted as described in RFC 2119 [3].
  98
  99
 100
 101
 102
 103
 104
 105
 106
 107
 108
 109
 110
 111
 112
 113
 114 Salowey & Droms             Standards Track                     [Page 2]
 115 \f
 116 RFC 4818            Delegated-IPv6-Prefix Attribute           April 2007
 117
 118
 119 3.  Attribute Format
 120
 121    The format of the Delegated-IPv6-Prefix is:
 122
 123        0                   1                   2                   3
 124        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
 125       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 126       |     Type      |    Length     |  Reserved     | Prefix-Length |
 127       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 128                                    Prefix
 129       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 130                                    Prefix
 131       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 132                                    Prefix
 133       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 134                                    Prefix                             |
 135       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 136
 137       Type
 138
 139            123 for Delegated-IPv6-Prefix
 140
 141       Length
 142
 143            The length of the entire attribute, in bytes.  At least 4 (to
 144            hold Type/Length/Reserved/Prefix-Length for a 0-bit prefix),
 145            and no larger than 20 (to hold Type/Length/ Reserved/Prefix-
 146            Length for a 128-bit prefix)
 147
 148       Reserved
 149
 150            Always set to zero by sender; ignored by receiver
 151
 152       Prefix-Length
 153
 154            The length of the prefix being delegated, in bits.  At least
 155            0 and no larger than 128 bits (identifying a single IPv6
 156            address)
 157
 158    Note that the prefix field is only required to be long enough to hold
 159    the prefix bits and can be shorter than 16 bytes.  Any bits in the
 160    prefix field that are not part of the prefix MUST be zero.
 161
 162    The Delegated-IPv6-Prefix MAY appear in an Access-Accept packet, and
 163    can appear multiple times.  It MAY appear in an Access-Request packet
 164    as a hint by the NAS to the server that it would prefer these
 165    prefix(es), but the server is not required to honor the hint.
 166
 167
 168
 169
 170 Salowey & Droms             Standards Track                     [Page 3]
 171 \f
 172 RFC 4818            Delegated-IPv6-Prefix Attribute           April 2007
 173
 174
 175    The Delegated-IPv6-Prefix attribute MAY appear in an Accounting-
 176    Request packet.
 177
 178    The Delegated-IPv6-Prefix MUST NOT appear in any other RADIUS
 179    packets.
 180
 181 4.  Table of Attributes
 182
 183    The following table provides a guide to which attributes may be found
 184    in which kinds of packets, and in what quantity.
 185
 186    +-------------------------------------------------------------------+
 187    | Request Accept Reject Challenge Accounting  #   Attribute         |
 188    |                                 Request                           |
 189    | 0+      0+     0      0         0+          123 Delegated-IPv6-   |
 190    |                                                 Prefix            |
 191    +-------------------------------------------------------------------+
 192
 193    The meaning of the above table entries is as follows:
 194       0   This attribute MUST NOT be present.
 195       0+  Zero or more instances of this attribute MAY be present.
 196       0-1 Zero or one instance of this attribute MAY be present.
 197       1   Exactly one instance of this attribute MUST be present.
 198       1+  One or more of these attributes MUST be present.
 199
 200 5.  Diameter Considerations
 201
 202    When used in Diameter, the attribute defined in this specification
 203    can be used as a Diameter AVP from the Code space 1-255, i.e., RADIUS
 204    attribute compatibility space.  No additional Diameter Code values
 205    are therefore allocated.  The data types of the attributes are as
 206    follows:
 207
 208         Delegated-IPv6-Prefix             OctetString
 209
 210    The attribute in this specification has no special translation
 211    requirements for Diameter to RADIUS or RADIUS to Diameter gateways,
 212    i.e., the attribute is copied as is, except for changes relating to
 213    headers, alignment, and padding.  See also RFC 3588 [5], Section 4.1,
 214    and RFC 4005 [6], Section 9.
 215
 216    The text in this specification describing the applicability of the
 217    Delegated-IPv6-Prefix attribute for RADIUS Access-Request applies in
 218    Diameter to AA-Request [6] or Diameter-EAP-Request [7].
 219
 220    The text in this specification describing the applicability of the
 221    Delegated-IPv6-Prefix attribute for RADIUS Access-Accept applies in
 222    Diameter to AA-Answer or Diameter-EAP-Answer that indicates success.
 223
 224
 225
 226 Salowey & Droms             Standards Track                     [Page 4]
 227 \f
 228 RFC 4818            Delegated-IPv6-Prefix Attribute           April 2007
 229
 230
 231    The text in this specification describing the applicability of the
 232    Delegated-IPv6-Prefix attribute for RADIUS Accounting-Request applies
 233    to Diameter Accounting-Request [6] as well.
 234
 235    The AVP flag rules [5] for the Delegated-IPv6-Prefix attribute are:
 236
 237                                       +---------------------+
 238                                       |    AVP Flag rules   |
 239                                       |----+-----+----+-----|----+
 240                      AVP              |    |     |SHLD| MUST|    |
 241      Attribute Name  Code  Value Type |MUST| MAY | NOT|  NOT|Encr|
 242      ---------------------------------|----+-----+----+-----|----|
 243      Delegated-IPv6- 123   OctetString| M  |  P  |    |  V  | Y  |
 244        Prefix                         |    |     |    |     |    |
 245      ---------------------------------|----+-----+----+-----|----|
 246
 247 6.  IANA Considerations
 248
 249    IANA assigned a Type value, 123, for this attribute from the RADIUS
 250    Attribute Types registry.
 251
 252 7.  Security Considerations
 253
 254    Known security vulnerabilities of the RADIUS protocol are discussed
 255    in RFC 2607 [8], RFC 2865 [1], and RFC 2869 [9].  Use of IPsec [10]
 256    for providing security when RADIUS is carried in IPv6 is discussed in
 257    RFC 3162.
 258
 259    Security considerations for the Diameter protocol are discussed in
 260    RFC 3588 [5].
 261
 262 8.  References
 263
 264 8.1.  Normative References
 265
 266    [1]  Rigney, C., Willens, S., Rubens, A., and W. Simpson, "Remote
 267         Authentication Dial In User Service (RADIUS)", RFC 2865, June
 268         2000.
 269
 270    [2]  Troan, O. and R. Droms, "IPv6 Prefix Options for Dynamic Host
 271         Configuration Protocol (DHCP) version 6", RFC 3633, December
 272         2003.
 273
 274    [3]  Bradner, S., "Key words for use in RFCs to Indicate Requirement
 275         Levels", BCP 14, RFC 2119, March 1997.
 276
 277
 278
 279
 280
 281
 282 Salowey & Droms             Standards Track                     [Page 5]
 283 \f
 284 RFC 4818            Delegated-IPv6-Prefix Attribute           April 2007
 285
 286
 287 9.2.  Informative References
 288
 289    [4]  Aboba, B., Zorn, G., and D. Mitton, "RADIUS and IPv6", RFC 3162,
 290         August 2001.
 291
 292    [5]  Calhoun, P., Loughney, J., Guttman, E., Zorn, G., and J. Arkko,
 293         "Diameter Base Protocol", RFC 3588, September 2003.
 294
 295    [6]  Calhoun, P., Zorn, G., Spence, D., and D. Mitton, "Diameter
 296         Network Access Server Application", RFC 4005, August 2005.
 297
 298    [7]  Eronen, P., Hiller, T., and G. Zorn, "Diameter Extensible
 299         Authentication Protocol (EAP) Application", RFC 4072, August
 300         2005.
 301
 302    [8]  Aboba, B. and J. Vollbrecht, "Proxy Chaining and Policy
 303         Implementation in Roaming", RFC 2607, June 1999.
 304
 305    [9]  Rigney, C., Willats, W., and P. Calhoun, "RADIUS Extensions",
 306         RFC 2869, June 2000.
 307
 308    [10] Kent, S. and K. Seo, "Security Architecture for the Internet
 309         Protocol", RFC 4301, December 2005.
 310
 311 Authors' Addresses
 312
 313    Joe Salowey
 314    Cisco Systems, Inc.
 315    2901 Third Avenue
 316    Seattle, WA  98121
 317    USA
 318
 319    Phone: +1 206.310.0596
 320    EMail: jsalowey@cisco.com
 321
 322
 323    Ralph Droms
 324    Cisco Systems, Inc.
 325    1414 Massachusetts Avenue
 326    Boxborough, MA  01719
 327    USA
 328
 329    Phone: +1 978.936.1674
 330    EMail: rdroms@cisco.com
 331
 332
 333
 334
 335
 336
 337
 338 Salowey & Droms             Standards Track                     [Page 6]
 339 \f
 340 RFC 4818            Delegated-IPv6-Prefix Attribute           April 2007
 341
 342
 343 Full Copyright Statement
 344
 345    Copyright (C) The IETF Trust (2007).
 346
 347    This document is subject to the rights, licenses and restrictions
 348    contained in BCP 78, and except as set forth therein, the authors
 349    retain all their rights.
 350
 351    This document and the information contained herein are provided on an
 352    "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
 353    OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND
 354    THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS
 355    OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
 356    THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
 357    WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
 358
 359 Intellectual Property
 360
 361    The IETF takes no position regarding the validity or scope of any
 362    Intellectual Property Rights or other rights that might be claimed to
 363    pertain to the implementation or use of the technology described in
 364    this document or the extent to which any license under such rights
 365    might or might not be available; nor does it represent that it has
 366    made any independent effort to identify any such rights.  Information
 367    on the procedures with respect to rights in RFC documents can be
 368    found in BCP 78 and BCP 79.
 369
 370    Copies of IPR disclosures made to the IETF Secretariat and any
 371    assurances of licenses to be made available, or the result of an
 372    attempt made to obtain a general license or permission for the use of
 373    such proprietary rights by implementers or users of this
 374    specification can be obtained from the IETF on-line IPR repository at
 375    http://www.ietf.org/ipr.
 376
 377    The IETF invites any interested party to bring to its attention any
 378    copyrights, patents or patent applications, or other proprietary
 379    rights that may cover technology that may be required to implement
 380    this standard.  Please address the information to the IETF at
 381    ietf-ipr@ietf.org.
 382
 383 Acknowledgement
 384
 385    Funding for the RFC Editor function is currently provided by the
 386    Internet Society.
 387
 388
 389
 390
 391
 392
 393
 394 Salowey & Droms             Standards Track                     [Page 7]
 395 \f