Behave J. Rosenberg Internet-Draft Cisco Intended status: Standards Track R. Mahy Expires:May 18,July 25, 2008 Plantronics P. Matthews AvayaD. Wing Cisco November 15, 2007January 22, 2008 Traversal Using Relays around NAT (TURN): Relay Extensions to Session Traversal Utilities for NAT (STUN)draft-ietf-behave-turn-05draft-ietf-behave-turn-06 Status of this Memo By submitting this Internet-Draft, each author represents that any applicable patent or other IPR claims of which he or she is aware have been or will be disclosed, and any of which he or she becomes aware will be disclosed, in accordance with Section 6 of BCP 79. 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. This Internet-Draft will expire onMay 18,July 25, 2008. Copyright Notice Copyright (C) The IETF Trust(2007).(2008). AbstractThis specification defines an extension of the Session Traversal UtilitiesIf a host is located behind a NAT, then in certain situations it can be impossible forNAT (STUN) Protocolthat host to communicate directly with other hosts (peers) located behind other NATs. In these situations, it is necessary foraskingtheSTUN serverhost torelay packets towardsuse the services of an intermediate node that acts as aclient.communication relay. Thisextension,specification defines a protocol, calledTraversalTURN (Traversal Using Relays aroundNAT (TURN), is useful for hosts behind address dependent NATs. The extension purposefully restrictsNAT), that allows theways in whichhost to control therelayed addressoperation of the relay and to exchange packets with its peers using the relay. The TURN protocol can beused. In particular, it prevents users from running general purpose servers on ports obtained fromused in isolation, but is more properly used as part of theTURN server.ICE (Interactive Connectivity Establishment) approach to NAT traversal. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 4 2.TerminologyOverview of Operation . . . . . . . . . . . . . . . . . . . . 5 2.1. Transports . . . . .5 3. Overview of Operation. . . . . . . . . . . . . . . . . . . 7 2.2. Allocations .5 3.1. Transports. . . . . . . . . . . . . . . . . . . . . . 8 2.3. Exchanging Data with Peers . . .8 3.2. About Tuples. . . . . . . . . . . . . 9 2.4. Permissions . . . . . . . . . .9 3.3. Keepalives. . . . . . . . . . . . . 10 2.5. Channels . . . . . . . . . . . . . . . . . . . . . . . . . 104. TURN Framing Mechanism3. Terminology . . . . . . . . . . . . . . . . . . . .11 5.. . . . . 12 4. General Behavior . . . . . . . . . . . . . . . . . . . . . . .11 6.13 5. Managing Allocations . . . . . . . . . . . . . . . . . . . . .13 6.1.14 5.1. Client Behavior . . . . . . . . . . . . . . . . . . . . .13 6.1.1.14 5.1.1. Initial Allocate Requests . . . . . . . . . . . . . .13 6.1.2.14 5.1.2. Refresh Requests . . . . . . . . . . . . . . . . . . .14 6.2.15 5.2. Server Behavior . . . . . . . . . . . . . . . . . . . . .15 6.2.1. Initial16 5.2.1. Receiving an AllocateRequestsRequest . . . . . . . . . .15 6.2.2.. . 16 5.2.2. Refresh Requests . . . . . . . . . . . . . . . . . . .18 7. Sending20 6. Send andReceivingData Indications . . . . . . . . . . . . . . . . . .19 7.1. Client Behavior21 6.1. Forming and Sending an Indication . . . . . . . . . . . . 21 6.2. Receiving an Indication . . . . . . . . . . .19 7.1.1. Sending. . . . . . 22 6.3. Relaying . . . . . . . . . . . . . . . . .19 7.1.2. Receiving. . . . . . . . 22 7. Channel Mechanism . . . . . . . . . . . . . .20. . . . . . . . 23 7.1. Forming and Sending a ChannelBind Request . . . . . . . . 23 7.2.Server BehaviorReceiving a ChannelBind Request and Sending a Response . . 24 7.3. Receiving a ChannelBind Response . . . . . . . . . . . . . 25 7.4. The ChannelData Message . . . . . .20 7.2.1. Receiving Data from the Client. . . . . . . . . . . 25 7.5. Forming and Sending a ChannelData Message .20 7.2.2.. . . . . . . 25 7.6. ReceivingData from Peersa ChannelData Message . . . . . . . . . . . . . 26 7.7. Relaying .22 7.2.3. Allocation Activity Timer and Permission Timeout. . .23. . . . . . . . . . . . . . . . . . . . . 26 8. NewAttributesSTUN Methods . . . . . . . . . . . . . . . . . . . . . . . 27 9. New STUN Attributes . . . . .23 8.1.. . . . . . . . . . . . . . . . 27 9.1. CHANNEL-NUMBER . . . . . . . . . . . . . . . . . . . . . .23 8.2.28 9.2. LIFETIME . . . . . . . . . . . . . . . . . . . . . . . . .24 8.3.28 9.3. BANDWIDTH . . . . . . . . . . . . . . . . . . . . . . . .24 8.4.28 9.4. PEER-ADDRESS . . . . . . . . . . . . . . . . . . . . . . .24 8.5.28 9.5. DATA . . . . . . . . . . . . . . . . . . . . . . . . . . .24 8.6.28 9.6. RELAY-ADDRESS . . . . . . . . . . . . . . . . . . . . . .24 8.7.28 9.7. REQUESTED-PORT-PROPS . . . . . . . . . . . . . . . . . . .24 8.8.28 9.8. REQUESTED-TRANSPORT . . . . . . . . . . . . . . . . . . .25 8.9.30 9.9. REQUESTED-IP . . . . . . . . . . . . . . . . . . . . . . .26 9.30 10. New STUN Error Response Codes . . . . . . . . . . . . . . . .. . . 26 10.30 11. Client Discovery of TURN Servers . . . . . . . . . . . . . . .27 11.31 12. Security Considerations . . . . . . . . . . . . . . . . . . .27 12.32 13. IANA Considerations . . . . . . . . . . . . . . . . . . . . .29 12.1. New STUN Methods34 14. IAB Considerations . . . . . . . . . . . . . . . . . . . . .29 12.2. New STUN Attributes. 34 15. Example . . . . . . . . . . . . . . . . . .30 12.3. New STUN Response Codes. . . . . . . . . 34 16. Changes from Previous Versions . . . . . . . .30 13. IAB Considerations. . . . . . . . 35 16.1. Changes from -05 to -06 . . . . . . . . . . . . . .30 14. Example. . . 35 16.2. Changes from -04 to -05 . . . . . . . . . . . . . . . . . 35 17. Issues . . . . . . . . . .30 15. Changes since version -04. . . . . . . . . . . . . . . . . .35 16.37 17.1. Open Issues . . . . . . . . . . . . . . . . . . . . . . . 37 17.2. Closed Issues . . . . . . . . . . . . . . . . . . . . . . 39 18. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . .36 17.40 19. References . . . . . . . . . . . . . . . . . . . . . . . . . .36 17.1.40 19.1. Normative References . . . . . . . . . . . . . . . . . . .36 17.2.40 19.2. Informative References . . . . . . . . . . . . . . . . . .3640 Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . .3741 Intellectual Property and Copyright Statements . . . . . . . . . .3943 1. Introduction NOTE TO THE READER: This document is a work-in-progress. Please see the list of open and closed issues in Section 17. With only a few exceptions, if there is an open issue the text has NOT been updated in this area pending resolution of this issue - keep this in mind when reading the text. In addition, in the interest of getting the document out quickly in order to make progress on open issues, the authors have elected to release the document is a bit more "raw" state than they would prefer, resulting in some rough spots in the presentation. Session Traversal Utilities for NAT (STUN) [I-D.ietf-behave-rfc3489bis] provides a suite of tools for facilitating the traversal of NAT. Specifically, it defines the Binding method, which is used by a client to determine its reflexive transport address towards the STUN server. The reflexive transport address can be used by the client for receiving packets from peers, but only when the client is behind "good" NATs. In particular, if a client is behind a NAT whose mapping behavior [RFC4787] is address or address and port dependent (sometimes called "bad" NATs), the reflexive transport address will not be usable for communicating with a peer. The only way to obtain a UDP transport address that can be used for corresponding with a peer through such a NAT is to make use of a relay. The relay sits on the public side of the NAT, and allocates transport addresses to clients reaching it from behind the private side of the NAT. These allocated transport addresses are from IP addresses belonging to the relay. When the relay receives a packet on one of these allocated addresses, the relay forwards it toward the client. This specification defines an extension to STUN, called TURN, that allows a client to request an address on the TURN server, so that the TURN server acts as a relay. This extension defines a handful of new STUN methods. The Allocate method is the most fundamental component of this set of extensions. It is used to provide the client with a transport address that is relayed through the TURN server. A transport address which relays through an intermediary is called a relayed transport address. Though a relayed transport address is highly likely to work when corresponding with a peer, it comes at high cost to the provider of the relay service. As a consequence, relayed transport addresses should only be used as a last resort. Protocols using relayed transport addresses should make use of mechanisms to dynamically determine whether such an address is actually needed. One such mechanism, defined for multimedia session establishment protocols based on the offer/answer protocol in RFC 3264 [RFC3264], is Interactive Connectivity Establishment (ICE) [I-D.ietf-mmusic-ice]. Though originally invented for Voice over IP applications, TURN is designed to be a general-purpose relay mechanism for NAT traversal. 2.Terminology 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 [RFC2119]. Relayed Transport Address: A transport address that terminates on a server, and is forwarded towards the client. The TURN Allocate request can be used to obtain a relayed transport address, for example. TURN client: A STUN client that implements this specification. It obtains a relayed transport address that it provides to a small numberOverview ofpeers (usually one). TURN server: A STUN server that implements this specification. It relays data between a TURN client and its peer(s). Peer: A node with which the TURN client wishes to communicate. The TURN server relays traffic between the TURN client and its peer(s). Allocation: The IP address and port granted to a client throughOperation This section gives anAllocate request, along with related state, such as permissions and expiration timers. 5-tuple: A combinationoverview of thesource IP address and port, destination IP address and port, and transport protocol (UDP, or TCP). It uniquely identifies a TCP connection or bi-directional flow of UDP datagrams. Permission: A record of an IP address and transportoperation ofa peer thatTURN. It ispermitted to send traffic to the TURN client. The TURN server will only forward traffic to its client from remote peers that match an existing permission. 3. Overview of Operationnon- normative. In a typical configuration, a TURN client is connected to a private network [RFC1918] and through one or more NATs to the public Internet. On the public Internet is a TURN server. Elsewhere in the Internet are one or more peers that the TURN client wishes to communicate with.This specification defines a framing mechanism and several new STUN methods. Together, these add the ability for a STUN server to act as a packet relay. The framing mechanism serves two purposes. First, it contains a length field that allow TURN nodes to find the boundaries between chunks of application data when the communication with the TURN server is over a stream-based transport such as TCP. Second, it carries a channel number. Channel zero is used for TURN control messages, while the other channel numbers are used for application data traveling toThese peers may orfrom various peers. The channel number allows the client to know which peer sent data to it, and to specify which peer is tomay not bethe recipient of data. Application data flowing on any non-zero channel is unencapsulated, meaning that the application data starts immediately after the framing header. The framing header is just four bytes. This allows TURN to operate with minimal overhead, which is important for the real-time protocols it is designed to support. Application data can also flow in encapsulated format, meaning that it is carried in certain TURN messages on channel 0. Channel numbers are independent in each direction: for example, channel 5 might indicatebehind onepeer in the client to server direction, but a different peer in the server to client direction. When the client wants to obtain a relayed transport address, the client first sends an Allocate request to the server, which the server authenticates. The server generates an Allocate response with the allocated address, port, and target transport. All other STUN messages defined by this specification happen in the context of an allocation. A successful Allocate transaction just reserves a transport address on the TURN server. Data does not flow through an allocated transport address until the TURN client asks the TURN server to open a permission, which is done with a Send Indication. While the client can requestor morethan one permission per allocation, it needs to request each permission explicitly and one at a time. This insures that a client can't use a TURN server to run a traditional server, and partially protects the client from DoS attacks. Once a permission is open, the client can then receive data flowing back from its peer. Initially this data is encapsulated in a Data Indication. Since multiple permissions can be open simultaneously, the Data Indication contains the PEER-ADDRESS attribute so theNATs. +---------+ | | | | / | Peer A | Client's TURNclient knows which peer sent the data, and a CHANNEL-NUMBER attribute so the client knows how the server will refer to traffic from this peer when sent unencapsulated. Likewise when the client initially sends to a new peer, it uses a Send Indication with the peer address in the PEER-ADDRESS attribute, along with a channel number so the server knows how the client will refer to unencapsulated data to this peer.// | | Host Transport Server / | | Address Address +-+ // +---------+ 10.1.1.2:17240 192.0.2.15:3478 |N|/ 192.168.100.2:16400 | | |A| | +-+ | /|T| | | | | / +-+ v | | | / 192.0.2.210:18200 +---------+ | | |+---------+ / +---------+ | | |N| || | // | | | TURN | | | v| TURNpeer client server |--- Allocate Req -->||/ ||<-- Allocate Resp ---|| | Client |----|A|----------| Server |------------------| Peer B | ||--- Send (chan 2) -->| data| ||============>| |<-- ChannelConfirm --||^ | |^ ^| | |data| |T|| ||<============| |<-- Data (chan 5) ---||| || ||--- ChannelConfirm ->|+---------+ | || +---------+| |+---------+ | || | ||--- [2] + data ----->| data| || | | +-+| | ||============>|| |data| ||<============| |<-- [5] + data ------|| | Client's | Peer B Server-Reflexive Relayed Transport Transport Address Transport Address Address 192.0.2.1:7000 192.0.2.15:9000 192.0.2.210:18200 Figure1: Example Usage of Channels When the client and server communicate over UDP, data and control messages can arrive out of order. For1 Figure 1 shows a typical deployment. In thisreason,figure, the TURN clientneeds to verifyand the TURN serverknowsare separated by a NAT, with the clientchannel mapping beforeon theclient sends unencapsulated,private side and the serverneeds to verify the client knows the server channel mapping beforeon theserver sends unencapsulated. Whenpublic side of theclient and server communicate over UDP, a Channel Confirmation indicationNAT. This NAT issent after the Send (or Data) indication so the client (or server) knows thatassumed to be a "bad" NAT; for example, itcan send unencapsulated. Figure 1 demonstrates howmight have a mapping property of address-and-port-dependent mapping (see [RFC4787]) for a description of what thisworks.means). The clientperformshas allocated a local port on one of its addresses for use in communicating with the server. The combination of anAllocate Request,IP address andgetsaresponse. It decides to send data toport is called aspecific peer. Initially,TRANSPORT ADDRESS and since this (IP address, port) combination is located on the client and not on the NAT, it is called the client's HOST transport address. The client sendsdataTURN messages from its host transport address tothat peer usingaTURN Send indicationtransport address onchannel 0. That Send Indication tellsthe TURN serverthat, once confirmed,which is known as the TURN SERVER ADDRESS. The clientwill send data unencapsulated to that peer on channel 2. Wheneverlearns the server's address through some unspecified means (e.g., configuration), and this address is typically used by many clients simultaneously. The TURN serverreceives a Send indication, it storesaddress is used by themapping from channel numberclient topeer,send both commands andsends a ChannelConfirm indication (on channel 0). Oncedata to theconfirmation has been receivedserver; the commands are processed by theclient,TURN server, while theclient can senddatato the peeris relayed onchannel 2. Priortoreceipt oftheChannelConfirm, any other datapeers. Since the clientwishes to send tois behind a NAT, thepeerserver sees these packets as coming from a transport address on the NAT itself. This address is known as the client's SERVER-REFLEXIVE transport address; packets sentusing Send indications, all of which indicate that channel 2 isby the server to the client's server-reflexive transport address will beused for unencapsulated data. The same procedure happens from serverforwarded by the NAT toclient;the client's host transport address. The client uses TURNserver initially sends data usingcommands to allocate aData indicationRELAYED transport address, which is an transport address located onchannel 0,the server. The server ensures that there is a one-to-one relationship between the client's server-reflexive transport address andonce confirmed withthe relayed transport address; thus aChannelConfirm, itpacket received at the relayed transport address cansend it unencapsulated on its selected channel (channel 5 inbe unambiguously relayed by theexample). Over a reliable transport, such as TCP,server to theconfirmation step isclient. The client will typically communicate this relayed transport address to one or more peers through some mechanism notneeded so the Channel Confirmation indicationspecified here (e.g., an ICE offer or answer [I-D.ietf-mmusic-ice]). Once this isnot used. Clientsdone, peers canimmediatelysendthe next piece ofdata packets to thepeer onrelayed transport address and therequested channel. Allocations can also request specific attributes such asserver will forward them to thedesired Lifetime ofclient. In theallocation andreverse direction, themaximum Bandwidth. Clients can also request specific port assignment behavior, for example, a specific port number, odd or even port numbers, or pairs of sequential port numbers. 3.1. Transports TURN clientsclient cancommunicate with a TURNsend data packets to the serverusing UDP, TCP, or TLS over TCP. A(at its TURN servercan then relay traffic between a reliable transport used between the client and server (TCP or TLS over TCP),address) andUDP used fromthese will be forwarded by the server topeer. When relaying data sent from a stream-based protocol to a UDP peer,theTURN server emits datagrams which areappropriate peer, and thesame lengthpeer will see them as coming from thelength fieldrelayed transport address; in this direction, the client must specify the appropriate peer. 2.1. Transports TURNframing oras defined in this specification only allows thelengthuse ofthe DATA attribute in a Send Indication. Likewise, when aUDPdatagram is received bybetween theTURNserver andrelayed totheclient over a stream-based transport,peer. However, this specification allows thelengthuse ofthe datagram is the lengthany one of UDP, TCP, or TLS over TCP to carry the TURNframing or Data Indication's DATA attribute. The following table showsmessages between thepossible combinations of transport protocols fromclientto serverandfrom server to peer: +-----------------------+---------------------+the server. +----------------------------+---------------------+ | TURN client to TURN server | TURN server to peer |+-----------------------+---------------------++----------------------------+---------------------+ | UDP | UDP | | TCP | UDP | | TLS over TCP | UDP |+-----------------------+---------------------++----------------------------+---------------------+ For TURN clients, using TLS over TCP to communicate with the TURN server provides two benefits.When using TLS,First, the client can be assured that theaddressaddresses ofthe client'sits peers are not visible toan attacker except by traffic analysis downstream ofany attackers between it and theTURNserver. Second, the client may be able to communicate with TURN servers using TLS when it would not be able to communicate with the same server using TCP or UDP, due to theconfigurationpolicy of a firewall between the TURN client and its server. In this second case, TLS between the client and TURN serverin this case justfacilitates traversal.In addition, anThere is a planned extension to TURNis plannedto add support for TCPallocations [I-D.ietf-behave-turn-tcp]. 3.2. About Tuples To relay data tobetween the server andfromthecorrect location,peers [I-D.ietf-behave-turn-tcp]. For this reason, allocations that use UDP between theTURNservermaintains an associationand the peers are known as UDP allocations, while allocations that use TCP between the5-tuple used to communicate withserver and the peers are known as TCP allocations. This specification describes only UDP allocations. 2.2. Allocations To allocate a relayed transport address, the client uses an Allocate transaction. The client sends a Allocate Request to the server, and the5-tuple used to communicateserver replies witheach ofan Allocate Response containing theclient's peers.allocated relayed transport address. The5-tuple on theclientside will consistcan include attributes in the Allocate Request that describe the type of allocation it desires (e.g., theclient's reflexive address --lifetime of theapparent source address and portallocation). And since relaying data can require lots of bandwidth, the server may require that the client(typically as rewrittenauthenticate itself using STUN's long-term credential mechanism, to show that it is authorized to use the server. Once a relayed transport address is allocated, a client must keep the allocation alive. This is done by thelast NAT)--andclient periodically doing a Refresh transaction with thedestinationserver, where the client includes the allocated relayed transport addressand port used byin the Refresh Request. TURNserver. The figure below (Figure 2) showsdeliberately uses atypical topology. In this diagram,different method (Refresh rather than Allocate) for refreshes to ensure that the client5-tupleis informed if the allocation vanishes for some reason. The frequency of the Refresh transaction is determined by the lifetime of the allocation. The client can request aUDP flow between 192.0.2.1:7000lifetime in the Allocate Request and may modify its request in a Refresh Request, and192.0.2.15:3490.the server always indicates the actual lifetime in the response. The client must issue a new Refresh transaction within 'lifetime' seconds of the previous Allocate or Refresh transaction. If a client no longer wishes to use an Allocation, it should do a Refresh transaction with a requested lifetime of 0. Note that sending or receiving data from a peer DOES NOT refresh the allocation. The server remembers the 5-tuple used in the Allocate Request. Subsequent transactions between theTURN serverclient andPeer B isthe server use this same 5-tuple. In this way, the server knows which client owns the allocated relayed transport address. If the client wishes to allocate a second relayed transport address, it must use a different 5-tuple for this allocation (e.g., by using aUDP flow between 192.0.2.15:9000 (the TURN allocated address) and 192.0.2.210:18200.different client host address). While the terminology used in this document refers to 5-tuples, the TURN server can store whatever identifier it likes that yields identical results. Specifically, many implementationsmayuse afile-descriptorfile- descriptor in place of a 5-tuple to represent a TCP connection.+---------+ | | | | / | Peer2.3. Exchanging Data with Peers The client can use the relayed transport address to exchange data with its peers by using Send and Data indications. A| Client'sSend Indication is sent from a client to the TURN// | | Host Server / | | Address Address // +---------+ 10.1.1.2:17240 192.0.2.15:3490 / 192.0.2.180:16400 | | // | +-+ | / | | | | / v | | | // 192.0.2.210:18200 +---------+ | | |+---------+ / +---------+ |server and contains, in attributes inside the message, the transport address of the peer and the data to be sent to that peer. When the TURN server receives the Send Indication, it extracts the data from the Send Indication and sends it in a UDP datagram to the peer, using the allocated relay address as the source address. In the reverse direction, UDP datagrams arriving at the relay address on the TURN server are converted into Data Indications and sent to the client, with the transport address of the peer included in an attribute in the Data Indication. Note that a client can use a single relayed transport address to exchange data with multiple peers at the same time. TURN TURN Peer Peer client server A B |--- Allocate Req -->| ||N| |||//|<-- Allocate Resp ---| | | |TURN| | |v| TURN |/|--- Send (Peer A)--->| | | |Client |----|A|----------| Server |------------------| Peer B|=== data ===>| | | | ||^||^ ^|| |<== data ====| | |<-- Data (Peer A)----| ||T||||| |||+---------+||| +---------+| |+---------+|||| |--- Send (Peer B)--->| | |||| |=== data =================>| |+-+|| | | | |<== data ==================| |<-- Data (Peer B)----| | |Client's TURN Peer B Reflexive Allocated Transport Address Address Address 192.0.2.1:7000 192.0.2.15:9000 192.0.2.210:18200Figure 23.3. Keepalives SinceIn themain purpose of STUN and TURN isfigure above, the client first allocates a relayed transport address. It then sends data totraverse NATs, itPeer A using a Send Indication; at the server, the data isnaturalextracted and forwarded in a UDP datagram toconsider which elementsPeer A, using the relayed transport address as the source transport address. When a UDP datagram from Peer A is received at the relayed transport address, the contents areresponsible for generating sufficient periodic trafficplaced into a Data Indication and forwarded toinsurethe client. A similar exchange happens with Peer B. 2.4. Permissions To ease concerns amongst enterprise IT administrators thatNAT bindings stay alive.TURNclients need to send data frequently enoughcould be used tokeep both NAT bindings andbypass corporate firewall security, TURN includes the notion of permissions. TURNserverpermissionsfresh. Like NAT bindings,mimic the address-restricted filtering mechanism of NATs that comply with [RFC4787]. A TURN serverpermissions are refreshed by ordinary data trafficwill drop a UDP datagram arriving at a relayed transport address from a peer unless the client has recently sent data to a peer with thepeer. Unlike permissions, allocations onsame IP address (the port numbers can differ). See theTURN server have an explicit expiration time and need to benormative description for the precise definition of "recently". A permission will timeout if not refreshedexplicitlyperiodically. The client refreshes a permission by sending data to theclientcorresponding peer. Data received from the peer DOES NOT refresh the permission. 2.5. Channels In some applications, the overhead of using Send and Data indications can be substantial. For example, for applications like VoIP which utilize small packets, Send and Data Indications, with 36 bytes of overhead, can have a substantial impact on overall bandwidth usage. To remedy this, TURNRefresh request. Whenclients can assign a CHANNEL to a peer. Data to and from such a peer can then be sent using anallocation expires, all permissions associated withalternate packet format thatallocation are automatically deleted. 4. TURN Framing Mechanism Alladds only 4 bytes per packet of overhead. The alternate packet format is known as the ChannelData message. The ChannelData message does not use the STUN header used by other TURNcontrol messages and all application data sent betweenmessages, but instead has a 4-byte header that includes a number known as a channel number. To create a channel, the client sends a ChannelBind request to the server, and includes an unallocated channel number and the transport address of the peer. Once the client receives the response to the ChannelBind request, it can send data to that peer using a ChannelData message. Similarly, once the serverMUST start withhas received theTURN framing header. This header is used for two purposes: indicatingrequest, it can relay data from that peer towards the client using a ChannelData message. There is no way to modify channelnumber, andbindings, so once a channel is bound to a peer, it remains bound forframing. TURN usesthe lifetime of the allocation. When the server receives a ChannelData message from the client, it uses the channel number todistinguish control traffic from data,determine the destination peer and then forwards the data inside a UDP datagram todistinguish among multiple peers usingthesame allocation. Channelpeer. In the reverse direction, when a UDP datagram arives at the relayed transport address from that peer, the server inserts it into a ChannelData message containing the channel numberzero is reserved forbound to that peer; in this way the client can determine the peer that send the UDP datagram. TURNcontrol messages. AllTURNrequests, responses and indications betweenPeer Peer client server A B |--- Allocate Req -->| | | |<-- Allocate Resp ---| | | | | | | |--- Send (Peer A)--->| | | | |=== data ===>| | | | | | | |<== data ====| | |<-- Data (Peer A)----| | | | | | | |- ChannelBind Req -->| | | | (Peer A to 0x4001) | | | | | | | |<- ChannelBind Resp -| | | | | | | |-- [0x4001] data --->| | | | |=== data ===>| | | | | | | |<== data ====| | |<- [0x4001] data --->| | | | | | | |--- Send (Peer B)--->| | | | |=== data =================>| | | | | | |<== data ==================| |<-- Data (Peer B)----| | | Figure 3 The figure above shows the channel mechanism in use. The client begins by allocating a relayed transport address, andserver MUST be sent onthen uses that address to exchange data with Peer A. After a bit, the client decides to bind a channel0,to Peer A. To do this, it sends a ChannelBind Request to the server, specifying the transport address of Peer A andMUST NOT be sent on any other channel. Channel 0xFFFFa channel number (0x4001). After that, the client can send application data encapsulated inside ChannelData messages to Peer A: this isreserved for future use and MUST NOTshown as "[0x4001] data" where 0x4001 is the channel number. Note that ChannelData messages can only be usedby clients or servers compliantfor peers tothis specification. Other channel numberswhich the client has bound a channel. In the example above, Peer A has been bound to a channel, but Peer B has not, so application data to and from Peer B uses Send and Data indications. Channel bindings areassignedalways initiated by the client. 3. Terminology The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", andcommunicated"OPTIONAL" in this document are to be interpreted as described inSection 7. BecauseRFC 2119 [RFC2119]. Readers are expected to be familar with [I-D.ietf-behave-rfc3489bis] and theframing is always used,terms defined there. The following terms are used in this document: TURN: A protocol spoken between a TURNneedsclient and a TURN server. It is an extension torun onthe STUN protocol [I-D.ietf-behave-rfc3489bis]. The protocol allows aseparate port number from unframedclient to allocate and use a relayed transport address. TURN client: A STUNrequests. Over stream-based transports,client that implements this specification. TURN server: A STUN server that implements this specification. It relays data between a TURN client and its peer(s). Peer: A host with which the TURN client wishes to communicate. The TURN server relays traffic between the TURN client and its peer(s). The peer does not interact with the TURN serveralso need to include an explicit length so thatusing the protocol defined in this document; rather, the peer receives data sent by the TURN servercan perform conversion from streams to datagramsandvice versa.the peer sends data towards the TURNframing has a 2 octet channel number andserver. Host Transport Address: A transport address allocated on a2 octet length field. Over stream-based transports, the length field countshost. Server-Reflexive Transport Address: A transport address on thenumber"public side" ofoctets immediately after the length field itself. Over UDP the lengtha NAT. This address isalways setallocated by the NAT to correspond tozero. 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Channel Number | Length | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ Channel numbers are always defined within a particular allocation. Ifaclient has multiple allocationsspecific host transport address. Relayed Transport Address: A transport address that exists on a TURNserver, there is no relationship whatsoever between the channel numbers in each allocation. Once created,server. If achannel number persists for the lifetime ofpermission exists, packets that arrive at this address are relayed towards theallocation. There is no wayTURN client. Allocation: The transport address granted toexplicitly remove a channel. Consequently,a clientwhich obtainsthrough anallocationAllocate request, along with related state, such as permissions and expiration timers. See also Relayed Transport Address. 5-tuple: A combination of the source IP address and port, destination IP address and port, and transport protocol (UDP or TCP). A 5-tuple uniquely identifies a TCP connection or theintentbi- directional flow ofholding it for extremely long periods, possibly for communication with many different peers over time, may eventually exhaustUDP datagrams. Permission: The IP address and transport protocol (but not thesetport) ofchannels. Ina peer thatcase,is permitted to send traffic to theclientTURN server and have that traffic relayed to the TURN client. The TURN server willneedonly forward traffic toobtain a new allocation. 5.its client from peers that match an existing permission. 4. General Behavior After the initial Allocate transaction, all subsequent TURN transactions need to be sent in the context of a valid allocation. The source and destination IP address and ports for these TURN messages MUST match theinternal 5-tuple of an existing allocation.those used in the initial Allocate Request. These are processed using the general server procedures in [I-D.ietf-behave-rfc3489bis] with a few important additions. Forrequests (in this specification, the only subsequent request possible is a Refresh request),requests, if there is no matching allocation, the server MUST generate a 437 (Allocation Mismatch) error response. For indications, if there is no matching allocation, the indication is silently discarded. An Allocate request MUST NOT be sent by a client within the context of an existing allocation. Such a request MUST be rejected by the server with a 437 (Allocation Mismatch) error response. A subsequent request MUST be authenticated using the sameusernameusername, password and realm as the one used in the Allocate request that created the allocation. If the request was authenticated but not with the matching credential, the server MUST reject the request with a 401 (Unauthorized) error response. When a server returns an error response, it MAY include an ALTERNATE- SERVER attribute if it has positive knowledge that the problem reported in the error response will not be a problem on the alternate server. For example, a 443 response (Invalid IP Address) with an ALTERNATE-SERVER means that the other server is responsible for that IP address. A 442 (Unsupported Transport Protocol) with this attribute means that the other server is known to support that transport protocol. A 507 (Insufficient Capacity) means that the other server is known to have sufficient capacity. Using the ALTERNATE-SERVER mechanism in the 507 (Insufficient Capacity) response can only be done if the rejecting server has definitive knowledge of available capacity on the target. This will require some kind of state sharing mechanism between TURN servers, which is beyond the scope of this specification. If a TURN server attempts to redirect to another server without knowledge of available capacity, it is possible that all servers are in a congested state, resulting in series of rejections that only serve to further increase the load on the system. This can cause congestion collapse. If a client sends a request to a server and gets a 500 class error response without an ALTERNATE-SERVER, or the STUN transaction times out without a response, and the client was utilizing the SRV procedures of [I-D.ietf-behave-rfc3489bis] to contact the server, the client SHOULD try another server based on those procedures. However, the client SHOULD cache the fact that the request to this server failed, and not retry that server again for a configurable period of time. Five minutes is RECOMMENDED. TURN clients and servers MUST NOT include the FINGERPRINT attribute in any of the methods defined in this document.6.5. Managing Allocations Communications between a TURN client and a TURN serveron a new flowbegin with an Allocate transaction. All subsequent transactions happen in the context of thatallocation.allocation, and happen on the same 5-tuple. The client refreshes allocations and deallocates them using a Refresh transaction.6.1.5.1. Client Behavior6.1.1.5.1.1. Initial Allocate Requests When a client wishes to obtain a transport address, it sends an Allocate request to the server. This request is constructed and sent using the general procedures defined in [I-D.ietf-behave-rfc3489bis]. Clients MUST implement the long term credential mechanism defined in [I-D.ietf-behave-rfc3489bis], and be prepared for the server touse it.demand credentials for requests. The client SHOULD include a BANDWIDTH attribute, which indicates the maximum bandwidth that will be used with this binding. If the maximum is unknown, the attribute is not included in the request.OPEN ISSUE: Bandwidth is very much underspecified. Is anyone actually using it for capacity planning? If not we should remove.The client MAY request a particular lifetime for the allocation by including it in the LIFETIME attribute in the request. The client MUST include a REQUESTED-TRANSPORT attribute. In this specification, the REQUESTED-TRANSPORTwillMUST always be UDP. This attribute is included to allow for future extensions toTURN.TURN (e.g., [I-D.ietf-behave-turn-tcp]) The client MAY include a REQUESTED-PORT-PROPS or REQUESTED-IP attribute in the request to obtain specific types of transportaddresses. Whether these are needed depends on the application using the TURN server. As an example, the Real Time Transport Protocol (RTP) [RFC3550] requires that RTP and RTCP ports be an adjacent pair, even and odd respectively, for compatibility with a previous version of that specification. The REQUESTED-PORT-PROPS attribute allows the client to ask the relay for those properties.addresses, if desired. Processing of the response follows the general procedures of [I-D.ietf-behave-rfc3489bis]. A successful response will include both a RELAY-ADDRESS and an XOR-MAPPED-ADDRESS attribute, providing both a relayed transport address and a reflexive transport address, respectively, to the client. The value of the LIFETIME attribute in the response indicates the amount of time after which the server will expire the allocation, if not refreshed with a Refresh request. The server will allow the user to send and receive at least the amount of data indicated in the BANDWIDTH attribute per allocation. (At its discretion the server can optionally discard UDP data above this threshold.) If the response is an error response and contains a 442, 443 or 444 error code, the client knows that its requested properties could not be met. The client MAY retry with different properties, with the same properties (in a hope that something has changed on the server), or give up, depending on the needs of the application. However, if the client retries, it SHOULD wait 500ms, and if the request fails again, wait 1 second, then 2 seconds, and so on, exponentially backing off.6.1.2.5.1.2. Refresh Requests TURN permissions are kept alive by traffic flowing through them, and persist for the lifetime of the allocation. However, The allocations themselves have to be kept alive through Refresh Requests. Before 3/4 of the lifetime of the allocation has passed (the lifetime of the allocation is conveyed in the LIFETIME attribute of the Allocate Response), the client SHOULD refresh the allocation with a Refresh transaction if it wishes to keep the allocation. To perform a refresh, the client generates a Refresh Request. The client MUST use the same username, realm and password for the Refresh request as it used in its initial Allocate Request. The Refresh request MAY contain a proposed LIFETIME attribute. The client MAY include a BANDWIDTH attribute if it wishes to request more or less bandwidth than in the originalrequest.request (this might also be the first time the TURN client indicates bandwidth to the TURN server). If the BANDWIDTH attribute is absent, it indicates no change in the requested bandwidth from the Allocate request. The client MUST NOT include a REQUESTED-IP, REQUESTED-TRANSPORT, or REQUESTED-PORT-PROPS attribute in the Refresh request. In a successful response, the LIFETIME attribute indicates the amount of additional time (the number of seconds after the response is received) that the allocation will live without being refreshed. A successful response will also contain a BANDWIDTH attribute, indicating the bandwidth the server is allowing for this allocation. Note that an error response does not imply that the allocation has expired, just that the refresh has failed. If a client no longer needs an allocation, it SHOULD perform an explicit deallocation. If the client wishes to explicitly remove the allocation because it no longer needs it, it sends a Refresh request, but sets the LIFETIME attribute to zero. This will cause the server to remove the allocation, and all associated permissions and channel numbers. For connection-oriented transports such as TCP, the client can also remove the allocation (and all associated bindings) by closing the relevant connection with the TURN server.6.2.5.2. Server BehaviorThe server first processes the request according to the base protocol procedures in [I-D.ietf-behave-rfc3489bis], extended with the procedures for the long-term credential mechanism. 6.2.1. Initial5.2.1. Receiving an AllocateRequestsRequest When the server receives an Allocate request, the server attempts to allocate a relayed transport address.It first looks for the BANDWIDTH attribute in the request. If present,When the serverdetermines whether or notreceives the Allocate Request, ithas sufficientbegins by processing it according to the base protocol procedures described in [I-D.ietf-behave-rfc3489bis], plus the Long-Term Credential Mechanism procedures if the server is using this mechanism. It then checks if the 5-tuple used for the Allocate Request matches the 5-tuple used for an existing allocation. If there is a match, then: o If the transport protocol is UDP, and the transaction id in the request message matches the transaction id used for the original allocation, then the server treats this as a retransmission of the original request, and replies with the same response as it did to the original request. The server may do this by either storing its original response and resending it, or by rebuilding its original response from other state data. o If the transport protocol is not UDP, or if the transaction id in the request message does not match the transaction id used for the original allocation, then the server replies with an error response containing the error code 437 Allocation Mismatch. If the 5-tuple does not match an existing allocation, then processing continues as described below. 5.2.1.1. BANDWIDTH The server checks for the BANDWIDTH attribute in the request. If present, the server determines whether or not it has sufficient capacity to handle a binding that will generate the requested bandwidth. If it does, the server attempts to allocate a transport address for the client. The Allocate Request can contain several additional attributes that allow the client to request specific characteristics of the transport address.6.2.1.1.If it doesn't, it sends an error response. 5.2.1.2. REQUESTED-TRANSPORTFirst, theThe server checks for the REQUESTED-TRANSPORT attribute. This indicates the transport protocol requested by the client. This specification defines a value for UDP only, but support for TCP allocations is planned in [I-D.ietf-behave-turn-tcp]. As a consequence of the REQUESTED-TRANSPORT attribute, it is possible for a client to connect to the server over TCP or TLS over TCP and request a UDP transport address. In this case, the server will relay data between the transports. If the requested transport is supported, the server allocates a port using the requested transport protocol. If the REQUESTED-TRANSPORT attribute contains a value of the transport protocol unknown to the server, or known to the server but not supported by the server in the context of this request, the server MUST reject the request and include a 442 (Unsupported Transport Protocol) in the response. If the request did not contain a REQUESTED-TRANSPORT attribute, the server MUST use the same transport protocol as the request arrived on.6.2.1.2.5.2.1.3. REQUESTED-IPNext, theThe server checks for the REQUESTED-IP attribute. If present, it indicates a specific IP address from which the client would like its transport address allocated. (The client could do this if it requesting the second address in a specific port pair). If this IP address is not a valid one for allocations on the server, the server MUST reject the request and include a 443 (Invalid IP Address) error code in the response, or else redirect the request to a server that is known to support this IP address. If the IP address is one that is valid for allocations (presumably, the server is configured to know the set of IP addresses from which it performs allocations), the server MUST provide an allocation from that IP address. If the attribute is not present, the selection of an IP address is at the discretion of the server.6.2.1.3.5.2.1.4. REQUESTED-PORT-PROPSFinally, theThe server checks for the REQUESTED-PORT-PROPS attribute. If present, it indicates specific port properties desired by the client. This attribute is split into two portions: one portion for port behavior and the other for requested port alignment (whether the allocated port is odd, even, reserved as a pair, or at the discretion of the server). If the port behavior requested is for a Specific Port, the server MUST attempt to allocate that specific port for the client. If the specific port is not available (in use or reserved), the server MUST reject the request with a 444 (Invalid Port) response. For example, the STUN server could reject a request for a Specific Port because the port is temporarily reserved as part of an adjacent pair of ports, or because the requested port is a well-known port (1-1023). If the client requests "even" port alignment, the server MUST attempt to allocate an even port for the client. If an even port cannot be obtained, the server MUST reject the request with a 444 (Invalid Port) response or redirect to an alternate server. If the client requests odd port alignment, the server MUST attempt to allocate an odd port for the client. If an odd port cannot be obtained, the server MUST reject the request with a 444 (Invalid Port) response or redirect to an alternate server. Finally, the "Even port with hold of the next higher port" alignment is similar to requesting an even port. It is a request for an even port, and MUST be rejected by the server if an even port cannot be provided, or redirected to an alternate server. However, it is also a hint from the client that the client will request the next higher port with a separate Allocate request. As such, it is a request for the server to allocate an even port whose next higher port is also available, and furthermore, a request for the server to not allocate that one higher port to any other request except for one that asks for that port explicitly. The server can honor this request for adjacency at its discretion. The only constraint is that the allocated porthas tonumber MUST be even. Port alignment requests exist for compatibility with implementations of RTP which predateRFC 3550.[RFC3550]. These implementations use the port numbering conventions in (now obsolete)RFC 1889. 6.2.1.4.[RFC1889]. 5.2.1.5. Lifetime The server checks for a LIFETIME attribute. If present, it indicates the lifetime the client would like the server to assign to the allocation. If the LIFETIME attribute is malformed, or if the requested lifetime value is less than 32 seconds, the server replies with an error response with an error code of XXX Lifetime Malformed or Invalid. 5.2.1.6. Creating the Allocation If any of the requested or desired constraints cannot be met, whether it be bandwidth, transport protocol, IP address or port,instead of rejecting the request,the server canalternatelyredirect the client to a different server that may be able to fulfill the request. This is accomplished using the 300 error response and ALTERNATE-SERVER attribute. If the server does not redirect and cannot service the request because the server has reached capacity, it sends a 507 (Insufficient Capacity) response. The server can also reject the request with a 486 (Allocation Quota Reached) if the user or client is not authorized to request additional allocations. The server SHOULD only allocate portsinfrom the range1024-65535.49152 - 65535 (the Dynamic and/or Private Port range [Port-Numbers]), unless the TURN server application knows, through some means not specified here, that other applications running on the same host as the TURN server application will not be impacted by allocating ports outside this range. Thisis one of several wayscondition can often be satisfied by running the TURN server application on a dedicated machine and/or by arranging that any other applications on the machine allocate ports before the TURN server application starts. In any case, the TURN server SHOULD NOT allocate ports in the range 0 - 1023 (the Well-Known Port range) toprohibit relayed transport addressesdiscourage clients frombeing used to attemptusing TURN to run standard services. Once a port is allocated, the server associates the allocation with the 5-tuple used to communicate between the client and the server. For TCP, this amounts to associating the TCP connection from the TURN client with the allocated transport address. The new allocation MUST also be associated with the username, password and realm used to authenticate the request. These credentials are used in all subsequent requests to ensure that only the same client can use or modify the allocation it was given. In addition, the allocation created by the server is associated with a set ofpermissions. Each permission ispermissions and aspecific IP address identifying an external client. Initially, this listset of channel bindings. Each set isnull.initially empty. If the LIFETIME attribute was present in the request, and the value is larger than the maximum duration the server is willing to use for the lifetime of the allocation, the server MAY lower it to that maximum. However, the server MUST NOT increase the duration requested in the LIFETIME attribute. If there was no LIFETIME attribute, the server may choose a duration at its discretion. Ten minutes is RECOMMENDED. In either case, the resulting duration is added to the current time, and a timer, called the allocation expiration timer, is set tofireexpire at or after that time.Section 7.2.3 discusses behavior when the timer fires.Note that the LIFETIME attribute in an Allocate request can be zero, though this is effectively a no-op, since it will create and destroy the allocation in one transaction.6.2.1.5.5.2.1.7. Sending the Allocate Response Once the port has been obtained and the allocation expiration timer has been started, the server generates an Allocate Response using the general procedures defined in [I-D.ietf-behave-rfc3489bis], including the ones for long term authentication. The transport address allocated to the client MUST be included in the RELAY-ADDRESS attribute in the response. In addition, this response MUST contain the XOR-MAPPED-ADDRESS attribute. This allows the client to determine its reflexive transport address in addition to a relayed transport address, from the same Allocate request. The server MUST add a LIFETIME attribute to the Allocate Response. This attribute contains the duration, in seconds, of the allocation expiration timer associated with this allocation. The server MUST add a BANDWIDTH attribute to the Allocate Response. This MUST be equal to the attribute from the request, if one was present. Otherwise, it indicates a per-allocation limit that the server is placing on the bandwidth usage on each binding. Such limits are needed to prevent against denial-of-service attacks(See(see Section11). 6.2.2.12). 5.2.2. Refresh Requests A Refresh request is processed using the general server and long term authentication procedures in [I-D.ietf-behave-rfc3489bis]. It is used to refresh and extend an allocation, or to cause an immediate deallocation. It is processed as follows. First, the request MUST be authenticated using the same shared secret as the one associated with the allocation. If the request was authenticated but not with such a matching credential, the server MUST generate a Refresh Error Response with a 401 response. If the Refresh request contains a BANDWIDTH attribute, the server checks that it can relay the requested volume of traffic. Finally, a Refresh Request will set a new allocation expiration timer for the allocation, effectively canceling the previous allocation expiration timer. As with an Allocate request, the servercan offerMAY utilize a shorter allocation lifetime, butneverMUST NOT utilize a longerone.lifetime. A success Refresh response MUST contain a LIFETIMEattribute andattribute. If its associated Allocate request contained the BANDWIDTH attribute, or this Refresh request contained a new BANDWIDTH attribute, the response MUST also contain the BANDWIDTH attribute.7. Sending6. Send andReceivingDataAs described in Section 4,Indications TURNallows a clientsupports two ways to send and receive datawithout utilizing TURNfrom peers. This section describes the use of Send and Data indications,by sending and receiving them on channels. Before sending client-to-peer or peer- to-client data for a new peer, a TURN client or server needs to assign a channel number that corresponds to that remote peer. Once a channel number is assigned, it remains assigned throughwhile Section 7 describes thedurationuse of theallocation. It cannot be unassigned or reassigned to a different peer. 7.1. Client Behavior 7.1.1.Channel Mechanism. 6.1. Forming and Sending an Indication When the clientwants to forwardhas data to send to a peer, itchecks if it has assigneduses achannel number for communications with this peer (as identified by its IP address and port) over this allocation: o If one has not been assigned, the client assigns one of its own choosing. This channel number MUST be one that is currently unassigned by the client for this allocation. It MUST be between 1 and 65534. It is RECOMMENDED that the client choose one of the unassigned numbers randomly, rather than sequentially. The state of the channel is setSend Indication tounconfirmed. o If one has been assigned, that channel MUST be selected. Next,pass theclient checks if the channel number has been confirmed bydata to the server.IfWhen thechannel numberserver hasbeen confirmed, the client simply sends thedata to send to theTURN server with the appropriate channel number in the TURN framing. Ifclient, it uses a Data Indication to pass thechannel number has not been confirmed,data to the client. A clientcreatescan also use a Sendindication. It places the selected channel number inIndication without aCHANNEL- NUMBER attribute,DATA attribute to install or refresh a permission for thepeerspecified IPaddress and portaddress. Both indications are formed following the general rules described in [ref 3489bis] with the extra considerations described below. A Send Indication MUST contain a PEER-ADDRESSattribute,attribute andputs the data to be sent inMAY contain a DATAattribute. (If the client just wishes to createattribute, while apermission, it can omit the DATA attribute.) IfData Indication MUST contain both attributes. The PEER-ADDRESS attribute contains theSend indication is sent over a reliabletransport(ex: TCP), the client marks that the channel number as confirmed. When the client receives a ChannelConfirmation Indication, and the channel number, IPaddressand port matchof thechannel number assignedpeer tothat peer, the client marks thatwhich thechannel number is confirmed. Since Senddata isan Indication, it generates no response. The client must rely on application layer mechanismstodetermine ifbe sent (in the case of a Send Indication) or from which the data was receivedby(in thepeer. A ChannelConfirmation Indication just means that some Send indication was receivedcase of a Data Indication). This peer address is the transport address of the peer as seen by theTURN server. It doesserver, which may notmean that a specific Send indication was received bybe the same as the host transport address of the peer. The DATA attribute contains the actual application data. Note thatSend Indications are not authenticated and do not contain a MESSAGE-INTEGRITY attribute. Just like non-relayed data sent over UDP or TCP,theauthenticity and integrity of thisapplication datacan onlymay need to beassured using security mechanisms at higher layers. 7.1.2. Receiving Whenpadded to ensure theclient receivesDATA attribute length is aData indication, it: o recordsmultiple of 4. No other attributes are included. For example, neither thechannel number used byFINGERPRINT attribute nor any authentication attributes are included. The latter holds even if the server(fromis using theCHANNEL- NUMBER attribute) and associates it withLong-Term Credential Mechanism, since indications cannot be authenticated using this mechanism. Both theIP addressSend andportData indications MUST be sent using the 5-tuple of the original allocation. Thus, in thePEER-ADDRESS attribute, which identifycase of thepeer that sentSend Indication, thedata. The resulting mapping from channel number tosource transport addressMUST be stored by the client foris theduration ofclient's host transport address, theallocation. o deliversdestination transport address is thecontents ofTURN server address, and theDATA attribute totransport protocol is theclient applicationsame asif itwasreceived fromused for thepeer's IP address and port. o IfAllocate request. For the Dataindication was received over UDP,Indication, theclient MUST confirmsource and destination transport addresses are thechannel used byreverse. 6.2. Receiving an Indication When a Send Indication is received at the server,by sendingor aChannelConfirmationData Indicationtois received at theserver. Thisclient, the receiver first does the basic indication processing described in [3489bis]. Once this is done, it does the processing specific to the Send and Data methods described below. A Send Indication MUST containthe samea PEER-ADDRESS attribute andCHANNEL-NUMBERMAY contain a DATA attribute, while a Data Indication MUST contain both attributes. Any other attributesincludedappearing in the message are treated as unexpected. TODO: Add check that Send or Dataindication. Thisindicationis sent to the server on channel 0 using the 5-tuple associatedarrives with appropriate 5-tuple. Since thisallocation. Note that, duecheck applies toround trip delays, a client may receive severalall STUN messages, not just Send and Dataindications with the same channel number forindications, perhaps this goes under thesame remote peer. It MUST process each as defined here, resulting in several ChannelConfirmation indications.general processing section. 6.3. Relaying When theclientserver receivesunencapsulated data, it checks the received channel number. If the client hasamapping associated with the server channel numbervalid Send Indication contains a DATA attribute, itdelivers the data to the client applicationforms a UDP datagram asif it was received directly from that peer. Otherwise, it silently discards the data. 7.2. Server Behavior 7.2.1. Receiving Data fromfollows: o theClient Whensource transport address is theserver receives a Data indication fromrelayed transport address of theclient, it: o recordsallocation, where thechannel number usedallocation is determined by theclient (from5-tuple on which theCHANNEL- NUMBER attribute) and associates it withSend Indication arrived; o theIPdestination transport addressand port inis taken from the PEER-ADDRESSattribute, which identify the peer to whichattribute; o the data following the UDP header isto be sent. The resulting mapping from channel number to peer transport address MUST be stored bytheserver forcontents of thedurationvalue field of theallocation.DATA attribute; osendsthecontentsLength field in the UDP header is set to the Length field of the DATAattributeattribute; o the Checksum field inathe UDPdatagram, sending itheader is computed as described in [RFC 768]. The resulting UDP datagram is then sent to thePEER-ADDRESS and sending frompeer. When theallocated transport address. o if one doesn't exist, createsserver receives a valid Send Indication (with or without a DATA attribute), it also updates the permissionforassociated with the IP addressfromcontained in the PEER-ADDRESS(the portattribute. For a certain interval after the permission isignored),updated, UDP datagrams received from peers with source IP address equal to the IP address contained in the PEER-ADDRESS attribute can be forwarded to the client. Note that only the IP addresses are considered andattachesthe port numbers are irrelevent. This permission is specific to the allocationo checks if a timer has been set for this permission. If noneand hasbeen started,no affect on any other allocation. The recommended length of time is 60 seconds from when theserver starts one. ItSend Indication isRECOMMENDED that it have a value of sixty seconds. Ifreceived. When thetimerserver receives a UDP datagram with a destination transport address corresponding to an active (i.e., still alive) allocation, then it first checks to see if it isalready running,permitted to relay the datagram. If it is not permitted, the UDP datagram MUST bereset. odiscarded. Ifthe Send indication was received over UDP,relaying is permitted, the serverMUST confirm the channel used by the client, by sendingforms and send aChannelConfirmationData Indicationtoas described in Section 6.1, using theclient. This indication MUST containdata following thesame PEER-ADDRESS and CHANNEL-NUMBER attributes includedUDP header as the application data. 7. Channel Mechanism As described in theSend indication. This indication is sentoverview, channel mechanism provides a way for a client and server to send application data using ChannelData messages, which have less overhead than Send and Data indications. Channel bindings are always initiated by the client. The clientoncan bind a channel0 usingto a peer at any time during the lifetime of the5-tuple associated with thisallocation.Note that, dueThe client may bind a channel toround trip delays,aserver may receive several Send indicationspeer before exchanging data withthe same channel numberit, or after exchanging data with it (using Send and Data indications) for some time, or may choose never to bind a channel it. The client can also bind channels to some peers while not binding channels to other peers. Once a channel is bound to a peer, thesame remotechannel binding cannot be changed. There is no way to unbind a channel or bind it to a different peer.It MUST process each as defined here, resultingChannel bindings are specific to an allocation, so that a binding inseveral ChannelConfirmation indications.one allocation has no relationship to a binding in any other allocation. If an allocation expires, all its channel bindings expire with it. 7.1. Forming and Sending a ChannelBind Request Whenthe server receives unencapsulated data,a client wishes to bind a channel to a peer in an allocation, itchecksforms a ChannelBind Request. The Request formed following thereceived channel number: o Ifgeneral rules described in [I-D.ietf-behave-rfc3489bis] with theserver hasextra considerations described below. A ChannelBind Request MUST contain both amapping associated withCHANNEL-NUMBER attribute and a PEER-ADDRESS attribute. The CHANNEL-NUMBER attribute specifies the number of the channel that the client wishes to bind to the peer. The channel numberit: * sendsMUST be in the range 0x4000 to 0xFFFE (inclusive) and the channel MUST NOT be already bound to aUDP datagramdifferent peer. It is acceptable to rebind a channel to the peerusingit is already bound to. The PEER-ADDRESS attribute specifies thetransportpeer addressfromto bind themapping, and sends fromchannel to. Once formed, theallocated transport address. * checks if a permission activity timerChannelBind Request isrunningsent using the 5-tuple for thedestination IP address ofallocation. The client SHOULD be prepared to receive ChannelData messages on thepeer. If one is not running,channel as soon as it has sent theserver starts one. ItChannelBind Request. Over UDP, it isRECOMMENDED thatpossible for the client to receive these before ithavereceives avalue of sixty seconds. IfChannelBind Success Response. Over UDP, thetimer is already running, it MUST be reset. o Ifclient SHOULD NOT send ChannelData messages on theserver has no mapping,channel until itsilently discardshas received a ChannelBind Success Response for thedata. 7.2.2.binding attempt. Sending them before the success response is received risks having them dropped by the server if he ChannelBind Request was lost. 7.2. ReceivingData from Peers Ifa ChannelBind Request and Sending a Response When the server receives aUDP packet on an allocated UDP transport address,ChannelBind Request, itchecksfirst does thepermissions associated withbasic request processing described in [I-D.ietf-behave-rfc3489bis]. Once this is done, it does the processing specific to the ChannelBind method described below. The server checks thatallocation.the ChannelBind Request contains both a CHANNEL-NUMBER attribute and a PEER-ADDRESS attribute. If thesource IPPEER- ADDRESS attribute is missing or malformed, then the server rejects the request with an Error Response containing the error code XXX "Peer addressofmissing or invalid". If theUDP packet matches one ofCHANNEL-NUMBER attribute is missing or malformed, or thepermissions (the source portchannel number is notused),in theUDP packet is accepted. Otherwise, itrange 0x4000 to 0xFFFE (inclusive), or the channel isdiscarded. Ifalready bound to another peer (already bound to thepacketsame peer isaccepted,OK) the server rejects the request with an Error Response containing the error code XXX "Channel number missing or invalid". Otherwise, if no errors are detected, the server replies with a ChannelBind Success Response. 7.3. Receiving a ChannelBind Response When the client receives a ChannelBind response (either success or error), it processes it as specified in [3489bis]. Any additional processing isforwardedimplementation specific. 7.4. The ChannelData Message The ChannelData message is used to carry application data between the clientas described below. The server checks if itand the server. It hasassigned a channelthe following format: 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Channel Number | Length | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | | / Application Data / / / | | | +-------------------------------+ | | +-------------------------------+ The Channel Number field specifies the numberfor communications from this peer (as identified by its IP addressof the channel on which the data is traveling, andport) over this allocation: o If one has not been assigned,thus theclient assigns oneaddress ofits own choosing. Thisthe peer that is sending or is to receive the data. The channel number MUST beone that is currently unassigned byin theserverrange 0x4000 - 0xFFFF, with channel number 0xFFFF being reserved forthis allocation. It MUSTpossible future extensions. Channel numbers 0x0000 - 0x3FFF cannot bebetweenused because bits 0 and 1 are used to distinguish ChannelData messages from STUN-formatted messages (i.e., Allocate, Send, Data, ChannelBind, etc). STUN- formatted messages always have bits 0 and65534. It is RECOMMENDED that1 as "00", while ChannelData messages use combinations "01", "10", and "11". The Length field specifies theserver choose onelength in bytes of theunassigned numbers randomly, rather than sequentially. The stateapplication data field (i.e., it does not include the size of thechannel is set to unconfirmed. o If one has been assigned, that channel MUST be selected.ChannelData header). Note that 0 is a valid length. The Application Data field carries the datafrom peers does not resetthepermission activity timer. Next,client is trying to send to theserver checks ifpeer, or that thechannel number has been confirmed bypeer is sending to the client.If the channel number7.5. Forming and Sending a ChannelData Message Once a client hasbeen confirmed, the server simply sendsbound a channel to a peer, then when the client has data to send to that peer it may use either a ChannelData message or a Send Indication; that is, the clientwithis not obligated to use theappropriatechannelnumber inwhen it exists and may freely intermix theTURN framing. Iftwo message types when sending data to the peer. The server, on the other hand, SHOULD use the ChannelData message if a channelnumberhasnotbeenconfirmed,bound to theserver creates a Data indication. It placespeer. The fields of theselected channel numberChannelData message are filled in as described in Section 7.4. Over stream transports, the ChannelData message MUST be padded to aCHANNEL- NUMBER attribute,multiple of four bytes in order to ensure thepeer IP address and portalignment of subsequent messages. The padding is not reflected ina PEER-ADDRESS attribute, and putsthedatalength field of the ChannelData message, so the actual size of a ChannelData message (including padding) is (4 + Length) rounded up to the nearest multiple of 4. Over UDP, the padding is not required but MAY be included. The ChannelData message is then sent on the 5-tuple associated with the allocation. 7.6. Receiving a ChannelData Message The receiver of the ChannelData message uses bits 0 and 1 to distinguish it from STUN-formatted messages, as described in Section 7.4. If the ChannelData message is received in aDATA attribute.UDP datagram, and if the UDP datagram is too short to contain the claimed length of the ChannelData message (i.e., the UDP header length field value is less than the ChannelData header length field value + 4 + 8), then the message is silently discarded. If theData indicationChannelData message issentreceived overa reliable transport (ex: TCP),TCP or over TLS over TCP, then theserver marks thatactual length of thechannel numberChannelData message is asconfirmed.described in Section 7.5. If the ChannelData message is received on a channel which is not bound to any peer, then the message is silently discarded. 7.7. Relaying When the server receives aChannelConfirmation Indication, andvalid ChannelData message, it forms a UDP datagram as follows: thechannel number, IPsource transport addressand port matchis thechannel number assigned to that peer,relayed transport address of theserver marks thatallocation, where thechannel number is confirmed. Since Dataallocation isan Indication, it generates no response. The server does not provide reliability fordetermined by thedata. When sending over a reliable transport to5-tuple on which theclient, ifChannelData message arrived; theserverdestination transport address isunablethe peer address tosendwhich thedata received fromchannel is bound; thepeer (for example, becausedata following theTCP connection cannot accept any more messages right now), it can silently discardsUDPdata received fromheader is the contents of thepeer. Note that Send Indications are not authenticated and do not contain a MESSAGE-INTEGRITY attribute. Just like non-relayeddatasent overfield of the ChannelData message; the Length field in the UDPor TCP,header is set to theauthenticity and integrityLength field ofthis data can only be assured using security mechanisms at higher layers. 7.2.3. Allocation Activity Timerthe ChannelData message + 8; andPermission Timeout Whentheallocation activity timer expires,Checksum field in theserver MUST destroyUDP header is computed as described in [RFC 768]. The resulting UDP datagram is then sent to theallocation. This involves freeingpeer. The server also updates theallocated transport address, deleting permissions and channel numbers, and removing other statepermission associated with theallocation.IP address part of the peer address to which the UDP datagram is sent. Whena permission times out,theTURNserverMUST NOT forwardreceives apacket from that TURN peerUDP datagram with a destination transport address corresponding to an active (i.e., still alive) allocation, then it first checks to see if it is permitted to relay theTURN client.datagram. If the allocation contains an active permission for the source IP address (from the IP header) of the received UDP datagram, then the UDP datagram is permitted. Otherwise, the UDP datagram MUST be discarded. To relay the UDP datagram, the server forms and send a ChannelData message as described in Section 7.5 8. New STUN Methods This section lists the codepoints for the new STUN methods defined in this specification. See elsewhere in this document for the semantics of these new methods. Request/Response Transactions 0x003 : Allocate 0x004 : Refresh Indications 0x006 : Send 0x007 : Data 9. New STUN Attributes This STUN extension defines the following new attributes: 0x000C: CHANNEL-NUMBER 0x000D: LIFETIME 0x0010: BANDWIDTH 0x0012: PEER-ADDRESS 0x0013: DATA 0x0016: RELAY-ADDRESS 0x0018: REQUESTED-PORT-PROPS 0x0019: REQUESTED-TRANSPORT 0x0022: REQUESTED-IP8.1.9.1. CHANNEL-NUMBER Thechannel numberCHANNEL-NUMBER attributerepresentscontains thechannelnumberassigned by the sender, that corresponds with the peer specified inof thePEER- ADDRESS attribute.channel. It is a 16-bit unsigned integer,plus two octets of paddingfollowed by a two-octet RFFU field which MUST be set tozero.0 on transmission and ignored on reception. 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Channel Number |Reserved = 0RFFU | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+8.2.9.2. LIFETIME The lifetime attribute represents the duration for which the server will maintain an allocation in the absence of a refresh. It is a 32 bit unsigned integral value representing the number of seconds remaining until expiration.8.3.9.3. BANDWIDTH The bandwidth attribute represents the peak bandwidth, measured in kilobits per second, that the client expects to use on the allocation in each direction.8.4.9.4. PEER-ADDRESS The PEER-ADDRESS specifies the address and port of the peer as seen from the TURN server. It is encoded in the same way as XOR-MAPPED- ADDRESS.8.5.9.5. DATA The DATA attribute is present in most Send Indications and Data Indications. It contains raw payload data that is to be sent (in the case of a Send Request) or was received (in the case of a Data Indication).8.6.9.6. RELAY-ADDRESS The RELAY-ADDRESS is present in Allocate responses. It specifies the address and port that the server allocated to the client. It is encoded in the same way as XOR-MAPPED-ADDRESS.8.7.9.7. REQUESTED-PORT-PROPS This attribute allows the client to request certain properties for the port that is allocated by the server. The attribute can be used with any transport protocol that has the notion of a 16 bit port space (including TCP and UDP). The attribute is 32 bits long. Its format is: 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Reserved = 0 | A | Specific Port Number | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ The two bits labeled A in the diagram above are for requested port alignment and have the following meaning: 00 no specific port alignment 01 odd port number 10 even port number 11 even port number; reserve next higher port If the value of the A field is 00 (no specific port alignment), then the Specific Port Number field can either be 0 or some non-zero port number. If the Specific Port Number field is 0, then the client is not putting any restrictions on the port number it would like allocated. If the Specific Port Number is some non-zero port number, then the client is requesting that the server allocate the specified port and the server MUST provide that port. If the value of the A field is 01 (odd port number), then the Specific Port Number fieldmustMUST be zero, and the client is requesting the server allocate an odd-numbered port. The server MUST provide an odd port number. If the value of the A field is 10 (even port number), then the Specific Port number fieldmustMUST be zero, and the client is requesting the server allocate an even-numbered port. The server MUST provide an even port number. If the value of the A field is 11 (even port number; reserve next higher port), then the Specific Port Number fieldmustMUST be zero, and the client is requesting the server allocate an even-numbered port. The server MUST return an even port number. In addition, the client is requesting the server reserve the next higher port (i.e., N+1 if the server allocates portN), and shouldN). The server SHOULD only allocate the N+1 port number if it isexplicitexplicitly requested (with a subsequent request specifying that exact portnumber)number by the same TURN client, over a different alllocation). In all cases, if a port with the requested properties cannot be allocated, the serverrespondsMUST respond with a error response with an error code of 444 (Invalid Port).8.8.9.8. REQUESTED-TRANSPORT This attribute is used by the client to request a specific transport protocol for the allocated transport address. Itis a 32 bit unsigned integer. Its values are: 0x0000 0000: UDP 0x0000 0001: Reserved for TCP If an Allocate request is sent over TCP and requests a UDP allocation, or an Allocate request is sent over TLS over TCPhas the following format: 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 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Protocol | RFFU | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ The Protocol field specifies the desired protocol. The codepoints used in this field are taken from those allowed in the Protocol field in the IPv4 header andrequests a UDP allocation,theserver will relay data betweenNextHeader field in thetwo transports. ExtensionsIPv6 header [Protocol-Numbers]. This specification only allows the use of codepoint 17 (User Datagram Protocol). The RFFU field is set toTURN can define additional transport protocols in an IETF-consensus RFC. 8.9.zero on transmission and ignored on receiption. It is reserved for future uses. 9.9. REQUESTED-IP The REQUESTED-IP attribute is used by the client to request that a specific IP address be allocatedto it.by the TURN server. This attribute is needed since it is anticipated that TURN servers will bemulti-homedmulti- homed so as to be able to allocate more than 64k transport addresses. As a consequence, a client needing a second transport address on the same interface as a previous one canmake that request.use this attribute to request a remote address from the same TURN server interface as the TURN client's previous remote address. The format of this attribute is identical to XOR-MAPPED-ADDRESS. However, the port component of the attributeisMUST be ignored by the server. If a client wishes to request a specific IP address and port, it uses both the REQUESTED-IP and REQUESTED-PORT-PROPS attributes.9.10. New STUN Error Response Codes This document defines the following newErrorerror response codes: 437 (Allocation Mismatch): A request was received by the server that requires an allocation to be in place, but there is none, or a request was received which requires no allocation, but there is one. 442 (Unsupported Transport Protocol): The Allocate request asked for a transport protocol to be allocated that is not supported by the server. If the server is aware of another server that supports the requested protocol, it SHOULD include the other server's address in an ALTERNATE-SERVER attribute in the error response. 443 (Invalid IP Address): The Allocate request asked for a transport address to be allocated from a specific IP address that is not valid on the server. 444 (Invalid Port): The Allocate request asked for a port to be allocated that is not available on the server. 486 (Allocation Quota Reached): The user or client is not authorized to request additional allocations. (tbd) (Channel Number Missing or Invalid): The request requires a channel number, but the CHANNEL-NUMBER attribute is missing, or the specified channel number is invalid in some way. (tbd) (Peer Address Missing or Invalid): The request requires a peer transport address, but the PEER-ADDRESS attribute is missing, or the specified peer transport address is invalid in some way. (tbd) (Lifetime Malformed or Invalid): The LIFETIME attribute is malformed or the specified lifetime is invalid in some way. 507 (Insufficient Capacity): The server cannot allocate a new port for this client as it has exhausted its relay capacity.10.11. Client Discovery of TURN Servers The STUN extensions introduced by TURN differ from the binding requests defined in [I-D.ietf-behave-rfc3489bis] in that they are sent with additional framing and demand substantial resources from the TURN server. In addition, it seems likely that administrators might want to block connections from clients to the TURN server for relaying separately from connections for the purposes of binding discovery. As a consequence, TURN runs on a separate port from STUN. The client discovers the address and port of the TURN server using the same DNS procedures defined in [I-D.ietf-behave-rfc3489bis], but using an SRV service name of "turn" (or "turns" for TURN over TLS) instead of just "stun". For example, to find TURN servers in the example.com domain, the TURN client performs a lookup for '_turn._udp.example.com', '_turn._tcp.example.com', and '_turns._tcp.example.com' if the STUN client wants to communicate with the TURN server using UDP, TCP, or TLS over TCP, respectively.11.12. Security Considerations TURN servers allocate bandwidth and port resources to clients, in contrast to the Binding method defined in [I-D.ietf-behave-rfc3489bis]. Therefore, a TURN server requires authentication and authorization of STUN requests. This authentication is provided by mechanisms defined in the STUN specification itself, in particular digest authentication. Because TURN servers allocate resources, they can be susceptible to denial-of-service attacks. All Allocate transactions are authenticated, so that an unknown attacker cannot launch an attack. An authenticated attacker can generate multiple Allocate Requests, however. To prevent a single malicious user from allocating all of the resources on the server, it is RECOMMENDED that a server implement a modest per user limit on the amount of bandwidth that can be allocated. Such a mechanism does not prevent a large number of malicious users from each requesting a small number of allocations. Attacks such as these are possible using botnets, and are difficult to detect and prevent. Implementors of TURN should keep up with best practices around detection of anomalous botnet attacks. A client will use the transport address learned from the RELAY- ADDRESS attribute of the Allocate Response to tell other users how to reach them. Therefore, a client needs to be certain that this address is valid, and will actually route to them. Such validation occurs through the message integrity checks provided in the Allocate response. They can guarantee the authenticity and integrity of the allocated addresses. Note that TURN is not susceptible to the attacks described in Section 12.2.3, 12.2.4, 12.2.5 or 12.2.6 of [I-D.ietf-behave-rfc3489bis] [[TODO: Update section number references to 3489bis]]. These attacks are based on the fact that a STUN server mirrors the source IP address, which cannot be authenticated. STUN does not use the source address of the Allocate Request in providing the RELAY-ADDRESS, and therefore, those attacks do not apply. TURN cannot be used by clients for subverting firewall policies. TURN has fairly limited applicability, requiring a user to explicitly authorize permission to receive data from a peer, one IP address at a time. Thus, it does not provide a general technique for externalizing sockets. Rather, it has similar security properties to the placement of an address-restricted NAT in the network, allowing messaging in from a peer only if the internal client has sent a packet out towards the IP address of that peer. This limitation means that TURN cannot be used to run web servers, email servers, SIP servers, or other network servers that service a large number of clients. Rather, it facilitates rendezvous of NATted clients that use some other protocol, such as SIP, to communicate IP addresses and ports for communications. Confidentiality of the transport addresses learned through Allocate transactions does not appear to be that important. If required, it can be provided by running TURN over TLS. TURN does not and cannot guarantee that UDP data is delivered in sequence or to the correct address. As most TURN clients will only communicate with a single peer, the use of a single channel number will be very common. Consider an enterprise where Alice and Bob are involved in separate calls through the enterprise NAT to their corporate TURN server. If the corporate NAT reboots, it is possible that Bob will obtain the exact NAT binding originally used by Alice. If Alice and Bob were using identical channel numbers, Bob will receive unencapsulated data intended for Alice and will send data accidentally to Alice's peer. This is not a problem with TURN. This is precisely what would happen if there was no TURN server and Bob and Alice instead provided a (STUN) reflexive transport address to their peers. If detecting this misdelivery is a problem, the client and its peer need to use message integrity on their data. One TURN-specific DoS attack bears extra discussion. An attacker who can corrupt, drop, or cause the loss of a Send or Data indication sent over UDP, and then forge a Channel Confirmation indication for the corresponding channel number, can cause a TURN client (server) to start sending unencapsulated data that the server (client) will discard. Since indications are not integrity protected, this attack is not prevented by cryptographic means. However, any attacker who can generate this level of network disruption could simply prevent a large fraction of the data from arriving at its destination, and therefore protecting against this attack does not seem important. The ChannelConfirmation forging attack is not possible when the client to server communication is over TCP or TLS over TCP. Relay servers are useful even for users not behind a NAT. They can provide a way for truly anonymous communications. A user can cause a call to have its media routed through a TURN server, so that the user's IP addresses are never revealed. Any relay addresses learned through an Allocate request will not operate properly with IPSec Authentication Header (AH) [RFC4302] in transport or tunnel mode. However, tunnel-mode IPSec ESP [RFC4303] should still operate.12.13. IANA ConsiderationsThis specification defines several newSince TURN is an extension to STUN [I-D.ietf-behave-rfc3489bis], the methods,STUNattributes and error codes defined in this specification are new method, attributes, andSTUN response codes.error codes for STUN. This section directs IANA to add these new protocol elements to the IANA registry of STUN protocol elements.12.1. NewThe codepoints for the new STUNMethods Request/Response Transactions 0x003 : Allocate 0x004 : Refresh Indications 0x006 : Send 0x007 : Data 0x009 : Channel Confirmation 12.2. Newmethods defined in this specification are listed in Section 8. The codepoints for the new STUNAttributes 0x000C: CHANNEL-NUMBER 0x000D: LIFETIME 0x0010: BANDWIDTH 0x0012: PEER-ADDRESS 0x0013: DATA 0x0016: RELAY-ADDRESS 0x0018: REQUESTED-PORT-PROPS 0x0019: REQUESTED-TRANSPORT 0x0022: REQUESTED-IP 12.3. Newattributes defined in this specification are listed in Section 9. The codepoints for the new STUNResponse Codes 437 Allocation Mismatch 442 Unsupported Transport Protocol 443 Invalid IP Address 444 Invalid Port 486 Allocation Quota Reached 507 Insufficient Capacity 13.error codes defined in this specification are listed in Section 10. Extensions to TURN can be made through IETF consensus. 14. IAB Considerations The IAB has studied the problem of "Unilateral Self Address Fixing", which is the general process by which a client attempts to determine its address in another realm on the other side of a NAT through a collaborative protocol reflection mechanismRFC 3424[RFC3424]. The TURN extension is an example of a protocol that performs this type of function. The IAB has mandated that any protocols developed for this purpose document a specific set of considerations. TURN is an extension of the STUN protocol. As such, the specific usages of STUN that use the TURN extensions need to specifically address these considerations. Currently the only STUN usage that uses TURN is ICE [I-D.ietf-mmusic-ice].14.15. ExampleIn this example, a TURN client is behind a NAT. This TURN client is running SIP. The client has a private address of 10.0.1.1. The TURN server is on the public side of the NAT, and is listening for TURN requests on 192.0.2.3:8776. The public side of the NAT has an IP address of 192.0.2.1. The client is attempting to send a SIP INVITE to a peer, and wishes to allocate an IP address and port for inclusion in the SDP of the INVITE. Normally, TURN would be used in conjunction with ICE when appliedTBD 16. Changes from Previous Versions Note toSIP. However,RFC Editor: Please remove this section prior tokeep the example simple, TURN is shown without ICE. The client communicates with a SIP user agent on the public network. This user agent uses a 192.0.2.17:12734 for receiptpublication ofits RTP packets. 10.0.1.1 192.0.2.1 192.0.2.3 192.0.2.17 Client NAT TURN Server Peer | | | | |(1) Allocate |(2) Allocate | | |S=10.0.1.1:4334 |S=192.0.2.1:63346 | | |D=192.0.2.3:8776 |D=192.0.2.3:8776 | | |------------------>|------------------>| | | | | | |(4) Error |(3) Error | | |S=192.0.2.3:8776 |S=192.0.2.3:8776 | | |D=10.0.1.1:4334 |D=192.0.2.1:63346 | | |<------------------|<------------------| | | | | | |(5) Allocate |(6) Allocate | | |S=10.0.1.1:4334 |S=192.0.2.1:63346 | | |D=192.0.2.3:8776 |D=192.0.2.3:8776 | | |------------------>|------------------>| | | | | | | | (allocates port 32766) | | | | | | | | | |(8) Response |(7) Response | | |RA=192.0.2.3:32766 |RA=192.0.2.3:32766 | | |MA=192.0.2.1:63346 |MA=192.0.2.1:63346 | | |S=192.0.2.3:8776 |S=192.0.2.3:8776 | | |D=10.0.1.1:4334 |D=192.0.2.1:63346 | | |<------------------|<------------------| | | | | | |(9) SIP INVITE | | | |SDP=192.0.2.3:32766| | | |---------------------------------------------------------->| | | | | |(10) SIP 200 OK | | | |SDP=192.0.2.17:12734 | | |<----------------------------------------------------------| | | | | | | |(11) RTP | | | |S=192.0.2.17:12734 | | | |D=192.0.2.3:32766 | | | |<------------------| | | | | | | (no permission; packet dropped) | | | | | |(12) SIP ACK | | | |---------------------------------------------------------->| | | | | |(13) Send Indic. |(14) Send Indic. | | |TURN Channel=0 |TURN Channel=0 | | |STUN DATA=RTP |STUN DATA=RTP | | |CHANNEL-NUMER=77 |CHANNEL-NUMBER=77 | | |PA=192.0.2.17:12734|PA=192.0.2.17:12734| | |S=10.0.1.1:4334 |S=192.0.2.1:63346 | | |D=192.0.2.3:8776 |D=192.0.2.3:8776 | | |------------------>|------------------>| | | | | | | | permission created | | | | | | | |(15) RTP | | | |S=192.0.2.3:32766 | | | |D=192.0.2.17:12734 | | | |------------------>| | | | | |(17) ChannelConf |(16) ChannelConf | | |TURN Channel=0 |TURN Channel=0 | | |CHANNEL-NUMBER=77 |CHANNEL-NUMBER=77 | | |PA=192.0.2.17:12734|PA=192.0.2.17:12734| | |S=192.0.2.3:8776 |S=192.0.2.3:8776 | | |D=10.0.1.1:4334 |D=192.0.2.1:63346 | | |<------------------|<------------------| | | | | | |(18) TURN Framed |(19) TURN Framed | | |TURN Channel=77 |TURN Channel=77 |(20) RTP | |S=10.0.1.1:4334 |S=192.0.2.1:63346 |S=192.0.2.3:32766 | |D=192.0.2.3:8776 |D=192.0.2.3:8776 |D=192.0.2.17:12734 | |------------------>|------------------>|------------------>| | | | | |(23) Data Indic. |(22) Data Indic. | | |TURN Channel=0 |TURN Channel=0 | | |CHANNEL-NUMBER=33 |CHANNEL-NUMBER=33 |(21) RTP | |S=192.0.2.3:8776 |S=192.0.2.3:8776 |S=192.0.2.17:12734 | |D=10.0.1.1:4334 |D=192.0.2.1:63346 |D=192.0.2.3:32766 | |<------------------|<------------------|<------------------| | | | | |(24) ChannelConf |(25) ChannelConf | | |TURN Channel=0 |TURN Channel=0 | | |CHANNEL-NUMBER=33 |CHANNEL-NUMBER=33 | | |S=10.0.0.1:4334 |S=192.0.2.3:8776 | | |D=192.0.2.3:8776 |D=192.0.2.3:8776 | | |------------------>|------------------>| | | | | | |(28) TURN Framed |(27) TURN Framed | | |TURN Channel=33 |TURN Channel=33 |(26) RTP | |S=192.0.2.3:8776 |S=192.0.2.3:8776 |S=192.0.2.17:12734 | |D=10.0.1.1:4334 |D=192.0.2.1:63346 |D=192.0.2.3:32766 | |<------------------|<------------------|<------------------| | | | | Figure 12 The message flow is shown in Figure 12. In step 1-2, the client allocates a UDP port from the local operating system on its private interface, obtaining 4334. It then attempts to obtain a port for RTP traffic. RTCP processing is not shown in the example. In step 1, the client sendsthis document as anAllocate Request (1) with a source address (denoted by S) of 10.0.1.1:4334 and a destination (denoted by D) of 192.0.2.3:8776.RFC. Thispasses through the NAT (2), which allocates a new UDP port (63346) onsection lists theNAT's public interface (192.0.2.1), and creates an internal mappingchanges between theinternal address 10.0.1.1:4334 and that external address 192.0.2.1:63346. The NAT sendsvarious versions of thisrequestspecification. 16.1. Changes from -05 to -06 o Changed theTURN server (3). The TURN server challengesmechanism for allocating channels to therequest, requesting credentialsone proposed bysending a STUN error and includingEric Rescorla at theNONCE and REALM attributes. Message 3 is relayed, byDec 2007 IETF meeting. o Removed theNAT,framing mechanism (which was used to frame all messages) and replaced it with theTURN client (4). The client sends a new request (from the same UDP port), including its credentials (5, 6). The TURN server authenticatesChannelData message. As part of this change, noted that therequest. The TURN server allocates a new UDP port on onedemux ofits interfaces, 192.0.2.3:32766. TheChannelData messages from TURNserver puts 192.0.2.3:32766 intomessages can be done using theRELAY-ADDRESS (denoted by RA) attributefirst two bits of theresponse, and putsmessage. o Rewrote thesource IP addresssections on transmitted andUDP portreceiving data as a result of therequest (as seen by the TURN server) into the XOR-MAPPED- ADDRESS attribute (denoted by MA). In step 7, this message is sent backabove tothe TURN clientchanges, splitting it into a section on Send and Data Indications andrelayed by the NAT in step 8. The client now proceeds to performabasic SIP call setup. In message 9, the TURN client includes the TURN server's address (which it learned in message 8) inseparate section on channels. o Clarified theSDPhandling ofits INVITE (e.g., using syntax described in[I-D.ietf-mmusic-ice]). The called party responds with its SDP in a provisional response (18x) or a final response (200 Ok). The called party's SDP includes its IP address andAllocate Request messages. In particular, subsequent Allocate Request messages over UDPport, 192.0.2.17:12734. Immediately after sending its 200 Ok, the called party sends an RTP packet to the TURN server's IP address (11). This RTP packet is dropped by the TURN server, becausewith theTURN server has not been given permission to relay that data. Incoming packetssame transaction id aredropped until a permission is created. The SIP exchange completes withnot anSIP 200 Ok message (12). Steps 13-20 show the client performingerror but achannel allocation. The TURN client needs to send an RTP packet. Since no channels and no permissions have been created, the TURN client sendsretransmission. o Restricted theRTP packet insiderange ofa Send Indication, using channel number 0, with the CHANNEL-NUMBER attribute set to the channel number the TURN client wants to useports available forsubsequent communication with this TURN peer (77 is shown in the example). The TURN peer's IP address and UDP port (which were learned from the SDP answer received in step 10) are placed in the PEER-ADDRESS attribute (denoted by PA). In message 13, the TURN client sends this Send Indication, and it is relayed by the NATallocation to theTURN server (14). Upon receipt of that message, the TURN server creates a permission, which allows subsequent traffic from that same peer address to be relayed to that TURN client's IP addressDynamic and/or Private Port range, andUDP port. The TURN server sends the contents of the Send Indication's DATA attribute towards the PEER-ADDRESS (15);noted when ports outside thiswill typicallyrange can bean RTP packet. Note thatused. o Changed thesource address and portformat ofmessage 15 is the TURN server's address, 192.0.2.3:32766, which istheallocated transport address communicated to the TURN client in messages 7 and 8. In step 16, the TURN server sends a channel confirmation message to the TURN client. Once the TURN client receives this message, it can forgo using the Send IndicationREQUESTED-TRANSPORT attribute. The previous version used 00 forthat channel. Instead, it can utilize the channel number in the TURN framing header. Steps 18 and 19 show the TURN client sending a message to TURN server using the TURN framing header, with channel=1. Step 20 shows the TURN server removing the TURN framingUDP andsending the RTP packet to01 for TCP; theTURN peer. Steps 21-28 show an RTP packetnew version uses protocol numbers from theTURN peer, which causes a channel allocation by the TURN server. In packet 21, an RTP packet is sent by the TURN peer to the TURN server. There is an existing permission (created in step 14), so the TURN server accepts this incoming RTP packet.IANA protocol number registry. TheTURN server knowsformat of theTURN client to send this packet to, but does not yet have a channel assigned for traffic in this direction. The TURN server choosesattribute also changed. o Made achannellarge number(33 in the example), and sends a Data Indication to the TURN client (message 22). The NAT relays thisof changes to theTURN client (message 23). The TURN client sends an Channel Confirmation message (24) which is relayed by the NAT (25). When the TURN server receivesnon-normative portion of theChannel Confirmation, it no longer needsdocument touse a Send Indication for traffic from that remote peer; instead, it can use TURN framing with its chosen channel number (33). The next RTP packet that arrives from that peer (26) is sent by the TURN server using TURN framing indicating the channel number (message 27)reflect technical changes andrelayed byimprove theNAT topresentation. o Added theTURN client (28). 15.Issues section. 16.2. Changessince versionfrom -04This section lists the major changes between thiis document and draft-ietf-behave-turn-04:to -05 o Removed the ability to allocate addresses for TCP relaying. This is now covered in a separate document. However, communication between the client and the server can still run over TCP or TLS/ TCP. This resulted in the removal of the Connect method and the TIMER-VAL and CONNECT-STAT attributes. o Added the concept of channels. All communication between the client and the server flows on a channel. Channels are numbered 0..65535. Channel 0 is used for TURN messages, while the remaining channels are used for sending unencapsulated data to/ from a remote peer. This concept adds a new Channel Confirmation method and a new CHANNEL-NUMBER attribute. The new attribute is also used in the Send and Data methods. o The framing mechanism formally used just for stream-oriented transports is now also used for UDP, and the former Type and Reserved fields in the header have been replaced by a Channel Number field. The length field is zero when running over UDP. o TURN now runs on its own port, rather than using the STUN port. The use of channels requires this. o Removed the SetActiveDestination concept. This has been replaced by the concept of channels. o Changed the allocation refresh mechanism. The new mechanism uses a new Refresh method, rather than repeating the Allocation transaction. o Changed the syntax of SRV requests for secure transport. The new syntax is "_turns._tcp" rather than the old "_turn._tls". This change mirrors the corresponding change in STUN SRV syntax. o Renamed the old REMOTE-ADDRESS attribute to PEER-ADDRESS, and changed it to use the XOR-MAPPED-ADDRESS format. o Changed the RELAY-ADDRESS attribute to use the XOR-MAPPED-ADDRESS format (instead of the MAPPED-ADDRESS format)). o Renamed the 437 error code from "No Binding" to "Allocation Mismatch". o Added a discussion of what happens if a client's public binding on its outermost NAT changes. o The document now consistently uses the term "peer" as the name of a remote endpoint with which the client wishes to communicate. o Rewrote much of the document to describe the new concepts. At the same time, tried to make the presentation clearer and less repetitive.16.17. Issues NOTE to RFC Editor: Please remove this section prior to publication of this document as an RFC. This section lists the open and now closed issues in this document. The descriptions here are brief, and the reader should consult the corresponding thread on the mailing list for a more in-depth description of the issue and the resolutions being considered. 17.1. Open Issues 1. Bandwidth: What should we do with the BANDWIDTH attribute, which is currently ill-specified? Should we remove it? Or should we try to come up with a good specification, perhaps using ideas from RSVP? 2. Permission Policy: What should the permission policy be? Address-restricted, as is currently specified in the document? Or address-and-port-restricted, as many firewalls implement today? Or should we leave this open to the implementor, under the assumption that the IT administrator will only allow clients to contact those servers that implement whatever permission policy the IT administrator can accept? 3. Port Adjacency: The spec currently allows a client to request that the server allocate a port and also reserve the next higher port number for a possible future allocation (on a different 5-tuple). However, the exact behavior of the server in this case is ill-specified. For example, must the next-higher-port be available for the allocation of the lower port number to succeed? How long is the next-higher-port reserved? 30 seconds? For the lifetime of the lower-numbered-port's allocation? Or should we just ditch this feature, since it is difficult to implement, it is at odds with port randomization, and paired port numbers applications don't work well with NATs anyway? 4. Demuxing ChannelData messages: How does a client or server demux STUN-formatted messages from ChannelData messages? Does it use the first two bits (as currently specified) or just one bit? And how many channels do we need anyway? Some people are questioning the need for any more than 200 channels. If we don't need many channels, then the demux algorithm might become simpler. 5. Deallocating Channels: Do we need a mechanism for deallocating channels? Some have argued for this feature, because a TURN server administrator will want a way to recover resources for channels no longer in active use. If yes, then what is the mechanism? For example, should a channel binding expire when the corresponding permission expires? 6. Permissions and Channel Allocations: Should allocating a channel for a peer automatically install a permission for that peer's IP address? 7. Permission and Allocation Lifetimes: What should the default permission lifetime be? Should there be a minumum value? Should there be a way for the client to modify the permission lifetime? Should there be a way for the client to learn the current permission lifetime? And what is the relationship of the permission lifetime to the allocation lifetime? Does it make sense for the allocation lifetime to be less than the permission lifetime? 8. Preserving bits in the IP header: What bits (if any) should be preserved in the IP header when a packet is relayed by the server? The bits under consideration are currently the Don't Fragment (DF) bit, the Explicit Congestion Notification (ECN) bits, and the DiffServ (DS) bits. 9. Exceeding the Path MTU Size: TURN adds an overhead of 4 bytes (ChannelData msg) or 36 bytes (Send or Data Indication), thus potentially exceeding the path MTU between the client and server. This could either cause IP fragmentation, or cause the packet to be dropped if the DF bit is set. Who handles this problem? Does TURN need to handle this, or is this left up to the application to handle? 10. Allowed PEER-ADDRESS values: Should there be any restrictions on the IP address the client can specify in the PEER-ADDRESS attribute? Are multicast addresses allowed? What about 0.0.0.0? Any other restrictions? 11. Discarding UDP datagrams: If the server discards a received UDP datagram on the relayed transport address (because there is no corresponding permission), then does the server send an ICMP response? If so, what error code does it use? (What does RFC 4787 say about the corresponding situation in NATs? I believe many NATs silently discard these packets by default, or have a "stealth mode" that enables this behavior.) 12. Authentication: Is the use of STUN's Long-Term Authentication Mechanism by a TURN server mandatory? The document currently implicitly assumes "yes", but what about someone who wants to operate a public TURN server? 13. Re-using the 5-tuple: If an allocation expires, is there any reason a client should not be able to immediately create a new allocation using the same 5-tuple? 14. Password change: Is it possible to change the password for the Long-Term Authentication mechanism during the lifetime of an allocation? If so, how is it done? 15. IPv6: TURN probably works fine in an all IPv6 environment, but there are a number of mixed IPv4/IPv6 cases that are ill- specified. As an example, the server needs to check that the PEER-ADDRESS in a Send Indication is of the same address family as the relayed transport address. Should we carefully work through all these cases and make sure we have caught them all, or should we just state that this document covers the IPv4 case only, and punt the specification of IPv6 and mixed IPv4/IPv6 operation to draft-ietf-behave-turn-ipv6? Does the current interest in resurecting IPv4-to-IPv6 NATs have any impact on TURN? 17.2. Closed Issues 1. Channel Allocation: Should TURN use the mechanism proposed by EKR to allocate channels? RESOLUTION: Yes. Document now reflects this. 2. Stateful Allocations: Does a TURN server need to distinguish between the case where the client retransmits the initial Allocate Request because the Allocate Response was lost and the case where the client sends an Allocate Request because it thinks the allocation does not exist? RESOLUTION: Yes. Document now reflects this. 3. Port Range: From what range of port numbers should a TURN server allocate ports? RESOLUTION: The server SHOULD allocate from the Dynamic and/or Private Port range unless it is sure it will not interfere with other apps on the same machine. Document now reflects this. 4. Framing Header for STUN-formatted messages: Should TURN use the framing mechanism for STUN-formatted messages? RESOLUTION: NO. Document now reflects this. However, see related issues. 5. Length field in ChannelData header: Over UDP, the length of the application data field in the ChannelData message can be determined from the length field in the UDP header. So should the length field in the ChannelData header be set to zero in this case? RESOLUTION: No, the ChannelData length field should have the same semantics over both TCP and UDP. Document now reflects this. 18. Acknowledgements The authors would like to thankMarc Petit-Hugueninthe various participants in the BEHAVE working group forhistheir many comments on this draft. Marc Petit-Huguenin, Remi Denis-Courmont, Cullen Jennings, Lars Eggert, Magnus Westerlund, andsuggestions. 17.Eric Rescorla have been particularly helpful, with Eric also suggesting the channel allocation mechanism. Christian Huitema was an early contributor to this document and was a co-author on the first few drafts. Finally, the authors would like to thank Dan Wing for his huge help in restarting progress on this draft after work had stalled. 19. References17.1.19.1. Normative References [I-D.ietf-behave-rfc3489bis] Rosenberg, J., Mahy, R., Matthews, P., and D. Wing, "Session Traversal Utilities for (NAT) (STUN)",draft-ietf-behave-rfc3489bis-12draft-ietf-behave-rfc3489bis-13 (work in progress), November 2007. [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997.17.2.19.2. Informative References [RFC3550] Schulzrinne, H., Casner, S., Frederick, R., and V. Jacobson, "RTP: A Transport Protocol for Real-Time Applications", STD 64, RFC 3550, July 2003. [RFC1889] Schulzrinne, H., Casner, S., Frederick, R., and V. Jacobson, "RTP: A Transport Protocol for Real-Time Applications", RFC 1889, January 1996. [RFC1918] Rekhter, Y., Moskowitz, R., Karrenberg, D., Groot, G., and E. Lear, "Address Allocation for Private Internets", BCP 5, RFC 1918, February 1996. [RFC3264] Rosenberg, J. and H. Schulzrinne, "An Offer/Answer Model with Session Description Protocol (SDP)", RFC 3264, June 2002. [RFC4302] Kent, S., "IP Authentication Header", RFC 4302, December 2005. [RFC4303] Kent, S., "IP Encapsulating Security Payload (ESP)", RFC 4303, December 2005. [RFC3424] Daigle, L. and IAB, "IAB Considerations for UNilateral Self-Address Fixing (UNSAF) Across Network Address Translation", RFC 3424, November 2002. [I-D.ietf-mmusic-ice] Rosenberg, J., "Interactive Connectivity Establishment (ICE): A Protocol for Network Address Translator (NAT) Traversal for Offer/Answer Protocols", draft-ietf-mmusic-ice-19 (work in progress), October 2007. [RFC4787] Audet, F. and C. Jennings, "Network Address Translation (NAT) Behavioral Requirements for Unicast UDP", BCP 127, RFC 4787, January 2007. [I-D.ietf-behave-turn-tcp] Rosenberg, J. and R. Mahy, "Traversal Using Relays around NAT (TURN) Extensions for TCP Allocations", draft-ietf-behave-turn-tcp-00 (work in progress), November 2007. [Port-Numbers] "IANA Port Numbers Registry", <http://www.iana.org/assignments/port-numbers>. [Protocol-Numbers] "IANA Protocol Numbers Registry", 2005, <http://www.iana.org/assignments/protocol-numbers>. Authors' Addresses Jonathan Rosenberg Cisco Systems, Inc. Edison, NJUSUSA Email: jdrosen@cisco.com URI: http://www.jdrosen.net Rohan Mahy Plantronics, Inc. Email: rohan@ekabal.com Philip Matthews Avaya, Inc. 1135 Innovation Drive Ottawa, Ontario K2K 3G7 Canada Phone: +1 613 592-4343 x223 Fax: Email: philip_matthews@magma.ca URI:Dan Wing Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134 USA Phone: Fax: Email: dwing@cisco.com URI:Full Copyright Statement Copyright (C) The IETF Trust(2007).(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. Acknowledgment Funding for the RFC Editor function is provided by the IETF Administrative Support Activity (IASA).