Network Working Group                                         D. Rawlins
Request for Comments: 3483                                      WorldCom
Category: Informational                                      A. Kulkarni
                                                                  Intel
                                                           M. Bokaemper
                                                       Juniper Networks
                                                                K. Chan
                                                        Nortel Networks
                                                             March 2003


 Framework for Policy Usage Feedback for Common Open Policy Service
                 with Policy Provisioning (COPS-PR)

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 (2003).  All Rights Reserved.

Abstract

  Common Open Policy Services (COPS) Protocol (RFC 2748), defines the
  capability of reporting information to the Policy Decision Point
  (PDP).  The types of report information are success, failure and
  accounting of an installed state.  This document focuses on the COPS
  Report Type of Accounting and the necessary framework for the
  monitoring and reporting of usage feedback for an installed state.

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













Rawlins, et al.              Informational                      [Page 1]

RFC 3483                COPS Feedback Framework               March 2003


Table of Contents

  Glossary........................................................... 2
  1  Introduction.................................................... 2
  2  Overview........................................................ 3
  3  Requirements for Normal Operations.............................. 3
  4  Periodic Nature of Policy Usage Feedback........................ 4
     4.1 Reporting Intervals......................................... 4
  5  Suspension, Resumption and Halting of Usage Monitoring and
     Reporting....................................................... 5
  6  Solicited Feedback.............................................. 5
  7  Usage reports on shared objects................................. 5
  8  Context......................................................... 6
  9  Delete Request States........................................... 7
  10 Failover........................................................ 7
  11 Security Considerations......................................... 7
  12 References...................................................... 8
     12.1 Normative References....................................... 8
     12.2 Informative References..................................... 8
  13 Authors' Addresses.............................................. 9
  14 Full Copyright Statement........................................10

Glossary

  COPS - Common Open Policy Service.  See [RFC2748].
  COPS-PR - COPS Usage for Policy Provisioning.  See [RFC3084].
  PDP - Policy Decision Point.  See [RFC2753].
  PEP - Policy Enforcement Point.  See [RFC2753].
  PIB - Policy Information Base.  The database of policy information.
  PRC - Provisioning Class.  A type of policy data.
  PRI - Provisioning Instance.  An instance of a PRC.
  QoS - Quality of Service.

1 Introduction

  Policy usage reported by the PEP makes a richer set of information
  available to the PDP for decision-making.  This feedback on policy
  usage can impact future decisions made by the PDP and the resulting
  policy installed by the PDP at the PEP.  For example, a PDP making
  policy for a SIP signaled multimedia session may need to base the
  decision in part on usage information related to previously installed
  QoS policy decisions.  Furthermore, the PDP may coordinate this usage
  information with other external systems to determine the future
  policy such as the case with the PDP coordinating multimedia session
  QoS and clearinghouse authorizations [SIP-AAA-QOS].






Rawlins, et al.              Informational                      [Page 2]

RFC 3483                COPS Feedback Framework               March 2003


  The scope of this document is to describe the framework for policy
  usage monitored and reported by the PEP and collected at the PDP.
  The charging, rating and billing models, as well as other accounting
  or statistics gathering events, detectable by the PDP are beyond the
  scope of this framework.

2 Overview

  There are three main aspects to define policies for usage feedback:

  -  which objects are monitored
  -  the metrics to be monitored and reported for these objects
  -  when the reports are delivered

  In the framework, a selection criteria policy specifies one or more
  objects that should be monitored (e.g., a dropper or the instances of
  an IP Filter for all its interfaces).

  A usage feedback class is used to specify which metrics are to be
  collected for a set of objects - instances of the specified class
  carry the usage information when it is reported.  The valid
  combinations of monitored object classes and usage feedback classes
  are reported by the PEP as capabilities.

  Finally, selection criteria policy and usage feedback class are bound
  together in a linkage policy, which also contains the information of
  when reports are generated.  Reports are usually sent periodically,
  but more restrictions can be placed on the generation of reports,
  like thresholds or a change in the data.

3 Requirements for Normal Operations

  Per COPS [RFC2748], the PDP specifies the minimum feedback interval
  in the Accounting Timer object that is included in the Client Accept
  message during connection establishment.  This specifies the maximum
  frequency with which the PEP issues unsolicited accounting type
  report messages.  The purpose of this interval is to pace the number
  of report messages sent to the PDP.  It is not the goal of the
  interval defined by the ACCT Timer value to provide precision
  synchronization or timing.

  The selection and the associated usage criteria and intervals for
  feedback reporting are defined by the PDP.  Feedback policies, which
  define the necessary selection and linkages to usage feedback
  criteria, are included by the PDP in a Decision message to the PEP.
  The usage feedback is then periodically reported by the PEP, at
  intervals defined in the linkage policies at a rate no more
  frequently than specified in the Accounting Timer object.  Note that



Rawlins, et al.              Informational                      [Page 3]

RFC 3483                COPS Feedback Framework               March 2003


  there are exceptions where reports containing feedback are provided
  prior to the Accounting Timer interval (see section 6).  The PDP may
  also solicit usage feedback which is to be reported back immediately
  by the PEP.  Usage information may be cleared upon reporting.  This
  is specified in the usage policy criteria.

  The PEP monitors and tracks the usage feedback information.  The PDP
  is the collection point for the policy usage feedback information
  reported by the PEP clients within the administrative domain.  The
  PDP may also collect other accounting event information that is
  outside the scope of this document.

4 Periodic Nature of Policy Usage Feedback

  Generally the policy usage feedback is periodic in nature and the
  reporting is unsolicited.  The unsolicited reports are supplied per
  the interval defined by the PDP.  The periodic unsolicited reports
  are dictated by timer intervals and use a deterministic amount of
  network resources.

  The PDP informs the PEP of the minimal feedback interval during
  client connection establishment with the Accounting Timer object.
  The PDP may specify feedback intervals in the specific usage feedback
  policies as well.  The unsolicited monitoring and reporting by the
  PEP may be suspended and resumed at the direction of the PDP.

4.1 Reporting Intervals

  The generation of usage feedback by the PEP to the PDP is done under
  different conditions that include feedback on demand, periodic
  feedback or feedback when a defined threshold is reached.

  The periodic feedback for a usage policy can be further defined in
  terms of providing feedback if there is a change or providing
  feedback periodically regardless of a change in value.

  The periodic interval is defined in terms of the Accounting Object,
  ACCT Timer value.  A single interval is equal to the number of
  seconds specified by the ACCT Timer value.  The PDP may define a
  specific number of intervals, which are to pass before the PEP
  provides the usage feedback for a specific policy in a report.  When
  the ACCT Timer value is equal to zero there is no unsolicited usage
  feedback provided by the PEP.  However, the PEP still monitors and
  tracks the usage per the PDP policy and reports it when the PDP
  solicits the feedback.






Rawlins, et al.              Informational                      [Page 4]

RFC 3483                COPS Feedback Framework               March 2003


  Reporting may be based on reaching a defined threshold value in the
  usage PRC.

  The PDP may solicit usage feedback in the middle of an interval by
  sending a COPS decision message.  The exact contents of the message
  are out of the scope of this framework document and need to be
  defined in a document that actually implements usage feedback using
  this framework.

  The PEP, upon receiving a solicit decision from the PDP, shall
  provide the requested usage information and clear the usage
  information if the usage policy requires that the attribute be
  cleared after reporting.  The PEP should continue to maintain the
  same interval schedule as defined by the PDP in the Accounting Timer
  object and established at client connection acceptance.

5 Suspension, Resumption and Halting of Usage Monitoring and Reporting

  The PDP may direct the PEP to suspend usage feedback report messages
  and then at a later time instruct the PEP to resume the reporting of
  feedback.  The PDP may also instruct the PEP to suspend the
  monitoring and tracking of usage which also results in the
  suppression of the feedback reports until the PDP later tells the PEP
  to resume the monitoring (and reporting).  When the PDP suspends
  monitoring or suspends reporting, it also specifies whether the PEP
  is to provide an unsolicited feedback report of the current monitored
  usage of the affected usage policy.  The PDP may suspend and resume
  monitoring and reporting for specific usage policies or for all of
  the usage feedback policies.

6 Solicited Feedback

  There may be instances when it is useful for the PDP to control the
  feedback per an on-demand basis rather than a periodic basis.  The
  PDP may solicit the PEP for usage feedback with a Decision.  The PDP
  may solicit usage feedback at any time during the accounting interval
  defined by the ACCT Timer.  The PEP responds immediately and reports
  the appropriate usage policies and should continue to follow the
  usage feedback interval schedule established during connection
  acceptance.

7 Usage reports on shared objects

  While some objects in a context's namespace directly represent unique
  objects of the PEP's configuration, other COPS objects can be shared
  between multiple actual assignments in the PEP.





Rawlins, et al.              Informational                      [Page 5]

RFC 3483                COPS Feedback Framework               March 2003


  Whenever the PEP creates multiple actual configuration instances from
  the same COPS objects, these assignments can potentially collect
  their own statistics independently.  Since the individual assignments
  do not have a direct representation as COPS objects, additional
  information must be provided to uniquely identify the assignment that
  generates the usage information.  As an example, if the PEP needs to
  create multiple usage objects for an IP address, it may use the port
  number to uniquely identify each object, i.e., the (IP address, port
  number) combination is now the unique identifier of the object.

  The feedback framework allows this information to be distributed
  between a selection criteria PRC and the corresponding usage feedback
  PRC, however both PRCs together always must contain sufficient
  information for the finest granularity of usage collection supported
  by the PEP.

  If all the additional information is not part of the selection
  criteria PRC, all matching assignments are selected to collect usage
  information.  The necessary data to differentiate these assignments
  is part of the usage feedback PRC.

  Implementations based on the feedback framework should always provide
  a selection criteria PRC that contains a complete set of information
  to select a unique assignment, while underspecified selection
  criteria PRCs (together with extended usage feedback PRCs) are
  optional.

8 Context

  COPS-PR [RFC3084] allows multiple, independent, disjoint instances of
  policies to be configured on the PEP.  Each instance is known as a
  context, and only one context can be active at any given moment.  The
  PDP directs the PEP to switch between contexts using a single
  decision message.

  The monitoring and recording of usage policies is subject to context
  switches in a manner similar to that of the enforcement policy.
  Usage policy is monitored, recorded and reported while the associated
  policy information context is active.  When the context is
  deactivated, a report message containing the usage feedback policies
  for that context is provided to the PDP.  The PEP does not perform
  any monitoring, tracking or reporting of policy usage for a given
  context while the context is inactive.








Rawlins, et al.              Informational                      [Page 6]

RFC 3483                COPS Feedback Framework               March 2003


9 Delete Request States

  The PEP MUST send any outstanding usage feedback data monitored
  during the feedback interval to the PDP via an unsolicited report
  message immediately prior to issuing a Delete Request State.  This is
  also the case when the PDP initiates the Delete Request State.

10 Failover

  In the event the connection is lost between the PEP and PDP, the PEP
  continues to track usage feedback information as long as it continues
  to enforce installed (cached) policy.  When the locally installed
  policy at the PEP expires, the usage feedback policy data also
  expires and is no longer monitored.

  Upon successful reconnection, where the PEP is still caching policy,
  the PDP indicates deterministically to the PEP that the PEP may
  resume usage feedback reporting.  The PEP reports all cached usage
  and resumes periodic reporting, making any needed adjustment to the
  interval schedule as specified in the reconnection acceptance ACCT
  Timer.

11 Security Considerations

  This document provides a framework for policy usage feedback, using
  COPS-PR as the transport mechanism.  As feedback information is
  sensitive, it MUST be transported in a secured manner.  COPS
  [RFC2748] and COPS-PR [RFC3084] provide for such secured transport,
  with mandatory and suggested security mechanisms.

  The usage feedback information themselves MUST be secured, with their
  security requirement specified in their respective documents.



















Rawlins, et al.              Informational                      [Page 7]

RFC 3483                COPS Feedback Framework               March 2003


12 References

12.1 Normative References

  [RFC2119]     Bradner, S., "Key words to use in the RFCs", BCP 14,
                RFC 2119, March 1997.

  [RFC2748]     Boyle, J., Cohen, R., Durham, D., Herzog, S., Rajan, R.
                and A. Sastry, "The COPS (Common Open Policy Service)
                Protocol", RFC 2748, January 2000.

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

  [RFC3084]     Chan, K., Durham, D., Gai, S., Herzog, S., McCloghrie,
                K., Reichmeyer, F., Seligson, J., Smith, A. and R.
                Yavatkar, "COPS Usage for Policy Provisioning (COPS-
                PR)", RFC 3084, March 2001.

12.2 Informative References

  [SIP-AAA-QOS] Gross, G., Sinnreich, H. Rawlins D. and T. Havinis,
                "QoS and AAA Usage with SIP Based IP Communications",
                Work in Progress.


























Rawlins, et al.              Informational                      [Page 8]

RFC 3483                COPS Feedback Framework               March 2003


13 Authors' Addresses

  Diana Rawlins
  WorldCom
  901 International Parkway
  Richardson, Texas 75081

  Phone: 972-729-4071
  EMail: [email protected]


  Amol Kulkarni
  JF3-206
  2111 NE 25th Ave
  Hillsboro, Oregon 97124

  Phone: 503-712-1168
  EMail: [email protected]


  Kwok Ho Chan
  Nortel Networks, Inc.
  600 Technology Park Drive
  Billerica, MA 01821 USA

  Phone: 978-288-8175
  EMail: [email protected]


  Martin Bokaemper
  Juniper Networks
  700 Silver Seven Road
  Kanata, ON, K2V 1C3, Canada

  Phone: 613-591-2735
  EMail: [email protected]















Rawlins, et al.              Informational                      [Page 9]

RFC 3483                COPS Feedback Framework               March 2003


14 Full Copyright Statement

  Copyright (C) The Internet Society (2003).  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 organizations, 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 languages other than
  English.

  The limited permissions granted above are perpetual and will not be
  revoked by the Internet Society or its successors or assigns.

  This document and the information contained herein is provided on an
  "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  TASK FORCE DISCLAIMS 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.

Acknowledgement

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



















Rawlins, et al.              Informational                     [Page 10]