RAP Working Group                                            L-N. Hamer
Internet Draft                                                  B. Gage
                                                               M. Broda
Document: draft-ietf-rap-rsvp-authsession-03.txt        Nortel Networks
                                                            B. Kosinski
                                                  University of Alberta
                                                             Hugh Shieh
                                                          AT&T Wireless
                                                              June 2002

                          Session Authorization for RSVP

Status of this Memo

   This document is an Internet-Draft and is in full conformance with
   all provisions of Section 10 of RFC2026.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF), its areas, and its working groups. Note that
   other groups may also distribute working documents as Internet-
   Drafts. 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."

   The list of current Internet-Drafts can be accessed at
   http://www.ietf.org/ietf/1id-abstracts.txt
   The list of Internet- Draft Shadow Directories can be accessed at
   http://www.ietf.org/shadow.html

   The distribution of this memo is unlimited. This memo is filed as
   <draft-ietf rap-rsvp-authsession-03.txt>, and expires November,
   2002. Please send comments to the authors.

Copyright Notice

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

Abstract

   This document describes the representation of session authorization
   information in the POLICY_DATA object (RFC 2750) for supporting
   policy-based per-session authorization and admission control in
   RSVP.  The goal of session authorization is to allow the exchange of
   information between network elements in order to authorize the use
   of resources for a service and to co-ordinate actions between the
   signaling and transport planes.  This document describes how a
   process on a system authorizes the reservation of resources by a
   host and then provides that host with a session authorization policy
   element which can be inserted into the RSVP PATH message to
   facilitate proper and secure reservation of those resources within
   the network. We describe the encoding of media authorization
   information as RSVP policy elements and provide details relating to
   operations, processing rules and error scenarios.


Internet Draft         Session Authorization for RSVP          June 2002



   Contents

   Status of this Memo................................................1
   Copyright Notice...................................................1
   Abstract...........................................................1
   1. Conventions used in this document...............................3
   2. Introduction....................................................3
   3. Policy Element for Session Authorization Data...................4
   3.1 Policy Data Object Format......................................4
   3.2 Session Authorization Data Policy Element......................4
   3.3 Session Authorization Attributes...............................4
   3.3.1 Authorizing Entity Identifier................................6
   3.3.2 Session Identifier...........................................7
   3.3.3 Source Address...............................................7
   3.3.4 Destination Address..........................................9
   3.3.5 Start time..................................................10
   3.3.6 End time....................................................11
   3.3.7 Resources Authorized........................................11
   3.3.8 Authentication data.........................................12
   4. Integrity of the AUTH_SESSION policy element...................13
   4.1 Shared private keys...........................................13
   4.1.1 Operational Setting using shared private keys...............13
   4.2 Kerberos......................................................14
   4.2.1. Operational Setting using Kerberos.........................14
   4.3 Public Key....................................................15
   4.3.1. Operational Setting for public key based authentication....15
   5. Framework......................................................16
   5.1 The coupled model.............................................16
   5.2 The associated model with one policy server...................16
   5.3 The associated model with two policy servers..................17
   5.4 The non-associated model......................................17
   6. Message Processing Rules.......................................17
   6.1 Message Generation (RSVP Host)................................17
   6.2 Message Reception (Router)....................................18
   6.3 Authorization (Router/PDP)....................................18
   7. Error Signaling................................................18
   8. IANA Considerations............................................19
   9. Security Considerations........................................20
   10. Acknowledgments...............................................21
   11. Normative References..........................................21
   12. Informative References........................................23
   13. Author Information............................................23
   14. Full Copyright Statement......................................24
   15. Notices.......................................................24
   16. RFC Editor Considerations.....................................25



Internet Draft         Session Authorization for RSVP          June 2002


1. Conventions used in this document

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED",  "MAY", and "OPTIONAL" in
   this document are to be interpreted as described in [RFC-2119].

2. Introduction

   RSVP [RFC-2205] is a resource reservation setup protocol designed
   for an integrated services [RFC-1633] or Integrated Services over
   Diffserv networks [RFC-2998]. The RSVP protocol is used by a host to
   request specific services from the network for particular
   application data streams or flows.  RSVP is also used to deliver
   quality-of-service (QoS) requests to all routers along the path(s)
   of the flows and to establish and maintain state to provide the
   requested quality of service.  RSVP requests will generally result
   in resources being reserved in each router along the data path.
   RSVP allows users to obtain preferential access to network
   resources, under the control of an admission control mechanism.
   Such admission control is often based on user or application
   identity [RFC-3182], however, it is also valuable to provide the
   ability for per-session admission control.

   In order to allow for per-session admission control, it is necessary
   to provide a mechanism for ensuring use of resources by a host has
   been properly authorized before allowing the reservation of those
   resources.  In order to meet this requirement, there must be
   information in the RSVP message which may be used to verify the
   validity of the RSVP request.  This can be done by providing the
   host with a token upon authorization which is inserted into the RSVP
   PATH message and verified by the network.

   This document describes the session authorization element
   (AUTH_SESSION) contained in the POLICY_DATA object.  The user
   process must obtain an AUTH_SESSION object from an authorizing
   entity, which it then passes to the RSVP process (service) on the
   originating host.  The RSVP service then inserts the AUTH_SESSION
   object into the RSVP PATH message to allow verification of the
   network resource request. Network elements verify the request and
   then process the RSVP message based on admission policy.

   [S-AUTH] describes a framework in which a session authorization
   policy element may be utilized to contain information relevant to
   the network's decision to grant a reservation request.










Internet Draft         Session Authorization for RSVP          June 2002


3. Policy Element for Session Authorization Data

3.1 Policy Data Object Format

   POLICY_DATA objects contain policy information and are carried by
   RSVP messages. A detailed description of the format of POLICY_DATA
   object can be found in "RSVP Extensions for Policy Control" [RFC-
   2750].

3.2 Session Authorization Data Policy Element

   In this section we describe a policy element (PE) called session
   authorization data (AUTH_SESSION).  The AUTH_SESSION policy element
   contains a list of fields which describe the session, along with
   other attributes.

          +-------------+-------------+-------------+-------------+
          | Length                    | P-Type = AUTH_SESSION     |
          +-------------+-------------+-------------+-------------+
          // Session Authorization Attribute List                //
          +-------------------------------------------------------+

   Length: 16 bits
      The length of the policy element (including the Length and
      P-Type) is in number of octets (MUST be in multiples of 4) and
      indicates the end of the session authorization information block.

   P-Type: 16 bits (Session Authorization Type)
      AUTH_SESSION = TBD-by-IANA
      The Policy element type (P-type) of this element.  The
      Internet Assigned Numbers Authority (IANA) acts as a registry
      for policy element types for identity as described in
      [RFC-2750].

   Session Authorization Attribute List: variable length
      The session authorization attribute list is a collection of
      objects which describes the session and provides other
      information necessary to verify the RSVP request. An initial set
      of valid objects is described in Section 3.

3.3 Session Authorization Attributes

   A session authorization attribute may contain a variety of
   information and has both an attribute type and subtype.  The
   attribute itself MUST be a multiple of 4 octets in length, and any
   attributes that are not a multiple of 4 octets long MUST be padded
   to a 4-octet boundary. All padding bytes MUST have a value of zero.







Internet Draft         Session Authorization for RSVP          June 2002


      +--------+--------+--------+--------+
      | Length          | S-Type |SubType |
      +--------+--------+--------+--------+
      | Value ...
      +--------+--------+--------+--------+


   Length: 16 bits
        The length field is two octets and indicates the actual length
        of the attribute (including Length, S-Type and SubType fields)
        in number of octets.  The length does NOT include any bytes
        padding to the value field to make the attribute a multiple of
        4 octets long.

   S-Type: 8 bits
        Session authorization attribute type (S-Type) field is one
        octet.  IANA acts as a registry for S-Types as described
        in section 7, IANA Considerations.  Initially, the registry
        contains the following S-Types:

        1  AUTH_ENT_ID          The unique identifier of the entity
                                which authorized the session.

        2  SESSION_ID           Unique identifier for this session.

        3  SOURCE_ADDR          Address specification for the
                                session originator.

        4  DEST_ADDR            Address specification for the
                                session end-point.

        5  START_TIME           The starting time for the session.

        6  END_TIME             The end time for the session.

        7  RESOURCES            The resources which the user is
                                authorized to request.

        8  AUTHENTICATION_DATA  Authentication data of the session
                                authorization policy element.

   SubType: 8 bits
        Session authorization attribute sub-type is one octet in
        length.  The value of the SubType depends on the S-Type.

   Value: variable length
        The attribute specific information.







Internet Draft         Session Authorization for RSVP          June 2002


3.3.1 Authorizing Entity Identifier

   AUTH_ENT_ID is used to identify the entity which authorized the
   initial service request and generated the session authorization
   policy element.  The AUTH_ENT_ID may be represented in various
   formats, and the SubType is used to define the format for the ID.
   The format for AUTH_ENT_ID is as follows:

      +-------+-------+-------+-------+
      | Length        |S-Type |SubType|
      +-------+-------+-------+-------+
      | OctetString ...
      +-------+-------+-------+-------+

   Length
      Length of the attribute, which MUST be > 4.

   S-Type
      AUTH_ENT_ID

   SubType
      The following sub-types for AUTH_ENT_ID are defined.  IANA
      acts as a registry for AUTH_ENT_ID sub-types as described
      in section 7, IANA Considerations.  Initially, the registry
      contains the following sub-types of AUTH_ENT_ID:

      1  IPV4_ADDRESS        IPv4 address represented in 32 bits

      2  IPV6_ADDRESS        IPv6 address represented in 128 bits

      3  FQDN                Fully Qualified Domain Name as defined
                             in RFC-1034 as an ASCII string.

      4  ASCII_DN            X.500 Distinguished name as defined
                             in RFC-2253 as an ASCII string.

      5  UNICODE_DN          X.500 Distinguished name as defined
                             in RFC-2253 as a UNICODE string.

      6  URI                 Universal Resource Identifier, as
                             defined in RFC-2396.

      7  KRB_PRINCIPAL      Fully Qualified Kerberos Principal name
                            represented by the ASCII string of a
                            principal followed by the @ realm name as
                            defined in RFC-1510 (e.g.
                            principalX@realmY).

      8  X509_V3_CERT        A chain of authorizing entity's X.509 V3
                             digital certificates.




Internet Draft         Session Authorization for RSVP          June 2002


      9  PGP_CERT            The PGP digital certificate of the
                             authorizing entity.


   OctetString
      Contains the authorizing entity identifier.

3.3.2 Session Identifier

   SESSION_ID is a unique identifier used by the authorizing entity to
   identify the request.  It may be used for a number of purposes,
   including replay detection, or to correlate this request to a policy
   decision entry made by the authorizing entity. For example, the
   SESSION_ID can be based on simple sequence number or on a standard
   NTP timestamp.

      +-------+-------+-------+-------+
      | Length        |S-Type |SubType|
      +-------+-------+-------+-------+
      | OctetString ...
      +-------+-------+-------+-------+

   Length
      Length of the attribute, which MUST be > 4.


   S-Type
      SESSION_ID

   SubType
      No subtypes for SESSION ID are currently defined; this field MUST
   be set to zero. The authorizing entity is the only network entity
   that needs to interpret the contents of the SESSION ID therefore the
   contents and format are implementation dependent.

   OctetString
      Contains the session identifier.

3.3.3 Source Address

   SOURCE_ADDR is used to identify the source address specification of
   the authorized session. This S-Type may be useful in some scenarios
   to make sure the resource request has been authorized for that
   particular source address and/or port.

      +-------+-------+-------+-------+
      | Length        |S-Type |SubType|
      +-------+-------+-------+-------+
      | OctetString ...
      +-------+-------+-------+-------+




Internet Draft         Session Authorization for RSVP          June 2002


   Length
      Length of the attribute, which MUST be > 4.

   S-Type
      SOURCE_ADDR

   SubType
      The following sub types for SOURCE_ADDR are defined. IANA
      acts as a registry for SOURCE_ADDR sub-types as
      described in section 7, IANA Considerations. Initially, the
      registry contains the following sub types for SOURCE_ADDR:

      1  IPV4_ADDRESS        IPv4 address represented in 32 bits

      2  IPV6_ADDRESS        IPv6 address represented in 128 bits

      3  FQDN                Fully Qualified Domain Name as defined
                             in RFC-1034 as an ASCII string.

      4  ASCII_DN            X.500 Distinguished name as defined
                             in RFC-2253 as an ASCII string.

      5  UNICODE_DN          X.500 Distinguished name as defined
                             in RFC-2253 as a UNICODE string.

      6  UDP_PORT LIST       list of UDP port specifications,
                             represented as 16 bits per list entry.

      7  TCP_PORT LIST       list of TCP port specifications,
                             represented as 16 bits per list entry.

   OctetString
      The OctetString contains the source address information.

   In scenarios where a source address is required (see Section 5), at
   least one of the subtypes 1 through 5 (inclusive) MUST be included
   in every Session Authorization Data Policy Element. Multiple SOURCE
   ADDR attributes MAY be included if multiple addresses have been
   authorized. The source address field of the RSVP datagram MUST match
   one of the SOURCE ADDR attributes contained in this Session
   Authorization Data Policy Element when resolved to an IP address.

   At most, one instance of subtype 6 MAY be included in every Session
   Authorization Data Policy Element. At most, one instance of subtype
   7 MAY be included in every Session Authorization Data Policy
   Element. Inclusion of a subtype 6 attribute does not prevent
   inclusion of a subtype 7 attribute (i.e. both UDP and TCP ports may
   be authorized).

   If no PORT attributes are specified, then all ports are considered
   valid; otherwise, only the specified ports are authorized for use.



Internet Draft         Session Authorization for RSVP          June 2002



   Every source address and port list must be included in a separate
   SOURCE_ADDR attribute.

3.3.4 Destination Address

   DEST_ADDR is used to identify the destination address of the
   authorized session. This S-Type may be useful in some scenarios to
   make sure the resource request has been authorized for that
   particular destination address and/or port.


      +-------+-------+-------+-------+
      | Length        |S-Type |SubType|
      +-------+-------+-------+-------+
      | OctetString ...
      +-------+-------+-------+-------+

   Length
      Length of the attribute, which MUST be > 4.

   S-Type
      DEST_ADDR

   SubType
      The following sub types for DEST_ADDR are defined. IANA
      acts as a registry for DEST_ADDR sub-types as described in
      section 7, IANA Considerations. Initially, the registry
      contains the following sub types for DEST_ADDR:

      1  IPV4_ADDRESS        IPv4 address represented in 32 bits

      2  IPV6_ADDRESS        IPv6 address represented in 128 bits

      3  FQDN                Fully Qualified Domain Name as defined
                             in RFC-1034 as an ASCII string.

      4  ASCII_DN            X.500 Distinguished name as defined
                             in RFC-2253 as an ASCII string.

      5  UNICODE_DN          X.500 Distinguished name as defined
                             in RFC-2253 as a UNICODE string.

      6  UDP_PORT LIST       list of UDP port specifications,
                             represented as 16 bits per list entry.

      7  TCP_PORT LIST       list of TCP port specifications,
                             represented as 16 bits per list entry.

   OctetString
      The OctetString contains the destination address specification.



Internet Draft         Session Authorization for RSVP          June 2002



   In scenarios where a destination address is required (see Section
   5), at least one of the subtypes 1 through 5 (inclusive) MUST be
   included in every Session Authorization Data Policy Element.
   Multiple DEST ADDR attributes MAY be included if multiple addresses
   have been authorized. The destination address field of the RSVP
   datagram MUST match one of the DEST ADDR attributes contained in
   this Session Authorization Data Policy Element when resolved to an
   IP address.

   At most, one instance of subtype 6 MAY be included in every Session
   Authorization Data Policy Element. At most, one instance of subtype
   7 MAY be included in every Session Authorization Data Policy
   Element. Inclusion of a subtype 6 attribute does not prevent
   inclusion of a subtype 7 attribute (i.e. both UDP and TCP ports may
   be authorized).

   If no PORT attributes are specified, then all ports are considered
   valid; otherwise, only the specified ports are authorized for use.

   Every destination address and port list must be included in a
   separate DEST_ADDR attribute.


3.3.5 Start time

   START_TIME is used to identify the start time of the authorized
   Session and can be used to prevent replay attacks. If the
   AUTH_SESSION policy element is presented in a resource request, the
   network SHOULD reject the request if it is not received within a few
   seconds of the start time specified.

      +-------+-------+-------+-------+
      | Length        |S-Type |SubType|
      +-------+-------+-------+-------+
      | OctetString ...
      +-------+-------+-------+-------+

   Length
      Length of the attribute, which MUST be > 4.

   S-Type
      START_TIME

   SubType
      The following sub types for START_TIME are defined. IANA
      acts as a registry for START_TIME sub-types as described in
      section 7, IANA Considerations. Initially, the registry
      contains the following sub types for START_TIME:
      1  NTP_TIMESTAMP        NTP Timestamp Format as defined in
                              RFC-1305.



Internet Draft         Session Authorization for RSVP          June 2002



   OctetString
      The OctetString contains the start time.

3.3.6 End time

   END_TIME is used to identify the end time of the authorized
   session and can be used to limit the amount of time that resources
   are authorized for use (e.g. in prepaid session scenarios).

      +-------+-------+-------+-------+
      | Length        |S-Type |SubType|
      +-------+-------+-------+-------+
      | OctetString ...
      +-------+-------+-------+-------+

   Length
      Length of the attribute, which MUST be > 4.

   S-Type
      END_TIME

   SubType
      The following sub types for END_TIME are defined. IANA
      acts as a registry for END_TIME sub-types as described in
      section 7, IANA Considerations. Initially, the registry
      contains the following sub types for END_TIME:

      1  NTP_TIMESTAMP        NTP Timestamp Format as defined in
                              RFC-1305.

   OctetString
      The OctetString contains the end time.

3.3.7 Resources Authorized

   RESOURCES is used to define the characteristics of the authorized
   session. This S-Type may be useful in some scenarios to specify the
   specific resources authorized to ensure the request fits the
   authorized specifications.

      +-------+-------+-------+-------+
      | Length        |S-Type |SubType|
      +-------+-------+-------+-------+
      | OctetString ...
      +-------+-------+-------+-------+

   Length
      Length of the attribute, which MUST be > 4.

   S-Type



Internet Draft         Session Authorization for RSVP          June 2002


      RESOURCES

   SubType
      The following sub-types for RESOURCES are defined. IANA
      acts as a registry for RESOURCES sub-types as described in
      section 7, IANA Considerations. Initially, the registry
      contains the following sub types for RESOURCES:

      1  BANDWIDTH     Maximum bandwidth (kbps) authorized.

      2  FLOW_SPEC     Flow spec specification as defined in
                       RFC-2205.

      3  SDP           SDP Media Descriptor as defined in
                       RFC-2327.

      4  DSCP          Differentiated services codepoint as
                       defined in RFC-2474.

   OctetString
      The OctetString contains the resources specification.

   In scenarios where a resource specification is required (see Section
   5), at least one of the subtypes 1 through 4 (inclusive) MUST be
   included in every Session Authorization Data Policy Element.
   Multiple RESOURCE attributes MAY be included if multiple types of
   resources have been authorized (e.g. DSCP and BANDWIDTH).


3.3.8 Authentication data

   The AUTHENTICATION_DATA attribute contains the authentication data
   of the AUTH_SESSION policy element and signs all the data in the
   policy element up to the AUTHENTICATION_DATA.  If the
   AUTHENTICATION_DATA attribute has been included in the AUTH_SESSION
   policy element, it MUST be the last attribute in the list. The
   algorithm used to compute the authentication data depends on the
   AUTH_ENT_ID SubType field. See Section 4 entitled Integrity of the
   AUTH_SESSION policy element.

   A summary of AUTHENTICATION_DATA attribute format is described
   below.


      +-------+-------+-------+-------+
      | Length        |S-Type |SubType|
      +-------+-------+-------+-------+
      | OctetString ...
      +-------+-------+-------+-------+

   Length



Internet Draft         Session Authorization for RSVP          June 2002


      Length of the attribute, which MUST be > 4.

   S-Type
      AUTHENTICATION_DATA

   SubType
      No sub types for AUTHENTICATION_DATA are currently defined.  This
      field MUST be set to 0.

   OctetString
      OctetString contains the authentication data of the AUTH_SESSION.


4. Integrity of the AUTH_SESSION policy element

   This section describes how to ensure the integrity of the policy
   element is preserved.

4.1 Shared private keys

      In shared private key environments, the AUTH_ENT_ID MUST be of
   subtypes: IPV4_ADDR, IPV6_ADDR, FQDN, ASCII_DN, UNICODE_DN or URI.
   An example AUTH_SESSION policy element is shown below.

      +--------------+--------------+--------------+--------------+
      | Length                      | P-type = AUTH_SESSION       |
      +--------------+--------------+--------------+--------------+
      | Length                      |SESSION_ID    |     zero     |
      +--------------+--------------+--------------+--------------+
      | OctetString (The session identifier) ...
      +--------------+--------------+--------------+--------------+
      | Length                      |AUTH DATA.    |     zero     |
      +--------------+--------------+--------------+--------------+
      | OctetString (Authentication data) ...
      +--------------+--------------+--------------+--------------+

4.1.1 Operational Setting using shared private keys

   This assumes both the Authorizing Entity and the Network router/PDP
   are provisioned with shared private keys and with policies detailing
   which algorithm to be used for computing the authentication data.

   Key maintenance is outside the scope of this document, but
   AUTH_SESSION implementations MUST at least provide the ability to
   manually configure keys and their parameters locally. The key used
   to produce the authentication data is identified by the AUTH_ENT_ID
   field. Each key must also be configured with lifetime parameters for
   the time period within which it is valid as well as an associated
   cryptographic algorithm parameter specifying the algorithm to be
   used with the key. At a minimum, all AUTH_SESSION implementations




Internet Draft         Session Authorization for RSVP          June 2002


   MUST support the HMAC-MD5-96 [RFC-2104][FRC-1321] cryptographic
   algorithm for computing the authentication data.

   It is good practice to regularly change keys. Keys MUST be
   configurable such that their lifetimes overlap allowing smooth
   transitions between keys. At the midpoint of the lifetime overlap
   between two keys, senders should transition from using the current
   key to the next/longer-lived key. Meanwhile, receivers simply accept
   any identified key received within its configured lifetime and
   reject those that are not.


4.2 Kerberos

   In a Kerberos environment, the AUTH_ENT_ID MUST be of the subtype
   KRB_PRINCIPAL. Kerberos [RFC 1510] authentication uses a trusted
   third party (the Kerberos Distribution Center - KDC) to provide for
   authentication of the AUTH_SESSION to a network server.  It is
   assumed that a KDC is present and both host and verifier of
   authentication information (authorizing entity and router/PDP)
   implement Kerberos authentication.

   An example of the Kerberos AUTH_DATA policy element is shown below.

      +--------------+--------------+--------------+--------------+
      | Length                      | P-type = AUTH_SESSION       |
      +--------------+--------------+--------------+--------------+
      | Length                      |SESSION_ID    |     zero     |
      +--------------+--------------+--------------+--------------+
      | OctetString (The session identifier) ...
      +--------------+--------------+--------------+--------------+
      | Length                      | AUTH_ENT_ID  | KERB_P.      |
      +--------------+--------------+--------------+--------------+
      | OctetString (The principal@realm name) ...
      +--------------+--------------+--------------+--------------+

4.2.1. Operational Setting using Kerberos

      An authorizing entity is configured to construct the AUTH_SESSION
   policy element that designates use of the Kerberos authentication
   method (KRB_PRINCIPAL).  Upon reception of the RSVP request, the
   router/PDP contacts the local KDC to request a ticket for the
   authorizing entity (principal@realm). The router/PDP uses the ticket
   to access the authorizing entity and obtain authentication data for
   the message.

   For cases where the authorizing entity is in a different realm (i.e.
   administrative domain, organizational boundary), the router/PDP
   needs to fetch a cross-realm Ticket Granting Ticket (TGT) from its
   local KDC. This TGT can be used to fetch authorizing entity tickets




Internet Draft         Session Authorization for RSVP          June 2002


   from the KDC in the remote realm. Note that for performance
   considerations, tickets are typically cached for extended periods.


4.3 Public Key

      In a public key environment, the AUTH_ENT_ID MUST be of the
   subtypes: X509_V3_CERT or PGP_CERT. The authentication data is used
   for authenticating the authorizing entity.  An example of the public
   key AUTH_SESSION policy element is shown below.

      +--------------+--------------+--------------+--------------+
      | Length                      | P-type = AUTH_SESSION       |
      +--------------+--------------+--------------+--------------+
      | Length                      |SESSION_ID    |     zero     |
      +--------------+--------------+--------------+--------------+
      | OctetString (The session identifier) ...
      +--------------+--------------+--------------+--------------+
      | Length                      | AUTH_ENT_ID  |   PGP_CERT   |
      +--------------+--------------+--------------+--------------+
      | OctetString (Authorizing entity Digital Certificate) ...
      +--------------+--------------+--------------+--------------+
      | Length                      |AUTH DATA.    |     zero     |
      +--------------+--------------+--------------+--------------+
      | OctetString (Authentication data) ...
      +--------------+--------------+--------------+--------------+

4.3.1. Operational Setting for public key based authentication

      Public key based authentication assumes following:

         -  Authorizing entities have a pair of keys (private key and
            public key).

         -  Private key is secured with the authorizing entity.

         -  Public keys are stored in digital certificates and a
            trusted party, certificate authority (CA) issues these
            digital certificates.

         -  The verifier (PDP or router) has the ability to verify the
            digital certificate.


   Authorizing entity uses its private key to generate
   AUTHENTICATION_DATA. Authenticators (router, PDP) use the
   authorizing entity's public key (stored in the digital certificate)
   to verify and authenticate the policy element.






Internet Draft         Session Authorization for RSVP          June 2002


5. Framework

   [S-AUTH] describes a framework in which the AUTH_SESSION
   policy element may be utilized to transport information required for
   authorizing resource reservation for media flows. [S-AUTH]
   introduces 4 different models:
   1- the coupled model
   2- the associated model with one policy server
   3- the associated model with two policy servers
   4- the non-associated model.

   The fields that are required in an AUTH SESSION policy element is
   dependent on which of the models is used.

5.1 The coupled model

   In the Coupled Model, the only information that MUST be included in
   the policy element is the SESSION ID; it is used by the Authorizing
   Entity to correlate the resource reservation request with the media
   authorized during session set up. Since the End Host is assumed to
   be untrusted, the Policy Server SHOULD take measures to ensure that
   the integrity of the SESSION ID is preserved in transit; the exact
   mechanisms to be used and the format of the SESSION ID are
   implementation dependent.



5.2 The associated model with one policy server

   In this model, the contents of the AUTH_SESSION policy element MUST
   include:

   -  A session identifier - SESSION_ID. This is information that the
      authorizing entity can use to correlate the resource reservation
      request with the media authorized during session set up.

   -  The identity of the authorizing entity _ AUTH_ENT_ID. This
      information is used by the Edge Router to determine which
      authorizing entity (Policy Server) should be used to solicit
      resource policy decisions.

   In some environments, an Edge Router may have no means for
   determining if the identity refers to a legitimate Policy Server
   within its domain. In order to protect against redirection of
   authorization requests to a bogus authorizing entity, the
   AUTH_SESSION MUST also include:

   -  AUTHENTICATION_DATA. This authentication data is calculated over
      all other fields of the AUTH_SESSION policy element.





Internet Draft         Session Authorization for RSVP          June 2002


5.3 The associated model with two policy servers

   The content of the AUTH_SESSION Policy Element is identical to the
   associated model with one policy server.

5.4 The non-associated model

   In this model, the AUTH_SESSION MUST contain sufficient information
   to allow the Policy Server to make resource policy decisions
   autonomously from the authorizing entity. The policy element is
   created using information about the session by the authorizing
   entity. The information in the AUTH_SESSION policy element MUST
   include:

   -  Calling party IP address or Identity (e.g. FQDN) - SOURCE_ADDR S-
      TYPE
   -  Called party IP address or Identity (e.g. FQDN) - DEST_ADDR S-
      TYPE
   -  The characteristics of (each of) the media stream(s) authorized
      for this session - RESOURCES S-TYPE
   -  The authorization lifetime - START_TIME S-TYPE
   -  The identity of the authorizing entity to allow for validation of
      the token in shared private key and Kerberos schemes -
      AUTH_ENT_ID S-TYPE
   -  The credentials of the authorizing entity in a public-key scheme
      - AUTH_ENT_ID S-TYPE
   -  Authentication data used to prevent tampering with the
      AUTH_SESSION policy element - AUTHENTICATION_DATA

   Furthermore, the AUTH_SESSION policy element MAY contain:

   -  The lifetime of (each of) the media stream(s) - END_TIME S-TYPE
   -  Calling party port number - SOURCE_ADDR S-TYPE
   -  Called party port number - DEST_ADDR S-TYPE

   All AUTH_SESSION fields MUST match with the resource request. If a
   field does not match, the request SHOULD be denied.


6. Message Processing Rules

6.1 Message Generation (RSVP Host)

   An RSVP message is created as specified in [RFC-2205] with following
   modifications.

   1. RSVP message MUST contain at most one AUTH_SESSION policy
   element.

   2. A Session Authorization policy element (AUTH_SESSION) is created
   and the IdentityType field is set to indicate the identity type



Internet Draft         Session Authorization for RSVP          June 2002


   in the policy element. Only the required Session Authorization
   attributes are added.

   3. POLICY_DATA object (containing the AUTH_SESSION policy element)
   is inserted in the RSVP message in the appropriate place.

6.2 Message Reception (Router)

   RSVP message is processed as specified in [RFC-2205] with following
   modifications.

   1. If router is policy aware then it SHOULD send the RSVP
   message to the PDP and wait for response. If the router is
   policy unaware then it ignores the policy data objects and
   continues processing the RSVP message.

   2. Reject the message if the response from the PDP is negative.

   3. Continue processing the RSVP message.

6.3 Authorization (Router/PDP)

   1. Retrieve the AUTH_SESSION policy element. Check the PE type
   field and return an error if the identity type is not supported.

   2. Verify the message integrity.

   - Shared private key authentication: Get authorizing entity ID,
     identify appropriate algorithm and shared private key for the
     authorizing entity, and validate signature.

   - Public Key: Validate the certificate chain against
     trusted Certificate Authority (CA) and validate the
     message signature using the public key.

   - Kerberos Ticket: If the AUTH_ENT_ID is of subtype KRB_PRINCIPAL,
     Request a ticket for the authorizing entity (principal@realm)
     from the local KDC. Use the ticket to access the authorizing
     entity and obtain authentication data for the message.

   3. Verify the requested resources do not exceed the authorized QoS.


7. Error Signaling

   If a PDP fails to verify the AUTH_SESSION policy element then it
   MUST return a policy control failure (Error Code = 02) to the PEP.
   The error values are described in [RFC-2205] and [RFC-2750]. Also
   the PDP SHOULD supply a policy data object containing an AUTH_DATA
   Policy Element with A-Type=POLICY_ERROR_CODE containing more
   details on the Policy Control failure [RFC-3182]. The PEP



Internet Draft         Session Authorization for RSVP          June 2002


   MUST include this Policy Data object in the outgoing RSVP Error
   message.

8. IANA Considerations

   Following the policies outlined in [IANA-CONSIDERATIONS], Standard
   RSVP Policy Elements (P-type values) are assigned by IETF Consensus
   action as described in [RFC-2750].

   P-Type AUTH_SESSION is assigned the value TBD-by-IANA.

   Following the policies outlined in [IANA-CONSIDERATIONS], session
   authorization attribute types (S-Type)in the range 0-127 are
   allocated through an IETF Consensus action; S-Type values between
   128-255 are reserved for Private Use and are not assigned by IANA.

   S-Type AUTH_ENT_ID is assigned the value 1.
   S-Type SESSION_ID is assigned the value 2.
   S-Type SOURCE_ADDR is assigned the value 3.
   S-Type DEST_ADDR is assigned the value 4.
   S-Type START_TIME is assigned the value 5.
   S-Type END_TIME is assigned the value 6.
   S-Type RESOURCES is assigned the value 7.
   S-Type AUTHENTICATION_DATA is assigned the value 8.

   Following the policies outlined in [IANA-CONSIDERATIONS],
   AUTH_ENT_ID SubType values in the range 0-127 are allocated through
   an IETF Consensus action, SubType values between 128-255 are
   reserved for Private Use and are not assigned by IANA.

   AUTH_ENT_ID SubType IPV4_ADDRESS is assigned the value 1.
   SubType IPV6_ADDRESS is assigned the value 2.
   SubType FQDN is assigned the value 3.
   SubType ASCII_DN is assigned the value 4.
   SubType UNICODE_DN is assigned the value 5.
   SubType URI is assigned the value 6.
   SubType KRB_PRINCIPAL is assigned the value 7.
   SubType X509_V3_CERT is assigned the value 8.
   SubType PGP_CERT is assigned the value 9.

   Following the policies outlined in [IANA-CONSIDERATIONS],
   SOURCE_ADDR SubType values in the range 0-127 are allocated through
   an IETF Consensus action, SubType values between 128-255 are
   reserved for Private Use and are not assigned by IANA.

   SOURCE_ADDR SubType IPV4_ADDRESS is assigned the value 1.
   SubType IPV6_ADDRESS is assigned the value 2.
   SubType FQDN is assigned the value 3.
   SubType ASCII_DN is assigned the value 4.
   SubType UNICODE_DN is assigned the value 5.
   SubType UDP_PORT_LIST is assigned the value 6.



Internet Draft         Session Authorization for RSVP          June 2002


   SubType TCP_PORT_LIST is assigned the value 7.

   Following the policies outlined in [IANA-CONSIDERATIONS],
   DEST_ADDR SubType values in the range 0-127 are allocated through an
   IETF Consensus action, SubType values between 128-255 are reserved
   for Private Use and are not assigned by IANA.

   DEST_ADDR SubType IPV4_ADDRESS is assigned the value 1.
   SubType IPV6_ADDRESS is assigned the value 2.
   SubType FQDN is assigned the value 3.
   SubType ASCII_DN is assigned the value 4.
   SubType UNICODE_DN is assigned the value 5.
   SubType UDP_PORT_LIST is assigned the value 6.
   SubType TCP_PORT_LIST is assigned the value 7.

   Following the policies outlined in [IANA-CONSIDERATIONS],
   START_TIME SubType values in the range 0-127 are allocated through
   an IETF Consensus action, SubType values between 128-255 are
   reserved for Private Use and are not assigned by IANA.

   START_TIME SubType NTP_TIMESTAMP is assigned the value 1.


   Following the policies outlined in [IANA-CONSIDERATIONS],
   END TIME SubType values in the range 0-127 are allocated through an
   IETF Consensus action, SubType values between 128-255 are reserved
   for Private Use and are not assigned by IANA.

   END TIME SubType NTP_TIMESTAMP is assigned the value 1.


   Following the policies outlined in [IANA-CONSIDERATIONS],
   RESOURCES SubType values in the range 0-127 are allocated through an
   IETF Consensus action, SubType values between 128-255 are reserved
   for Private Use and are not assigned by IANA.

   RESOURCES SubType BANDWIDTH is assigned the value 1.
   SubType FLOW_SPEC is assigned the value 2.
   SubType SDP is assigned the value 3.
   SubType DSCP is assigned the value 4.


9. Security Considerations

   The purpose of this draft is to describe a mechanism for session
   authorization to prevent theft of service.

   Replay attacks MUST be prevented. In the non-associated model, the
   AUTH_SESSION policy element MUST include a START_TIME field. The
   start time is used to verify that the request is not being replayed
   at a later time. In all other models, the SESSION_ID is used by the



Internet Draft         Session Authorization for RSVP          June 2002


   Policy Server to ensure that the resource request successfully
   correlates with records of an authorized session. If a AUTH_SESSION
   is replayed, it MUST be detected by the policy server (using
   internal algorithms) and the request MUST be rejected.

   To ensure that the integrity of the policy element is preserved in
   untrusted environments, the AUTHENTICATION_DATA attribute MUST be
   included.

   In order to keep the AUTH_SESSION policy element size to a strict
   minimum, in environments where shared private keys are possible,
   they should be used. This is especially true in wireless
   environments where the AUTH_SESSION policy element is sent over-the-
   air. The shared private keys authentication option MUST be supported
   by all AUTH_SESSION implementations.

   If shared private keys are not a valid option, the Kerberos
   authentication mechanism is reasonably well secured and efficient in
   terms of AUTH_SESSION size. The AUTH_SESSION only needs to contain
   the principal@realm name of the authorizing entity. This is much
   more efficient than the PKI authentication option.

   PKI authentication option provides a high level of security and good
   scalability, however it requires the presence of credentials in the
   AUTH_SESSION policy element which impacts its size.

10. Acknowledgments

   We would like to thank Louis LeVay, Francois Audet, Don Wade, Hamid
   Syed, Kwok Ho Chan and many others for their valuable comments.

   In addition, we would like to thank S. Yadav, et al, for their
   efforts on RFC 3182, as this document borrows from their work.


11. Normative References


    [S-AUTH]              Hamer, L.-N., Gage, B., Shieh, H., "Framework
                          for session setup with media authorization",
                          Internet-Draft,
                          draft-ietf-rap-session-auth-04.txt,
                          June 2002.

    [ASCII]               Coded Character Set -- 7-Bit    American
                          Standard Code for Information Interchange,
                          ANSI X3.4-1986.

    [RFC-2750]             Herzog, S., "RSVP Extensions for Policy
                          Control", RFC 2750, January 2000.




Internet Draft         Session Authorization for RSVP          June 2002


    [RFC-2753]           Yavatkar, R., Pendarakis, D. and R. Guerin, "A
                          Framework for Policy-based Admission Control
                          RSVP", RFC 2753, January 2000.

    [RFC-1034]           Mockapetris, P.V., "Domain names - concepts
                         and facilities", RFC 1034, November 1987.

    [RFC-1305]            Mills, David L., "Network Time Protocol
                         (Version 3) Specification, Implementation, and
                          Analysis", RFC 1305, March 1992.

    [RFC-1321]            Rivest, R., "The MD5 Message-Digest
                          Algorithm",RFC 1321, April 1992.

    [RFC-1510]            Kohl, J. and C. Neuman, "The Kerberos Network
                          Authentication Service (V5)", RFC 1510,
                          September 1993.

    [RFC-2104]            Krawczyk, H., Bellare, M. and R. Canetti,
                          "HMAC: Keyed-Hashing for Message
                          Authentication", RFC 2104, February 1997.

    [RFC-2253]            Wahl, M. et al., "UTF-8 String
                          Representation of Distinguished Names",
                          RFC 2253, December 1997.

    [RFC-2205]            Braden, R., Zhang, L., Berson, S., Herzog, S.
                          and S. Jamin, "Resource ReSerVation Protocol
                          (RSVP) - Version 1 Functional Specification",
                           RFC 2205, September 1997.

    [RFC-2209]            Braden, R. and L. Zhang, "Resource
                          ReSerVation Protocol (RSVP) - Version 1
                          Message Processing Rules", RFC 2209,
                          September 1997.

    [RFC-2327]            Handley, M., Jacobson, V., "SDP: Session
                          Description Protocol", RFC 2327, October
                          1998.

    [RFC-2396]            Berners-Lee, T., Fielding, R., Irvine, U.C.,
                          Masinter, L., "Uniform Resource Identifiers
                          (URI): Generic Syntax", RFC 2396, August
                          1998.

    [RFC-2474]            Nichols, K., Blake, S., Baker, F., Black, D.,
                          "Definition of the Differentiated Services
                          Field (DS Field) in the IPv4 and IPv6
                          Headers", RFC 2474, December 1998.





Internet Draft         Session Authorization for RSVP          June 2002


    [UNICODE]             The Unicode Consortium, "The Unicode
                          Standard,Version 2.0", Addison-Wesley,
                          Reading, MA, 1996.

    [X.509]               Housley, R., Ford, W., Polk, W. and D. Solo,
                          "Internet X.509 Public Key Infrastructure
                          Certificate and CRL Profile", RFC 2459,
                          January 1999.

    [X.509-ITU]           ITU-T (formerly CCITT) Information technology
                          Open Systems Interconnection - The Directory:
                          Authentication Framework Recommendation X.509
                          ISO/IEC 9594-8

12. Informative References

   [RFC-3182]            S. Yadav et al, "Identity Representation for
                         RSVP", RFC 3182, October 2001

   [RFC-2998]            Bernet, Y., Ford, P., Yavatkar, R.,
                         Baker, F.,Zhang, L., Speer, M., Braden, R.,
                         Davie, B., Wroclawski, J., Felstaine, E., "A
                         Framework for Integrated Services Operation
                         over Diffserv Networks", RFC 2998, November
                         2000.

   [RFC-1633]            Braden, R., Clark, D., Shenker, S.,
                         "Integrated Services in the Internet
                         Architecture: An Overview", RFC 1633,
                         June 1994.

   [IANA-CONSIDERATIONS] Alvestrand, H. and T. Narten, "Guidelines for
                         Writing an IANA Considerations Section in
                         RFCs", BCP 26, RFC 2434, October 1998.

13. Author Information

      Louis-Nicolas Hamer
      Nortel Networks
      PO Box 3511 Station C
      Ottawa, Ontario
      Canada K1Y 4H7
      Phone: +1 613.768.3409
      EMail: nhamer@nortelnetworks.com

      Brett Kosinski
      University of Alberta
      Edmonton, Alberta
      Canada T6G 2M7
      EMail: kosinski@cs.ualberta.ca




Internet Draft         Session Authorization for RSVP          June 2002


      Bill Gage
      Nortel Networks
      PO Box 3511 Station C
      Ottawa, Ontario
      Canada K1Y 4H7
      Phone: +1 613.763.4400
      EMail: gageb@nortelnetworks.com

      Matt Broda
      Nortel Networks
      PO Box 3511 Station C
      Ottawa, Ontario
      Canada K1Y 4H7
      Phone: +1 613.763.7399
      EMail: mbroda@nortelnetworks.com

      Hugh Shieh
      AT&T Wireless
      7277 164th Avenue NE
      Redmond, WA
      USA 98073-9761
      Phone: +1 425.580.6898
      Email: hugh.shieh@attws.com


14. Full Copyright Statement


   Copyright (C) The Internet Society (2002). All Rights Reserved. This
   document and translations of it may be copied and furnished to
   others, and derivative works that comment on or otherwise explain it
   or assist in its implementation may be prepared, copied, published
   and distributed, in whole or in part, without restriction of any
   kind, provided that the above copyright notice and this paragraph
   are included on all such copies and derivative works. However, this
   document itself may not be modified in any way, such as by removing
   the copyright notice or references to the Internet Society or other
   Internet organisations, except as needed for the purpose of
   developing Internet standards in which case the procedures for
   copyrights defined in the Internet Standards process must be
   followed, or as required to translate it into.

15. Notices

   "The IETF takes no position regarding the validity or scope of
   any intellectual property 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; neither does
   it represent that it has made any effort to identify any such
   rights.  Information on the IETF's procedures with respect to



Internet Draft         Session Authorization for RSVP          June 2002


   rights in standards-track and standards-related documentation
   can be found in BCP-11.  Copies of claims of rights made
   available for publication 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 implementors or users of this
   specification can be obtained from the IETF Secretariat."

   "The IETF invites any interested party to bring to its
   attention any copyrights, patents or patent applications, or
   other proprietary rights which may cover technology that may be
   required to practice this standard.  Please address the
   information to the IETF Executive Director."


16. RFC Editor Considerations

   This document references an IETF Internet-Draft that is in the IESG
   last call stage. Please use the corresponding RFC number prior to
   publishing of this document as a RFC.  The referenced IETF I-D is
   [S-AUTH].