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: Diana.Rawlins@wcom.com Amol Kulkarni JF3-206 2111 NE 25th Ave Hillsboro, Oregon 97124 Phone: 503-712-1168 EMail: amol.kulkarni@intel.com Kwok Ho Chan Nortel Networks, Inc. 600 Technology Park Drive Billerica, MA 01821 USA Phone: 978-288-8175 EMail: khchan@nortelnetworks.com Martin Bokaemper Juniper Networks 700 Silver Seven Road Kanata, ON, K2V 1C3, Canada Phone: 613-591-2735 EMail: mbokaemper@juniper.net 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]