Network Working Group M. Bangalore Request for Comments: 5140 R. Kumar Category: Standards Track J. Rosenberg Cisco H. Salama Citex Software D.N. Shah Moowee Inc. March 2008 A Telephony Gateway REgistration Protocol (TGREP) Status of This Memo This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited. Abstract This document describes the Telephony Gateway Registration Protocol (TGREP) for registration of telephony prefixes supported by telephony gateways and soft switches. The registration mechanism can also be used to export resource information. The prefix and resource information can then be passed on to a Telephony Routing over IP (TRIP) Location Server, which in turn can propagate that routing information within and between Internet Telephony Administrative Domains (ITADs). TGREP shares a lot of similarities with the TRIP protocol. It has similar procedures and finite state machine for session establishment. It also shares the same format for messages and a subset of attributes with TRIP. Bangalore, et al. Standards Track [Page 1] RFC 5140 TGREP March 2008 Table of Contents 1. Introduction ....................................................3 2. Terminology and Definitions .....................................5 3. TGREP: Overview of Operation ....................................6 4. TGREP Attributes ................................................7 4.1. TotalCircuitCapacity Attribute .............................8 4.2. AvailableCircuits Attribute ................................9 4.3. CallSuccess Attribute .....................................10 4.4. Prefix Attributes .........................................12 4.5. TrunkGroup Attribute ......................................13 4.6. Carrier Attribute .........................................15 5. TrunkGroup and Carrier Address Families ........................16 5.1. Address Family Syntax .....................................17 6. Gateway Operation ..............................................18 6.1. Session Establishment .....................................18 6.2. UPDATE Messages ...........................................19 6.3. KEEPALIVE Messages ........................................19 6.4. Error Handling and NOTIFICATION Messages ..................19 6.5. TGREP Finite State Machine ................................19 6.6. Call Routing Databases ....................................19 6.7. Multiple Address Families .................................20 6.8. Route Selection and Aggregation ...........................20 7. LS/Proxy Behavior ..............................................20 7.1. Route Consolidation .......................................22 7.2. Aggregation ...............................................23 7.3. Consolidation versus Aggregation ..........................23 8. Security Considerations ........................................23 9. IANA Considerations ............................................24 9.1. Attribute Codes ...........................................24 9.2. Address Family Codes ......................................24 10. Acknowledgments ...............................................25 11. References ....................................................25 11.1. Normative References .....................................25 11.2. Informative References ...................................26 Bangalore, et al. Standards Track [Page 2] RFC 5140 TGREP March 2008 1. Introduction It is assumed that the reader of this document is familiar with TRIP [2, 12]. In typical Voice over IP (VoIP) networks, Internet Telephony Administrative Domains (ITADs) will deploy numerous gateways for the purposes of geographical diversity, capacity, and redundancy. When a call arrives at the domain, it must be routed to one of those gateways. Frequently, an ITAD will break its network into geographic Points of Presence (POPs), with each POP containing some number of gateways, and a proxy server element that fronts those gateways. The proxy element is a SIP proxy [11] or H.323 gatekeeper. The proxy server is responsible for managing the access to the POP, and also for determining which of the gateways will receive any given call that arrives at the POP. In conjunction with the proxy server that routes the call signaling, there are two components, the "Ingress LS" (aka "TGREP receiver") and the "Egress LS". The TGREP receiver component maintains TGREP peering relationship with one or more gateways. The routing information received from the gateways is further injected into the Egress LS, which in turn disseminates into the rest of the network on TRIP. For convenience, gateway and GW are used interchangeably. This configuration is depicted graphically in Figure 1. Bangalore, et al. Standards Track [Page 3] RFC 5140 TGREP March 2008 Signaling TGREP -------------> <---------------- +---------+ | | | GW | > +---------+ // // SIP // +---------+ <----> // | | +-------------------------+ // | GW | | | // +---------+ | +-------------+ |/ | | | | | | Routing | | +---------+ TO PSTN | | Proxy | | | | ---> | | |-----------> | GW | -----> |+---+-----+ +-----+----+ | +---------+ || | | | | || <+-+ | |-- ||Egress LS| |Ingress LS| | --- +---------+ || | | | | -- | | |+---------+ +----------+ | -- | GW | | | -- +---------+ | | --> +-------------------------+ TRIP +---------+ <----> | | | GW | +---------+ Figure 1: Gateway and LS Configuration The decision about which gateway to use depends on many factors, including their availability, remaining call capacity, and call success statistics to a particular Public Switched Telephone Network (PSTN) destination (see [14]). For the proxy to do this adequately, it needs to have access to this information in real-time, as it changes. This means there must be some kind of communications between the proxy and the gateways to convey this information. The TRIP protocol [2] is defined for carrying telephony routing information between providers, for the purposes of getting a call routed to the right provider for termination to the PSTN. However, there is no mechanism defined in TRIP that defines how routes get injected into the TRIP protocol from within the network. Nor does it Bangalore, et al. Standards Track [Page 4] RFC 5140 TGREP March 2008 define mechanisms that would allow the provider to select the specific gateway for terminating a call when it arrives. Those gaps are filled by TGREP. TGREP allows PSTN gateways or soft switches to inform a signaling server, such as a SIP proxy server or H.323 gatekeeper, of routes it has to the PSTN. These advertisements include fairly dynamic information, such as the remaining capacity in a particular trunk, which is essential for selecting the right gateway. TGREP is identical in syntax and overall operation to TRIP. However, it differs in the route processing rules followed by the TGREP receiver, allowing for a route processing function called "consolidation". Consolidation combines multiple routes for the same route destination with different attributes to a single route to prevent loss of routing information. TGREP also defines a set of new attributes, usable by TGREP or TRIP. Finally, TGREP only utilizes a subset of overall TRIP capabilities. Specifically, certain attributes are not utilized (as described below), and the TGREP entities (the sender and receiver) operate in an asymmetric relationship, whereas TRIP allows symmetric and asymmetric. As a general rule, because of a lot of similarities between TRIP and TGREP, frequent reference will be made to the terminologies and formats defined in TRIP [2]. It is suggested that the reader be familiar with the concepts of TRIP like attributes, flags, route types, address families, etc. 2. Terminology and Definitions 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 [1]. Some other useful definitions are: Circuit: A circuit is a discrete (specific) path between two or more points along which signals can be carried. In this context, a circuit is a physical path, consisting of one or more wires and possibly intermediate switching points. Trunk: In a network, a trunk is a communication path connecting two switching systems used in the establishment of an end-to-end connection. In selected applications, it may have both its terminations in the same switching system. Bangalore, et al. Standards Track [Page 5] RFC 5140 TGREP March 2008 TrunkGroup: A trunkgroup is a set of trunks, traffic engineered as a unit, for the establishment of connections within or between switching systems in which all of the paths are interchangeable except where subgrouped. Carrier: A carrier is a company offering telephone and data communications between points (end-users and/or exchanges). 3. TGREP: Overview of Operation TGREP is a route registration protocol for telephony destinations on a gateway. These telephony destinations could be prefixes, trunkgroups, or carriers. The TGREP sender resides on the GW and gathers all the information from the GW to relay to the TRIP Location Server. A TGREP Receiver is defined, which receives this information and optionally performs operations like consolidation and aggregation (see Section 7.3), and hands over the reachability information to a TRIP Location Server. The routing proxy also uses the information to select the gateway for incoming calls. The TGREP sender establishes a session to the TGREP receiver using a procedure similar to session establishment in TRIP. After the session establishment, the TGREP sender sends the reachability information in the UPDATE messages. The UPDATE messages have the same format as in TRIP. However, certain TRIP attributes are not relevant in TGREP; a TGREP receiver MAY ignore them if they are present in a TGREP message. The following TRIP attributes do not apply to TGREP: 1. AdvertisementPath 2. RoutedPath 3. AtomicAggregate 4. LocalPreference 5. MultiExitDisc 6. ITADTopology 7. ConvertedRoute In addition, TGREP defines the following new attributes in this document that can be carried in a TGREP UPDATE message. - TotalCircuitCapacity: This attribute identifies the total number of PSTN circuits that are available on a route to complete calls. - AvailableCircuits: This attribute identifies the number of PSTN circuits that are currently available on a route to complete calls. Bangalore, et al. Standards Track [Page 6] RFC 5140 TGREP March 2008 - CallSuccess: This attribute represents information about the number of normally terminated calls out of a total number of attempted calls. - Prefix (E164): This attribute is used to represent the list of E164 prefixes to which the respective route can complete calls. - Prefix (Decimal Routing Number): This attribute is used to represent the list of Decimal prefixes to which the respective route can complete calls. - Prefix (Hexadecimal Routing Number): This attribute is used to represent the list of Hexadecimal prefixes to which the respective route can complete calls. - TrunkGroup: This attribute enables providers to route calls to destinations through preferred trunks. - Carrier: This attribute enables providers to route calls to destinations through preferred carriers. In the rest of the document, we specify attributes and address families used in TGREP. The new attributes and address families introduced are also applicable for general usage in TRIP except where noted (AvailableCircuits attribute, for example). 4. TGREP Attributes Due to its usage within a service provider network, TGREP makes use of a subset of the attributes defined for TRIP, in addition to defining several new ones. In particular, the following attributes from TRIP are applicable to TGREP: 1. WithdrawnRoutes 2. ReachableRoutes 3. NexthopServer 4. Prefix 5. Communities TGREP also defines several new attributes, described in this section. These are TotalCircuitCapacity, AvailableCircuits, CallSuccess, TrunkGroup, and Carrier. As mentioned above, these new attributes are usable by TRIP unless noted otherwise. Bangalore, et al. Standards Track [Page 7] RFC 5140 TGREP March 2008 A TGREP UPDATE supports the following attributes: 1. TotalCircuitCapacity 2. AvailableCircuits 3. CallSuccess 4. Prefix (E.164, Pentadecimal routing number, Decimal routing number) 5. TrunkGroup 6. Carrier 4.1. TotalCircuitCapacity Attribute Mandatory: False. Required Flags: Not well-known. Potential Flags: None. TRIP Type Code: 13. The TotalCircuitCapacity attribute identifies the total number of PSTN circuits that are available on a route to complete calls. It is used in conjunction with the AvailableCircuits attribute in gateway selection by the LS. The total number of calls sent to the specified route on the gateway cannot exceed this total circuit capacity under steady state conditions. The TotalCircuitCapacity attribute is used to reflect the administratively provisioned capacity as opposed to the availability at a given point in time as provided by the AvailableCircuits attribute. Because of its relatively static nature, this attribute MAY be propagated beyond the LS that receives it. TotalCircuitCapacity represents the total number of possible calls at any instant. This is not expected to change frequently. This can change, for instance, when certain telephony trunks on the gateway are taken out of service for maintenance purposes. 4.1.1. TotalCircuitCapacity Syntax The TotalCircuitCapacity attribute is a 4-octet unsigned integer. It represents the total number of circuits available for terminating calls through this advertised route. This attribute represents a potentially achievable upper bound on the number of calls that can be terminated on this route in total. 4.1.2. Route Origination and TotalCircuitCapacity Routes MAY be originated containing the TotalCircuitCapacity attribute. Bangalore, et al. Standards Track [Page 8] RFC 5140 TGREP March 2008 4.1.3. Route Selection and TotalCircuitCapacity The TotalCircuitCapacity attribute MAY be used for route selection. Since one of its primary applications is load balancing, an LS will wish to choose a potentially different route (amongst a set of routes for the same destination), on a call-by-call basis. This can be modeled as re-running the decision process on the arrival of each call. The aggregation and dissemination rules for routes with this attribute ensure that re-running this selection process never results in propagation of a new route to other peers. 4.1.4. Aggregation and TotalCircuitCapacity An LS MAY aggregate routes to the same prefix that contains a TotalCircuitCapacity attribute. It SHOULD add the values of the individual routes to determine the value for the aggregated route in the same ITAD. 4.1.5. Route Dissemination and TotalCircuitCapacity Since this attribute reflects the static capacity of the gateway's circuit resources, it is not expected to change frequently. Hence, the LS receiving this attribute MAY disseminate it to other peers, both internal and external to the ITAD. 4.2. AvailableCircuits Attribute Mandatory: False. Required Flags: Not well-known. Potential Flags: None. TRIP Type Code: 14. The AvailableCircuits attribute identifies the number of PSTN circuits that are currently available on a route to complete calls. The number of additional calls sent to that gateway for that route cannot exceed the circuit capacity. If it does, the signaling protocol will likely generate errors, and calls will be rejected. The AvailableCircuits attribute is used ONLY between a gateway and its peer LS responsible for managing that gateway. If it is received in a route, it is not propagated. 4.2.1. AvailableCircuits Syntax The AvailableCircuits attribute is a 4-octet unsigned integer. It represents the number of circuits remaining for terminating calls to this route. Bangalore, et al. Standards Track [Page 9] RFC 5140 TGREP March 2008 4.2.2. Route Origination and AvailableCircuits Routes MAY be originated containing the AvailableCircuits attribute. Since this attribute is highly dynamic, changing with every call, updates MAY be sent as it changes. However, it is RECOMMENDED that measures be taken to help reduce the messaging load from route origination. It is further RECOMMENDED that a sufficiently large window of time be used to provide a useful aggregated statistic. 4.2.3. Route Selection and AvailableCircuits The AvailableCircuits attribute MAY be used for route selection. Since one of its primary applications is load balancing, an LS will wish to choose a potentially different route (amongst a set of routes for the same prefix) on a call-by-call basis. This can be modeled as re-running the decision process on the arrival of each call. The aggregation and dissemination rules for routes with this attribute ensure that re-running this selection process never results in propagation of a new route to other peers. 4.2.4. Aggregation and AvailableCircuits Not applicable. 4.2.5. Route Dissemination and AvailableCircuits Routes MUST NOT be disseminated with the AvailableCircuits attribute. The attribute is meant to reflect capacity at the originating gateway only. Its highly dynamic nature makes it inappropriate to disseminate in most cases. 4.3. CallSuccess Attribute Mandatory: False. Required Flags: Not well-known. Potential Flags: None. TRIP Type Code: 15. The CallSuccess attribute is an attribute used ONLY between a gateway and its peer LS responsible for managing that gateway. If it is received in a route, it is not propagated. The CallSuccess attribute provides information about the number of normally terminated calls out of a total number of attempted calls. CallSuccess is to be determined by the gateway based on the Disconnect cause code at call termination. For example, a call that reaches the Alerting stage but does not get connected due to the Bangalore, et al. Standards Track [Page 10] RFC 5140 TGREP March 2008 unavailability of the called party, or the called party being busy, is conventionally considered a successful call. On the other hand, a call that gets disconnected because of a circuit or resource being unavailable is conventionally considered a failed call. The exact mapping of disconnect causes to CallSuccess is at the discretion of the gateway reporting the attribute. The CallSuccess attribute is used by the LS to keep track of failures in reaching certain telephony destinations through a gateway(s) and to use that information in the gateway selection process to enhance the probability of successful call termination. This information can be used by the LS to consider alternative gateways to terminate calls to those destinations with a better likelihood of success. 4.3.1. CallSuccess Syntax The CallSuccess attribute is composed of two component fields -- each represented as a 4-octet unsigned integer. The first component field represents the total number of calls terminated successfully for the advertised destination on a given address family over a given window of time. The second component field represents the total number of attempted calls for the advertised destination within the same window of time. When the value for the total number of attempted calls wraps around, the counter value for the number of successful calls is reset to keep it aligned with the other component over a given window of time. The TGREP receiver using this information should obtain this information frequently enough to prevent loss of significance. 4.3.2. Route Origination and CallSuccess Routes MAY be originated containing the CallSuccess attribute. This attribute is expected to get statistically significant with passage of time as more calls are attempted. It is RECOMMENDED that sufficiently large windows be used to provide a useful aggregated statistic. 4.3.3. Route Selection and CallSuccess The CallSuccess attribute MAY be used for route selection. This attribute represents a measure of success of terminating calls to the advertised destination(s). This information MAY be used to select from amongst a set of alternative routes to increase the probability of successful call termination. Bangalore, et al. Standards Track [Page 11] RFC 5140 TGREP March 2008 4.3.4. Aggregation and CallSuccess Not applicable. 4.3.5. Route Dissemination and CallSuccess Routes MUST NOT be disseminated with the CallSuccess attribute. Its potential to change dynamically does not make it suitable to disseminate. 4.4. Prefix Attributes Mandatory: False. Required Flags: Not well-known. Potential Flags: None. TRIP Type Codes: 16 for E164 Prefix, 17 for Pentadecimal Routing Number Prefix, and 18 for Decimal Routing Number Prefix. The Prefix attribute is used to represent the list of prefixes to which the respective route can complete calls. This attribute is intended to be used with the Carrier or TrunkGroup address family (discussed in Section 5). Though it is possible that all prefix ranges may be reachable through a given carrier, administrative issues could make certain ranges preferable to others. 4.4.1. Prefix Attribute Syntax The Prefix attribute could be E.164, Decimal, or Pentadecimal (refer to TRIP [2]), each of them having its own type code. The Prefix attribute is encoded as a sequence of prefix values in the attribute Value field. The prefixes are listed sequentially with no padding as shown in Figure 2. Each prefix includes a 2-octet Length field that represents the length of the Address field in octets. The order of prefixes in the attribute is not significant. The presence of the Prefix Attribute with the Length field of the attribute as 0 signifies that the TGREP GW can terminate ALL prefixes of that prefix type (E.164, Decimal, or Pentadecimal) for the given Reachable route(s). This is not equivalent to excluding the Prefix attribute in the TGREP update. Bangalore, et al. Standards Track [Page 12] RFC 5140 TGREP March 2008 < 2 octets > < Length1 octets > < 2 octets > < Length2 octets > +------------+--------------//--+------------+--------------//--+- | Length1 | Prefix1 | Length2 | Prefix2 | ... +------------+--------------//--+------------+--------------//--+- Figure 2: Prefix Format 4.4.2. Route Origination and Prefix Routes MAY be originated containing the Prefix attribute. 4.4.3. Route Selection and Prefix The Prefix attribute MAY be used for route selection. 4.4.4. Aggregation and Prefix Routes with differing Prefix attributes MUST NOT be aggregated. Routes with the same value in the Prefix attribute MAY be aggregated and the same Prefix attribute attached to the aggregated object. 4.4.5. Route Dissemination and Prefix The LS receiving this attribute should disseminate to other peers, both internal and external to the ITAD. 4.5. TrunkGroup Attribute Mandatory: False. Required Flags: Not well-known. Potential Flags: None. TRIP Type Code: 19. The TrunkGroup attribute is used to represent the list of trunkgroups on the gateway used to complete calls. It enables providers to route calls to destinations through preferred trunks. This attribute is relatively static. 4.5.1. TrunkGroup Syntax The TrunkGroup attribute is a variable-length attribute that is composed of a sequence of trunkgroup identifiers. It indicates that the gateway can complete the call through any trunkgroup identifier indicated in the sequence. Each trunkgroup identifier is encoded as a Length-Value field (shown in Figure 3 below). The Length field is a 1-octet unsigned numeric Bangalore, et al. Standards Track [Page 13] RFC 5140 TGREP March 2008 value. The Value field is a variable-length field consisting of two subfields, a trunkgroup label followed by a trunk context, the two subfields separated by the delimiter ";" (semicolon). Both the trunkgroup label and the trunk context subfields are of variable length. The Length field represents the total size of the Value field including the delimiter. The permissible character set for the trunk group label and the trunkgroup context subfields and the associated ABNF [8] is per rules outlined in [4]. The presence of the TrunkGroup attribute with the Length field of the attribute as 0 signifies that the TGREP GW can terminate ALL trunkgroups for the given Reachable route(s). < 1 octet > < Length1 octets > < 1 octet > < Length2 octets > +-----------+--------------//--+-----------+--------------//--+- | Length1 | TrunkGroup 1 | Length2 | TrunkGroup 2 | ... +-----------+--------------//--+-----------+--------------//--+- Figure 3: TrunkGroup Syntax 4.5.2. Route Origination and TrunkGroup Routes MAY be originated containing the TrunkGroup attribute. 4.5.3. Route Selection and TrunkGroup The TrunkGroup attribute MAY be used for route selection. Certain trunkgroups MAY be preferred over others based on provider policy. 4.5.4. Aggregation and TrunkGroup Routes with differing TrunkGroup attributes MUST NOT be aggregated. Routes with the same value in the TrunkGroup attribute MAY be aggregated and the same TrunkGroup attribute attached to the aggregated object. 4.5.5. Route Dissemination and TrunkGroup This attribute is not expected to change frequently. Hence, the LS receiving this attribute MAY disseminate it to other peers, internal to ITAD. Routes SHOULD not be disseminated external to the ITAD, with TrunkGroup attribute. Bangalore, et al. Standards Track [Page 14] RFC 5140 TGREP March 2008 4.6. Carrier Attribute Mandatory: False. Required Flags: Not well-known. Potential Flags: None. TRIP Type Code: 20. The Carrier attribute is used to represent the list of carriers that the gateway uses to complete calls. It enables providers to route calls to destinations through preferred carriers. This attribute is relatively static. 4.6.1. Carrier Syntax The Carrier attribute is a variable-length attribute that is composed of a sequence of carrier identifiers. It indicates that the route can complete the call to any of the carriers represented in the sequence of carrier identifiers [13]. Each carrier identifier is encoded as a Length-Value field (shown in Figure 4 below). The Length field is a 1-octet unsigned numeric value. The Value field is a variable-length field. The permissible character set for the Value field and the associated ABNF [8] is per rules outlined in [5]. Specifically, it carries "global-cic" or "local-cic" [5]. In case of "local-cic", the "phonedigit-hex" part and the "cic-context" part would be separated by the delimiter ";". Hence, absence or presence of the delimiter can be used to determine if the value is a "global-cic" or a "local- cic". The Length field represents the total size of the Value field including the delimiter. The presence of the Carrier attribute with the Length field of the attribute as 0 signifies that the TGREP GW can terminate ALL Carriers for the given Reachable route(s). < 1 octet > < Length1 octets > < 1 octet > < Length2 octets > +-----------+--------------//--+-----------+--------------//--+- | Length1 | Carrier 1 | Length2 | Carrier 2 | ... +-----------+--------------//--+-----------+--------------//--+- Figure 4: Carrier Syntax 4.6.2. Route Origination and Carrier Routes MAY be originated containing the Carrier attribute. Bangalore, et al. Standards Track [Page 15] RFC 5140 TGREP March 2008 4.6.3. Route Selection and Carrier The Carrier attribute MAY be used for route selection. Certain carriers MAY be preferred over others based on provider policy. 4.6.4. Aggregation and Carrier Routes with differing Carrier attributes MUST NOT be aggregated. Routes with the same value in the Carrier attribute MAY be aggregated and the same Carrier attribute attached to the aggregated object. 4.6.5. Route Dissemination and Carrier This attribute is not expected to change frequently. Hence, the LS receiving this attribute MAY disseminate it to other peers, both internal and external to the ITAD. 5. TrunkGroup and Carrier Address Families As described in TRIP [2], the Address Family field gives the type of address for the route. Two new address families and their codes are defined in this section: Code Address Family 4 TrunkGroup 5 Carrier When a set of GWs is to be managed at the granularity of carriers or trunkgroups, then it may be more appropriate for a GW to advertise routes using the Carrier address family or TrunkGroup address family, respectively. Also, in a TGREP association between the gateway and the LS responsible for managing that gateway, there are some attributes that more naturally fit in as advertised properties of trunkgroups or carriers rather than that of advertised prefixes, for example, the AvailableCircuit information on a particular trunkgroup or a particular carrier. To express this relationship, the existing TRIP address families are inadequate. We need separate address families that can associate certain properties like AvailableCircuits information to trunkgroups or carriers. The primary benefits of this model are as follows: - It allows a service provider to route calls based strictly on the trunkgroups or carriers. - It facilitates more accurate reporting of attributes of a dynamic nature like AvailableCircuits by providing the ability to manage resources at the granularity of a trunkgroup or a carrier. Bangalore, et al. Standards Track [Page 16] RFC 5140 TGREP March 2008 - It enables scalability as gateways can get really large with the ability to provision hundreds or a few thousand circuits, and this can increase the potential for traffic that reports dynamic resource information between the gateway and the LS. The model introduced can potentially alleviate this UPDATE traffic, hence increasing efficiency and providing a scalable gateway registration model. 5.1. Address Family Syntax Consider the generic TRIP route format from TRIP [2] shown below. 0 1 2 3 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 +---------------+---------------+---------------+---------------+ | Address Family | Application Protocol | +---------------+---------------+---------------+---------------+ | Length | Address (variable) ... +---------------+---------------+---------------+---------------+ Figure 5: Generic TRIP Route Format The Address Family field will be used to represent the type of the address associated for this family, which is based on the TrunkGroup or Carrier. The codes for the new address families have been allocated by IANA. The code for the TrunkGroup address family is 4, and the code for the Carrier address family is 5. The Application Protocol field is the same as the one for the Decimal, Pentadecimal, and E.164 address families defined in TRIP [2]. The Length field represents the total size of the Address field in bytes. The value in the Address field represents either the TrunkGroup or Carrier address family, and the syntax is as follows: For the TrunkGroup address family, the Address field represents a TrunkGroup value that is defined as specified in Section 4.5.1, "TrunkGroup Syntax". For the Carrier address family, the Address field represents a Carrier value. This is the same as the Value field specified in an earlier Section 4.6.1, "Carrier Syntax". Bangalore, et al. Standards Track [Page 17] RFC 5140 TGREP March 2008 The above mentioned address families are not hierarchical, but flat. If a gateway supports any of these address families, it should include that address family as one of the Route types supported in the OPEN message capability negotiation phase. The following attributes are currently defined to be used with all the address families including the TrunkGroup and Carrier address families. - AvailableCircuits attribute - TotalCircuitCapacity attribute - CallSuccess attribute It is recommended that the above three attributes be used by the gateway with the TrunkGroup or Carrier address family, if possible. This will potentially offer a more efficient resource reporting framework, and a scalable model for gateway provisioning. However, when the gateway is not using the TrunkGroup or Carrier address family, it MAY use the above attributes with the Decimal, Pentadecimal, and E.164 address families. The Prefix attribute cannot be used when the address family is E164 numbers, Pentadecimal routing numbers, or Decimal routing numbers. The Carrier attribute cannot be used if the address family type is Carrier. The TrunkGroup attribute cannot be used if the address family type is TrunkGroup. 6. Gateway Operation A gateway uses TGREP to advertise its reachability to its domain's Location Server(s) (LS, which are closely coupled with proxies). The gateway operates in TRIP Send Only mode since it is only interested in advertising its reachability, but is not interested in learning about the reachability of other gateways and other domains. Also, the gateway will not create its own call routing database. In this section, we describe the operation of TGREP on a gateway. 6.1. Session Establishment When opening a peering session with a TGREP receiver, a TGREP gateway follows exactly the same procedures as any other TRIP entity. The TGREP gateway sends an OPEN message that includes a Send Receive Capability in the Optional Parameters. The Send Receive Capability Bangalore, et al. Standards Track [Page 18] RFC 5140 TGREP March 2008 is set by the gateway to Send Only. The OPEN message also contains the address families supported by the gateway. The remainder of the peer session establishment is identical to TRIP. 6.2. UPDATE Messages Once the peer session has been established, the gateway sends UPDATE messages to the TRIP LS with the gateway's entire reachability. The gateway also sends any attributes associated with the routes. TGREP processing of the UPDATE message at the gateway is identical to UPDATE processing in TRIP [2]. A TGREP sender MUST support all mandatory TRIP attributes. 6.3. KEEPALIVE Messages KEEPALIVE messages are periodically exchanged over the peering session between the TGREP gateway and the TRIP LS as specified in Section 4.4 of TRIP [2]. 6.4. Error Handling and NOTIFICATION Messages The same procedures used with TRIP are used with TGREP for error handling and generating NOTIFICATION messages. The only difference is that a TGREP gateway will never generate a NOTIFICATION message in response to an UPDATE message, irrespective of the contents of the UPDATE message. Any UPDATE message is silently discarded. 6.5. TGREP Finite State Machine When the TGREP finite state machine is in the Established state and an UPDATE message is received, the UPDATE message is silently discarded and the TGREP gateway remains in the Established state. Other than that, the TRIP finite state machine and the TGREP finite state machine are identical. 6.6. Call Routing Databases A TGREP gateway may maintain simultaneous sessions with more than one TRIP LS. A TGREP gateway maintains one call routing database per peer TRIP LS. These databases are equivalent to TRIP's Adj-TRIBs- Out, and hence we will call them Adj-TRIBs-GW-Out. An Adj-TRIB-GW- Out contains the gateway's reachability information advertised to its peer TRIP LS. How an Adj-TRIB-GW-Out database gets populated is outside the scope of this document (possibly by manual configuration). Bangalore, et al. Standards Track [Page 19] RFC 5140 TGREP March 2008 The TGREP gateway does not have databases equivalent to TRIP's Adj-TRIBs-In and Loc-TRIB, because the TGREP gateway does not learn routes from its peer TRIP LSs, and hence it does not run call route selection. 6.7. Multiple Address Families As mentioned above, TGREP supports various address families in order to convey the reachability of telephony destinations. A TGREP session MUST NOT send UPDATEs of more than one of the following categories (a) Prefix address families (E164, Pentadecimal, and Decimal), (b) TrunkGroup address family, or (c) Carrier address family for a given established session. TGREP should specify its choice address family through the route-type capability in the OPEN message. And route-type specification in the OPEN message violating the above rule should be rejected with a NOTIFICATION message. 6.8. Route Selection and Aggregation TRIP's route selection and aggregation operations MUST NOT be implemented by TGREP gateways. 7. LS/Proxy Behavior As mentioned earlier, TGREP can be considered as a protocol complimentary to TRIP in providing reachability information, which can then be further fed into the Location Server. The architecture of an LS/Proxy system is as follows: There exists a TRIP LS application that functions as a speaker in the I-TRIP/E-TRIP network as documented in TRIP [2]. This component is termed as "Egress LS" for the purposes of this discussion. Then, there is a signaling server fronting a set of gateways. In conjunction with this signaling server is also a second component operating in receive mode, which peers with one or more gateways, each of them using TGREP to advertise routing information. This component on the receiving end of one or more TGREP sessions is termed as the "Ingress LS" or "TGREP receiver" for the purposes of this discussion. Also, the entity (typically, a gateway) advertising the routes on the TGREP session is termed as the "TGREP sender". The TGREP receiver receiving the TRIP messages takes the resulting routing information from each gateway, and "exports" it to another process we define below, that performs consolidation and aggregation, in that order. These operations would take as input the collective set of routes from all the gateways. Subsequently, the resulting TRIB is passed as input into the LS-Egress process as shown below, that can then disseminate these via TRIP. The interface between the TGREP receiver (aka Ingress LS) peering with the GW(s) and the TRIP LS (Egress LS) is entirely a local matter. Bangalore, et al. Standards Track [Page 20] RFC 5140 TGREP March 2008 The nature of the consolidation and aggregation operations and the accompanying motivation are described in the subsections below. The order in which the operations are listed represents an implicit logical sequence in which they are applied. The architecture for an LS/Proxy entity is shown in Figure 6 below. +-------------------------------------------------------+ | +-------------------------------+ | | | +-+ +-+ | | TGREP | | |A| |C| | | +-----+ | | |g| |o| | | | | | +-------------+ | |g| |n| +-------------+ | | --| GW | | | | | |r| |s| | | | | +-----+ | | TRIP | | |e| |o| | | | +--- | | LS <----------|g<--|l<--- TGREP |-++-| +-----+ | | | | |a| |i| | Session | | | | | | | (I-TRIP/ | | |t| |d| | Management |-++-+----| GW | | | E-TRIP) | | |i| |a| | | | | +-----+ | | (Egress LS) | | |o| |t| | |-+ +--- | +-----------/-+ | |n| |i| +-------------+ | | +-----+ | / | | | |o| | | --| | | / | | | |n| (Ingress LS) | | | GW | | / | +-+ +-+ | | +-----+ | / | TGREP Receiver | | | / +-------------------------------+ | | / | | / | +-------/-----------------------------------------------+ / LS/Proxy / / / / / +/----------------+ | | | | | | | LS | | | | | | | | | | | +-----------------+ Figure 6: LS Architecture for TRIP-GW Bangalore, et al. Standards Track [Page 21] RFC 5140 TGREP March 2008 7.1. Route Consolidation The TGREP receiver (Ingress LS) may receive routing information from one or more gateways. It is possible that multiple routes are available for the same destination. These different alternative routes may be received from the same gateway or from multiple gateways. It is RECOMMENDED that the set of gateway routes for each destination be consolidated, before presenting a candidate route, to the Egress LS entity. The motivation for this operation should be to define a route that can maximally represent the collective routing capabilities of the set of gateways, managed by this TGREP receiver. Let us take an example scenario in order to bring out the motivation for this operation. Let us say, the TGREP receiver maintains peering sessions with gateways A and B. - Gateway A advertises a route for destination "SIP 408" on the E.164 address family with the Carrier attribute value C1. - Gateway B advertises a route for destination "SIP 408" on the E.164 address family with Carrier attribute value C2. The TGREP receiver that receives these routes can consolidate these constituent routes into a single route for destination "SIP 408" with its Carrier attribute being a union of the Carrier attribute values of the individual routes, namely, "C1 C2". This operation is referred to as consolidation. In the above example, it is possible that a route to the destination "SIP 408" through one or more carriers may have been lost if the individual routes were not consolidated. Another example is to consolidate the Prefix attribute from multiple Carrier or TrunkGroup updates received from different gateways for the same destination. Let us say, there are Carrier address family (AF) updates from two gateways for Carrier destination X, and the prefix attribute values are {408, 650} from one update and {919, 973} from the other. The prefix values from these two updates can be consolidated into a single Carrier AF route advertisement with prefix value {408, 650, 919, 973}. In general, there is a potential for loss of gateway routing information when TGREP routes from a set of gateways are not consolidated when a candidate route is presented to the TRIP LS. The specifics of applying the consolidation operation to different attributes and routes from different address families is left to the individual TGREP receiver implementations. Bangalore, et al. Standards Track [Page 22] RFC 5140 TGREP March 2008 7.2. Aggregation The set of gateway routes, which are in a consolidated form or otherwise, may be aggregated before importing it to the LS instance that is responsible for I-TRIP/E-TRIP processing (Egress LS). This operation follows the standard aggregation procedures described in TRIP [2], while adhering to the aggregation rules for each route attribute. 7.3. Consolidation versus Aggregation To highlight the difference between the two operations discussed above, "consolidation" combines multiple routes for the same route destination, whereas "aggregation" combines routes for different route destinations that qualify as candidates to be summarized resulting in route information reduction. To take an example, if there are multiple gateways offering routes to an E.164 destination "408" but with possibly different attributes (e.g., Carrier), the LS/Proxy can combine these to form one route for "408" but representing the attribute information collectively. This process is consolidation. If, for example, the LS/Proxy receives routes for 4080, 4081, 4082, ... 4089 from amongst a set of gateways, it could aggregate these different candidate routes to have a summarized route destination "408" with each of the attributes computed using the aggregation procedures defined in TRIP. 8. Security Considerations The security considerations for TGREP are identical to that identified in TRIP [2] and are just restated here for the purposes of clarity. The security mechanism for the peering session between TGREP GW and a TRIP LS, in an IP network, is IPsec [3]. IPsec uses two protocols to provide traffic security: Authentication Header (AH) [6] and Encapsulating Security Payload (ESP) [7]. The AH header affords data origin authentication, connectionless integrity, and optional anti-replay protection of messages passed between the peer LSs. The ESP header provides origin authentication, connectionless integrity, anti-replay protection, and confidentiality of messages. Bangalore, et al. Standards Track [Page 23] RFC 5140 TGREP March 2008 Implementations of the protocol defined in this document employing the ESP header SHALL comply with Section 3.1.1 of [10], which defines a minimum set of algorithms for integrity checking and encryption. Similarly, implementations employing the AH header SHALL comply with Section 3.2 of [10], which defines a minimum set of algorithms for integrity checking. Implementations SHOULD use the Internet Key Exchange Protocol (IKEv2) [9] to permit more robust keying options. Implementations employing IKEv2 SHOULD support 3DES-CBC for confidentiality and HMAC-SHA1 for integrity. A Security Association (SA) [3] is a simplex "connection" that affords security services to the traffic carried by it. Security services are afforded to an SA by the use of AH or ESP, but not both. Two types of SAs are defined: transport mode and tunnel mode. A transport mode SA is a security association between two hosts, and is appropriate for protecting the TRIP session between two peer LSs. 9. IANA Considerations Both TRIP [2] and TGREP share the same IANA registry for Capabilities, Attributes, Address Families, and Application Protocols. IANA has added the following attribute codes and address family codes to the TRIP [2] registries. 9.1. Attribute Codes The Attribute Type Codes assigned for the new attributes defined in this document are listed below: Code Attribute Reference ---- --------- --------- 13 TotalCircuitCapacity [RFC5140] 14 AvailableCircuits [RFC5140] 15 CallSuccess [RFC5140] 16 E.164 Prefix [RFC5140] 17 Pentadecimal Routing Number Prefix [RFC5140] 18 Decimal Routing Number Prefix [RFC5140] 19 TrunkGroup [RFC5140] 20 Carrier [RFC5140] 9.2. Address Family Codes The following subsections show the codes that have been assigned for the two new address families introduced in this document. Bangalore, et al. Standards Track [Page 24] RFC 5140 TGREP March 2008 9.2.1. TrunkGroup Address Family Code Address Family Reference ---- -------------- --------- 4 TrunkGroup [RFC5140] 9.2.2. Carrier Address Family Code Address Family Reference ---- -------------- --------- 5 Carrier [RFC5140] 10. Acknowledgments We wish to thank Vijay Gurbani, Li Li, Kevin McDermott, David Oran, Bob Penfield, Jon Peterson, Anirudh Sahoo, and James Yu for their insightful comments and suggestions. 11. References 11.1. Normative References [1] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997. [2] Rosenberg, J., Salama, H., and M. Squire, "Telephony Routing over IP (TRIP)", RFC 3219, January 2002. [3] Kent, S. and K. Seo, "Security Architecture for the Internet Protocol", RFC 4301, December 2005. [4] Gurbani, V. and C. Jennings, "Representing Trunk Groups in tel/sip Uniform Resource Identifiers (URIs)", RFC 4904, June 2007. [5] Yu, J., "Number Portability Parameters for the "tel" URI", RFC 4694, October 2006. [6] Kent, S., "IP Authentication Header", RFC 4302, December 2005. [7] Kent, S., "IP Encapsulating Security Payload (ESP)", RFC 4303, December 2005. [8] Crocker, D., Ed., and P. Overell, "Augmented BNF for Syntax Specifications: ABNF", STD 68, RFC 5234, January 2008. [9] Kaufman, C., Ed., "Internet Key Exchange (IKEv2) Protocol", RFC 4306, December 2005. Bangalore, et al. Standards Track [Page 25] RFC 5140 TGREP March 2008 [10] Manral, V., "Cryptographic Algorithm Implementation Requirements for Encapsulating Security Payload (ESP) and Authentication Header (AH)", RFC 4835, April 2007. 11.2. Informative References [11] Rosenberg, J., Schulzrinne, H., Camarillo, G., Johnston, A., Peterson, J., Sparks, R., Handley, M., and E. Schooler, "SIP: Session Initiation Protocol", RFC 3261, June 2002. [12] Rosenberg, J. and H. Schulzrinne, "A Framework for Telephony Routing over IP", RFC 2871, June 2000. [13] ITU-T List of ITU Carrier Codes (published periodically in the ITU-T Operational Bulletin). [14] Rosenberg, J., "Requirements for Gateway Registration", Work in Progress, November 2001. Bangalore, et al. Standards Track [Page 26] RFC 5140 TGREP March 2008 Authors' Addresses Manjunath S. Bangalore Cisco Mail Stop SJC-14/2/1 3625 Cisco Way San Jose, CA 95134 Phone: +1-408-525-7555 EMail: manjax@cisco.com Rajneesh Kumar Cisco Mail Stop SJC-14/4/2 3625 Cisco Way San Jose, CA 95134 Phone: +1-408-527-6148 EMail: rajneesh@cisco.com Jonathan Rosenberg Cisco Edison, NJ 08837 EMail: jdrosen@cisco.com Hussein F. Salama Citex Software Giza, Egypt EMail: hsalama@citexsoftware.com Dhaval Niranjan Shah Moowee Inc. 4920 El Camino Real Los Altos, CA 94022 Phone: +1-408-307-7455 EMail: dhaval@moowee.tv Bangalore, et al. Standards Track [Page 27] RFC 5140 TGREP March 2008 Full Copyright Statement Copyright (C) The IETF Trust (2008). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM 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. Intellectual Property The IETF takes no position regarding the validity or scope of any Intellectual Property Rights 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; nor does it represent that it has made any independent effort to identify any such rights. Information on the procedures with respect to rights in RFC documents can be found in BCP 78 and BCP 79. Copies of IPR disclosures made to the IETF Secretariat 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 implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org. Bangalore, et al. Standards Track [Page 28]