A Session Initiation Protocol (SIP) Usage for Incremental Provisioning of Candidates for the Interactive Connectivity Establishment (Trickle ICE) Jitsi
Strasbourg 67000 France +33 6 72 81 15 55 emcho@jitsi.org
Unaffiliated
Vienna 1130 Austria thomass.stach@gmail.com
Telecom Italia
Via G. Reiss Romoli, 274 Turin 10148 Italy enrico.marocco@telecomitalia.it
Ericsson
Hirsalantie 11 02420 Jorvas Finland christer.holmberg@ericsson.com
The Interactive Connectivity Establishment (ICE) protocol describes a Network Address Translator (NAT) traversal mechanism for UDP-based multimedia sessions established with the Offer/Answer model. The ICE extension for Incremental Provisioning of Candidates (Trickle ICE) defines a mechanism that allows ICE Agents to shorten session establishment delays by making the candidate gathering and connectivity checking phases of ICE non-blocking and by executing them in parallel. This document defines usage semantics for Trickle ICE with the Session Initiation Protocol (SIP). The document also defines a new SIP Info Package to support this usage together with the corresponding media type. Additionally, a new Session Description Protocol (SDP) "end-of-candidates" attribute and a new SIP option tag "trickle-ice" are defined.
Status of This Memo This is an Internet Standards Track document. This document is a product of the Internet Engineering Task Force (IETF). It represents the consensus of the IETF community. It has received public review and has been approved for publication by the Internet Engineering Steering Group (IESG). Further information on Internet Standards is available in Section 2 of RFC 7841. Information about the current status of this document, any errata, and how to provide feedback on it may be obtained at .
Copyright Notice Copyright (c) 2021 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents () in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Simplified BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Simplified BSD License.
Table of Contents
  • .  Introduction
  • .  Terminology
  • .  Protocol Overview
    • .  Discovery Issues
    • .  Relationship with the Offer/Answer Model
  • .  Incremental Signaling of ICE Candidates
    • .  Initial Offer/Answer Exchange
      • .  Sending the Initial Offer
      • .  Receiving the Initial Offer
      • .  Sending the Initial Answer
      • .  Receiving the Initial Answer
    • .  Subsequent Offer/Answer Exchanges
    • .  Establishing the Dialog
      • .  Establishing Dialog State through Reliable Offer/Answer Delivery
      • .  Establishing Dialog State through Unreliable Offer/Answer Delivery
      • .  Initiating Trickle ICE without an SDP Answer
    • .  Delivering Candidates in INFO Requests
  • .  Initial Discovery of Trickle ICE Support
    • .  Provisioning Support for Trickle ICE
    • .  Trickle ICE Discovery with Globally Routable User Agent URIs (GRUUs)
    • .  Fall Back to Half Trickle
  • .  Considerations for RTP and RTCP Multiplexing
  • .  Considerations for Media Multiplexing
  • .  SDP "end-of-candidates" Attribute
    • .  Definition
    • .  Offer/Answer Procedures
  • .  Content Type "application/trickle-ice-sdpfrag"
    • .  Overall Description
    • .  Grammar
  • . Info Package
    • .  Rationale -- Why INFO?
    • .  Overall Description
    • .  Applicability
    • .  Info Package Name
    • .  Info Package Parameters
    • .  SIP Option Tags
    • .  INFO Request Body Parts
    • .  Info Package Usage Restrictions
    • .  Rate of INFO Requests
    • . Info Package Security Considerations
  • . Deployment Considerations
  • . IANA Considerations
    • .  SDP "end-of-candidates" Attribute
    • .  Media Type "application/trickle-ice-sdpfrag"
    • .  SIP Info Package "trickle-ice"
    • .  SIP Option Tag "trickle-ice"
  • . Security Considerations
  • . References
    • .  Normative References
    • .  Informative References
  • Acknowledgements
  • Authors' Addresses
Introduction The Interactive Connectivity Establishment (ICE) protocol describes a mechanism for Network Address Translator (NAT) traversal that consists of three main phases. During the first phase, an agent gathers a set of candidate transport addresses (source IP, port, and transport protocol). This is followed by a second phase where these candidates are sent to a remote agent within the Session Description Protocol (SDP) body of a SIP message. At the remote agent, the gathering procedure is repeated and candidates are sent to the first agent. Once the candidate information is available, a third phase starts in parallel where connectivity between all candidates in both sets is checked (connectivity checks). Once these phases have been completed, and only then, both agents can begin communication. According to , the three phases above happen consecutively, in a blocking way, which can introduce undesirable setup delay during session establishment. The Trickle ICE extension defines generic semantics required for these ICE phases to happen in a parallel, non-blocking way and hence speeds up session establishment. This specification defines a usage of Trickle ICE with the Session Initiation Protocol (SIP). It describes how ICE candidates are to be exchanged incrementally using SIP INFO requests and how the Half Trickle and Full Trickle modes defined in are to be used by SIP User Agents (UAs) depending on their expectations for support of Trickle ICE by a remote agent. This document defines a new Info Package as specified in for use with Trickle ICE together with the corresponding media type, SDP attribute, and SIP option tag.
Terminology The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 when, and only when, they appear in all capitals, as shown here. This specification makes use of terminology defined by the ICE protocol in and by its Trickle ICE extension in . It is assumed that the reader is familiar with the terminology from both documents. also describes how ICE makes use of the Session Traversal Utilities for NAT (STUN) protocol and its extension Traversal Using Relays around NAT (TURN) .
Protocol Overview When using ICE for SIP according to , the ICE candidates are exchanged solely via SDP Offer/Answer as per . This specification defines an additional mechanism where candidates can be exchanged using SIP INFO messages and a newly defined Info Package . This also allows ICE candidates to be sent in parallel to an ongoing Offer/Answer negotiation and/or after the completion of the Offer/Answer negotiation. Typically, in cases where Trickle ICE is fully supported, the Offerer sends an INVITE request containing a subset of candidates. Once an early dialog is established, the Offerer can continue sending candidates in INFO requests within that dialog. Similarly, an Answerer can send ICE candidates using INFO requests within the dialog established by its 18x provisional response. shows such a sample exchange:
Sample Trickle ICE Scenario with SIP STUN/TURN STUN/TURN Servers Alice Bob Servers | | | | | STUN Bi.Req. | INVITE (Offer) | | |<--------------|------------------------>| | | | 183 (Answer) | TURN Alloc Req | | STUN Bi.Resp. |<------------------------|--------------->| |-------------->| INFO/OK (SRFLX Cand.) | | | |------------------------>| TURN Alloc Resp| | | INFO/OK (Relay Cand.) |<---------------| | |<------------------------| | | | | | | | More Cands & ConnChecks| | | |<=======================>| | | | | | | | 200 OK | | | |<------------------------| | | | ACK | | | |------------------------>| | | | | | | |<===== MEDIA FLOWS =====>| | | | | | Note: "SRFLX" denotes server-reflexive candidates
Discovery Issues In order to benefit from Trickle ICE's full potential and reduce session establishment latency to a minimum, Trickle ICE Agents need to generate SDP Offers and Answers that contain incomplete and potentially empty sets of candidates. Such Offers and Answers can only be handled meaningfully by agents that actually support incremental candidate provisioning, which implies the need to confirm such support before using it. Contrary to other protocols, where "in advance" capability discovery is widely implemented, the mechanisms that allow this for SIP (i.e., a combination of UA capabilities and Globally Routable User Agent URIs (GRUUs) ) have only seen low levels of adoption. This presents an issue for Trickle ICE implementations as SIP UAs do not have an obvious means of verifying that their peer will support incremental candidate provisioning. The Half Trickle mode of operation defined in the Trickle ICE specification provides one way around this, by requiring the first Offer to contain a complete set of local ICE candidates and using only incremental provisioning of remote candidates for the rest of the session. While using Half Trickle does provide a working solution, it also comes at the price of increased latency. Therefore, makes several alternative suggestions that enable SIP UAs to engage in Full Trickle right from their first Offer: discusses the use of online provisioning as a means of allowing the use of Trickle ICE for all endpoints in controlled environments. describes anticipatory discovery for implementations that actually do support GRUU and UA capabilities, and discusses the implementation and use of Half Trickle by SIP UAs where none of the above are an option.
Relationship with the Offer/Answer Model From the perspective of SIP middleboxes and proxies, the Offer/Answer exchange for Trickle ICE looks partly similar to the Offer/Answer exchange for regular ICE for SIP . However, in order to have the full picture of the candidate exchange, the newly introduced INFO messages need to be considered as well.
Distinguishing between Trickle ICE and Traditional Signaling +-------------------------------+ +-------------------------------+ | Alice +--------------+ | | +--------------+ Bob | | | Offer/Answer | | | | Offer/Answer | | | +--------+ | Module | | | | Module | +--------+ | | | ICE | +--------------+ | | +--------------+ | ICE | | | | Module | | | | | | Module | | | +--------+ | | | | +--------+ | +-------------------------------+ +-------------------------------+ | | | | | | INVITE (Offer) | | | |--------------------->| | | | 183 (Answer) | | | |<---------------------| | | | | | | | | SIP INFO (more candidates) | |----------------------------------------------------->| | SIP INFO (more candidates) | |<-----------------------------------------------------| | | | STUN Binding Requests/Responses | |----------------------------------------------------->| | STUN Binding Requests/Responses | |<-----------------------------------------------------| | |
From an architectural viewpoint, as displayed in , exchanging candidates through SIP INFO requests could be represented as signaling between ICE modules and not between Offer/Answer modules of SIP UAs. Then, such INFO requests do not impact the state of the Offer/Answer transaction other than providing additional candidates. Consequently, INFO requests are not considered Offers or Answers. Nevertheless, candidates that have been exchanged using INFO requests SHALL be included in subsequent Offers or Answers. The version number in the "o=" line of that subsequent Offer needs to be incremented by 1 per the rules in .
Incremental Signaling of ICE Candidates Trickle ICE Agents will exchange ICE descriptions compliant to via Offer/Answer procedures and/or INFO request bodies. This requires the following SIP-specific extensions:
  1. Trickle ICE Agents MUST indicate support for Trickle ICE by including the SIP option-tag "trickle-ice" in a SIP Supported: header field within all SIP INVITE requests and responses.
  2. Trickle ICE Agents MUST indicate support for Trickle ICE by including the ice-option "trickle" within all SDP Offers and Answers in accordance to .
  3. Trickle ICE Agents MAY include any number of ICE candidates, i.e., from zero to the complete set of candidates, in their initial Offer or Answer. If the complete candidate set is already included in the initial Offer, it is called Half Trickle.
  4. Trickle ICE Agents MAY exchange additional ICE candidates using INFO requests within an existing INVITE dialog usage (including an early dialog) as specified in . The INFO requests carry an Info-Package: trickle-ice. Trickle ICE Agents MUST be prepared to receive INFO requests within that same dialog usage, containing additional candidates and/or an indication that trickling of such candidates has ended.
  5. Trickle ICE Agents MAY exchange additional ICE candidates before the Answerer has sent the Answer provided that an invite dialog usage is established at both Trickle ICE Agents. Note that in case of forking, multiple early dialogs may exist.
The following sections provide further details on how Trickle ICE Agents perform the initial Offer/Answer exchange (), perform subsequent Offer/Answer exchanges (), and establish the INVITE dialog usage () such that they can incrementally trickle candidates ().
Initial Offer/Answer Exchange
Sending the Initial Offer If the Offerer includes candidates in its initial Offer, it MUST encode these candidates as specified in . If the Offerer wants to send its initial Offer before knowing any candidate for one or more media descriptions, it MUST set the port to the default value '9' for these media descriptions. If the Offerer does not want to include the host IP address in the corresponding "c="line, e.g., due to privacy reasons, it SHOULD include a default address in the "c="line, which is set to the IPv4 address 0.0.0.0 or to the IPv6 equivalent ::. In this case, the Offerer obviously cannot know the RTP Control Protocol (RTCP) transport address; thus, it MUST NOT include the "rtcp" attribute . This avoids potential ICE mismatch (see ) for the RTCP transport address. If the Offerer wants to use RTCP multiplexing and/or exclusive RTCP multiplexing , it still will include the "rtcp-mux" and/or "rctp-mux-only" attribute in the initial Offer. In any case, the Offerer MUST include the "ice-options:trickle" attribute in accordance to and MUST include in each "m=" line a "mid" attribute in accordance to . The "mid" attribute identifies the "m=" line to which a candidate belongs and helps in case of multiple "m=" lines, when candidate gathering could occur in an order different from the order of the "m=" lines.
Receiving the Initial Offer If the initial Offer included candidates, the Answerer uses these candidates to start ICE processing as specified in . If the initial Offer included the "ice-options:trickle" attribute, the Answerer MUST be prepared for receiving trickled candidates later on. In case of a "m/c=" line with default values, none of the eventually trickled candidates will match the default destination. This situation MUST NOT cause an ICE mismatch (see ).
Sending the Initial Answer If the Answerer includes candidates in its initial Answer, it MUST encode these candidates as specified in . If the Answerer wants to send its initial Answer before knowing any candidate for one or more media descriptions, it MUST set the port to the default value '9' for these media descriptions. If the Answerer does not want to include the host IP address in the corresponding "c="line, e.g., due to privacy reasons, it SHOULD include a default address in the "c="line, which is set to the IPv4 address 0.0.0.0 or to the IPv6 equivalent ::. In this case, the Answerer obviously cannot know the RTCP transport address; thus, it MUST NOT include the "rtcp" attribute . This avoids potential ICE mismatch (see ) for the RTCP transport address. If the Answerer accepts the use of RTCP multiplexing and/or exclusive RTCP multiplexing , it will include the "rtcp-mux" attribute in the initial Answer. In any case, the Answerer MUST include the "ice-options:trickle" attribute in accordance to and MUST include in each "m=" line a "mid" attribute in accordance to .
Receiving the Initial Answer If the initial Answer included candidates, the Offerer uses these candidates to start ICE processing as specified in . In case of a "m/c=" line with default values, none of the eventually trickled candidates will match the default destination. This situation MUST NOT cause an ICE mismatch (see ).
Subsequent Offer/Answer Exchanges Subsequent Offer/Answer exchanges are handled the same as regular ICE (see ). If an Offer or Answer needs to be sent while the ICE Agents are in the middle of trickling, applies. This means that an ICE Agent includes candidate attributes for all local candidates it had trickled previously for a specific media stream.
Establishing the Dialog In order to be able to start trickling, the following two conditions need to be satisfied at the SIP UAs:
  • Trickle ICE support at the peer agent MUST be confirmed.
  • A dialog MUST have been created between the peers.
discusses in detail the various options for satisfying the first of the above conditions. However, regardless of those mechanisms, agents are certain to have a clear understanding of whether their peers support trickle ICE once an Offer and an Answer have been exchanged, which also allows for ICE processing to commence (see ).
Establishing Dialog State through Reliable Offer/Answer Delivery
A SIP Offerer can freely trickle as soon as it receives an Answer Alice Bob | | | INVITE (Offer) | |------------------------>| | 183 (Answer) | |<------------------------| | PRACK/OK | |------------------------>| | | +----------------------------------------+ |Alice and Bob know that both can trickle| |and know that the dialog is in the early| |state. Send INFO! | +----------------------------------------+ | | | INFO/OK (+SRFLX Cand.) | |------------------------>| | INFO/OK (+SRFLX Cand.) | |<------------------------| | | Note: "SRFLX" denotes server-reflexive candidates
As shown in , satisfying both conditions is relatively trivial for ICE Agents that have sent an Offer in an INVITE and that have received an Answer in a reliable provisional response. It is guaranteed to have confirmed support (or lack thereof) for Trickle ICE at the Answerer and to have fully initialized the SIP dialog at both ends. Offerers and Answerers (after receipt of the PRACK request) in the above situation can therefore freely commence trickling within the newly established dialog.
Establishing Dialog State through Unreliable Offer/Answer Delivery The situation is a bit more delicate for agents that have received an Offer in an INVITE request and have sent an Answer in an unreliable provisional response because, once the response has been sent, the Answerer does not know when or if it has been received ().
A SIP UA that sent an Answer in an unreliable provisional response does not know if it was received or if the dialog at the side of the Offerer has entered the early state Alice Bob | | | INVITE (Offer) | |------------------------>| | 183 (Answer) | |<------------------------| | | | +----------------------+ | |Bob: I don't know if | | |Alice got my 183 or if| | |her dialog is already | | |in the early state. | | | Can I send INFO??? | | +----------------------+ | |
In order to clear this ambiguity as soon as possible, the Answerer needs to retransmit the provisional response with the exponential backoff timers described in . These retransmissions MUST cease on receipt of an INFO request carrying a "trickle-ice" Info Package body, on receipt of any other in-dialog request from the Offerer, or on transmission of the Answer in a 2xx response. The Offerer cannot send in-dialog requests until it receives a response, so the arrival of such a request proves that the response has arrived. Using the INFO request for dialog confirmation is similar to the procedure described in , except that the STUN binding request is replaced by the INFO request. The Offerer MUST send a Trickle ICE INFO request as soon as it receives an SDP Answer in an unreliable provisional response. This INFO request MUST repeat the candidates that were already provided in the Offer (as would be the case when Half Trickle is performed or when new candidates have not been learned since then). The first case could happen when Half Trickle is used and all candidates are already in the initial offer. The second case could happen when Full Trickle is used and the Offerer is currently gathering additional candidates but did not yet get them. Also, if the initial Offer did not contain any candidates, depending on how the Offerer gathers its candidates and how long it takes to do so, this INFO could still contain no candidates. When Full Trickle is used and if newly learned candidates are available, the Offerer SHOULD also deliver these candidates in said INFO request, unless it wants to hold back some candidates in reserve, e.g., in case these candidates are expensive to use and would only be trickled if all other candidates failed. The Offerer SHOULD include an "end-of-candidates" attribute in case candidate discovery has ended in the meantime and no further candidates are to be trickled. As soon as an Answerer has received such an INFO request, the Answerer has an indication that a dialog is established at both ends and trickling can begin (). Note: The "+SRFLX" in indicates that additional newly learned server-reflexive candidates are included.
A SIP UA that received an INFO request after sending an unreliable provisional response knows that the dialog at the side of the receiver has entered the early state Alice Bob | | | INVITE (Offer) | |------------------------>| | 183 (Answer) | |<------------------------| | INFO/OK (+SRFLX Cand.) | |------------------------>| | | | +----------------------+ | |Bob: Now I know Alice| | | is ready. Send INFO! | | +----------------------+ | INFO/OK (+SRFLX Cand.) | |<------------------------| | | | 200/ACK (Answer) | |<------------------------| Note: "SRFLX" denotes server-reflexive candidates
When sending the Answer in the 200 OK response to the INVITE request, the Answerer needs to repeat exactly the same Answer that was previously sent in the unreliable provisional response in order to fulfill the corresponding requirements in . Thus, the Offerer needs to be prepared for receiving a different number of candidates in that repeated Answer than previously exchanged via trickling and MUST ignore the candidate information in that 200 OK response.
Initiating Trickle ICE without an SDP Answer The ability to convey arbitrary candidates in INFO message bodies allows ICE Agents to initiate trickling without actually sending an Answer. Trickle ICE Agents can therefore respond to an INVITE request with provisional responses without an SDP Answer . Such provisional responses serve for establishing an early dialog. Agents that choose to establish the dialog in this way MUST retransmit these responses with the exponential backoff timers described in . These retransmissions MUST cease on receipt of an INFO request carrying a "trickle-ice" Info Package body, on receipt of any in-dialog requests from the Offerer, or on transmission of the Answer in a 2xx response. The Offerer cannot send in-dialog requests until it receives a response, so the arrival of such a request proves that the response has arrived. This is again similar to the procedure described in , except that an Answer is not yet provided. Note: The "+SRFLX" in indicates that additional newly learned server-reflexive candidates are included.
A SIP UA sends an unreliable provisional response without an Answer for establishing an early dialog Alice Bob | | | INVITE (Offer) | |------------------------>| | 183 (-) | |<------------------------| | INFO/OK (SRFLX Cand.) | |------------------------>| | | | +----------------------+ | |Bob: Now I know again| | | that Alice is ready. | | | Send INFO! | | +----------------------+ | INFO/OK (SRFLX Cand.) | |<------------------------| | 183 (Answer) opt. | |<------------------------| | INFO/OK (SRFLX Cand.) | |<------------------------| | 200/ACK (Answer) | |<------------------------| Note: "SRFLX" denotes server-reflexive candidates
When sending the Answer, the agent MUST repeat all currently known and used candidates, if any, and MAY include all newly gathered candidates since the last INFO request was sent. However, if that Answer was already sent in an unreliable provisional response, the Answerers MUST repeat exactly the same Answer in the 200 OK response to the INVITE request in order to fulfill the corresponding requirements in . In case that trickling continued, an Offerer needs to be prepared for receiving fewer candidates in that repeated Answer than previously exchanged via trickling and MUST ignore the candidate information in that 200 OK response.
Delivering Candidates in INFO Requests Whenever new ICE candidates become available for sending, agents encode them in "candidate" attributes as described by . For example: a=candidate:1 1 UDP 2130706432 200a0b:12f0::1 5000 typ host The use of SIP INFO requests happens within the context of the Info Package as defined in . The media type for their payload MUST be set to "application/trickle-ice-sdpfrag" as defined in . The INFO request body adheres to the grammar as specified in . Since neither the "candidate" nor the "end-of-candidates" attributes contain information that would allow correlating them to a specific "m=" line, it is handled through the use of pseudo "m=" lines. Pseudo "m=" lines follow the SDP syntax for "m=" lines as defined in and are linked to the corresponding "m=" line in the SDP Offer or Answer via the identification tag in a "mid" attribute . A pseudo "m=" line does not provide semantics other than indicating to which "m=" line a candidate belongs. Consequently, the receiving agent MUST ignore any remaining content of the pseudo "m=" line, which is not defined in this document. This guarantees that the "application/trickle-ice-sdpfrag" bodies do not interfere with the Offer/Answer procedures as specified in . When sending the INFO request, the agent MAY, if already known to the agent, include the same content into the pseudo "m=" line as for the "m=" line in the corresponding Offer or Answer. However, since Trickle ICE might be decoupled from the Offer/Answer negotiation, the content might be unknown to the agent. In this case, the agent MUST include the following default values:
  • The media field is set to 'audio'.
  • The port value is set to '9'.
  • The proto value is set to 'RTP/AVP'.
  • The fmt field MUST appear only once and is set to '0'.
Agents MUST include a pseudo "m=" line and an identification tag in a "mid" attribute for every "m=" line whose candidate list they intend to update. Such "mid" attributes MUST immediately precede the list of candidates for that specific "m=" line. All "candidate" or "end-of-candidates" attributes following a "mid" attribute, up until (and excluding) the next occurrence of a pseudo "m=" line, pertain to the "m=" line identified by that identification tag. Note, that there is no requirement that the INFO request body contains as many pseudo "m=" lines as the Offer/Answer contains "m=" lines, nor that the pseudo "m=" lines be in the same order as the "m=" lines that they pertain to. The correspondence can be made via the "mid" attributes since candidates are grouped in sections headed by "pseudo" "m=" lines. These sections contain "mid" attribute values that point back to the true "m=" line. An "end-of-candidates" attribute, preceding the first pseudo "m=" line, indicates the end of all trickling from that agent, as opposed to end of trickling for a specific "m=" line, which would be indicated by a media-level "end-of-candidates" attribute. Refer to for an example of the INFO request content. The use of pseudo "m=" lines allows for a structure similar to the one in SDP Offers and Answers where separate media-level and session-level sections can be distinguished. In the current case, lines preceding the first pseudo "m=" line are considered to be session level. Lines appearing in between or after pseudo "m=" lines will be interpreted as media level. All INFO requests MUST carry the "ice-pwd" and "ice-ufrag" attributes that allow mapping them to a specific ICE generation. An agent MUST discard any received INFO requests containing "ice-pwd" and "ice-ufrag" attributes that do not match those of the current ICE Negotiation Session. The "ice-pwd" and "ice-ufrag" attributes MUST appear at the same level as the ones in the Offer/Answer exchange. In other words, if they were present as session-level attributes, they will also appear at the beginning of all INFO request payloads, i.e., preceding the first pseudo "m=" line. If they were originally exchanged as media-level attributes, potentially overriding session-level values, then they will also be included in INFO request payloads following the corresponding pseudo "m=" lines. Note that when candidates are trickled, requires that each candidate must be delivered to the receiving Trickle ICE implementation not more than once and in the same order as it was conveyed. If the signaling protocol provides any candidate retransmissions, they need to be hidden from the ICE implementation. This requirement is fulfilled as follows. Since the agent is not fully aware of the state of the ICE Negotiation Session at its peer, it MUST include all currently known and used local candidates in every INFO request. That is, the agent MUST repeat in the INFO request body all candidates that were previously sent under the same combination of "ice-pwd" and "ice-ufrag" in the same order as they were sent before. In other words, the sequence of a previously sent list of candidates MUST NOT change in subsequent INFO requests, and newly gathered candidates MUST be added at the end of that list. Although repeating all candidates creates some overhead, it also allows easier handling of problems that could arise from unreliable transports like, e.g., loss of messages and reordering, which can be detected through the CSeq: header field in the INFO request. In addition, an ICE Agent needs to adhere to on preserving candidate order while trickling. When receiving INFO requests carrying any candidates, agents MUST first identify and discard the attribute lines containing candidates they have already received in previous INFO requests or in the Offer/Answer exchange preceding them. Such candidates are considered to be equal if their IP address port, transport, and component ID are the same. After identifying and discarding the known candidates, the agents MUST forward the actual new candidates to the ICE Agents in the same order as they were received in the INFO request body. The ICE Agents will then process the new candidates according to the rules described in . Receiving an "end-of-candidates" attribute in an INFO request body -- with the "ice-ufrag" and "ice-pwd" attributes matching the current ICE generation -- is an indication from the peer agent that it will not send any further candidates. When included at the session level, i.e., before any pseudo "m=" line, this indication applies to the whole session; when included at the media level, the indication applies only to the corresponding "m=" line. Handling of such end-of-candidates indications is defined in . The example in shows the content of a candidate delivering INFO request. In the example, the "end-of-candidates" attributes indicate that the candidate gathering is finished and that no further INFO requests follow.
An Example for the Content of an INFO Request INFO sip:alice@example.com SIP/2.0 ... Info-Package: trickle-ice Content-type: application/trickle-ice-sdpfrag Content-Disposition: Info-Package Content-length: 862 a=ice-pwd:asd88fgpdd777uzjYhagZg a=ice-ufrag:8hhY m=audio 9 RTP/AVP 0 a=mid:1 a=candidate:1 1 UDP 2130706432 2001:db8:a0b:12f0::1 5000 typ host a=candidate:1 2 UDP 2130706432 2001:db8:a0b:12f0::1 5001 typ host a=candidate:1 1 UDP 2130706431 192.0.2.1 5010 typ host a=candidate:1 2 UDP 2130706431 192.0.2.1 5011 typ host a=candidate:2 1 UDP 1694498815 192.0.2.3 5010 typ srflx raddr 192.0.2.1 rport 8998 a=candidate:2 2 UDP 1694498815 192.0.2.3 5011 typ srflx raddr 192.0.2.1 rport 8998 a=end-of-candidates m=audio 9 RTP/AVP 0 a=mid:2 a=candidate:1 1 UDP 2130706432 2001:db8:a0b:12f0::1 6000 typ host a=candidate:1 2 UDP 2130706432 2001:db8:a0b:12f0::1 6001 typ host a=candidate:1 1 UDP 2130706431 192.0.2.1 6010 typ host a=candidate:1 2 UDP 2130706431 192.0.2.1 6011 typ host a=candidate:2 1 UDP 1694498815 192.0.2.3 6010 typ srflx raddr 192.0.2.1 rport 9998 a=candidate:2 2 UDP 1694498815 192.0.2.3 6011 typ srflx raddr 192.0.2.1 rport 9998 a=end-of-candidates Note: In a real INFO request, there will be no line breaks in the "candidate" attributes
Initial Discovery of Trickle ICE Support SIP UAs are required by to indicate their support of and intent to use Trickle ICE in their Offers and Answers by using the "ice-options:trickle" attribute, and they MUST include the SIP option-tag "trickle-ice" in a SIP Supported: or Require: header field. This makes discovery fairly straightforward for Answerers or for cases where Offers need to be generated within existing dialogs (i.e., when sending UPDATE or re-INVITE requests). In both scenarios, prior SDP bodies will have provided the necessary information. Obviously, such information is not available at the time a first Offer is being constructed, and it is therefore impossible for ICE Agents to determine support for incremental provisioning that way. The following options are suggested as ways of addressing this issue.
Provisioning Support for Trickle ICE In certain situations, it may be possible for integrators deploying Trickle ICE to know in advance that some or all endpoints reachable from within the deployment will support Trickle ICE. This is the case, for example, if Session Border Controllers (SBCs) with support for this specification are used to connect to UAs that do not support Trickle ICE. While the exact mechanism for allowing such provisioning is out of scope here, this specification encourages trickle ICE implementations to allow the option in the way they find most appropriate. However, an Offerer assuming Trickle ICE support MUST include a SIP Require: trickle-ice header field. That way, if the provisioned assumption of Trickle ICE support ends up being incorrect, the failure is (a) operationally easy to track down and (b) recoverable by the client, i.e., they can resend the request without the SIP Require: header field and without the assumption of Trickle ICE support.
Trickle ICE Discovery with Globally Routable User Agent URIs (GRUUs) provides a way for SIP UAs to query for support of specific capabilities using, among others, OPTIONS requests. On the other hand, support for GRUU according to allows SIP requests to be addressed to specific UAs (as opposed to arbitrary instances of an address of record). Combining the two and using the "trickle-ice" option tag defined in provides SIP UAs with a way of learning the capabilities of specific SIP UA instances and then addressing them directly with INVITE requests that require Trickle ICE support. Such learning of capabilities may happen in different ways. One option for a SIP UA is to learn the GRUU instance ID of a peer through presence and then to query its capabilities with an OPTIONS request. Alternatively, it can also just send an OPTIONS request to the Address of Record (AOR) it intends to contact and then inspect the returned response(s) for support of both GRUU and Trickle ICE (). It is noted that using the GRUU means that the INVITE request can go only to that particular device. This prevents the use of forking for that request.
Trickle ICE Support Discovery with OPTIONS and GRUU Alice Bob | | | OPTIONS sip:b1@example.com SIP/2.0 | |-------------------------------------------------->| | | | 200 OK | | Contact: sip:b1@example.com;gr=hha9s8d-999a | | ;audio;video|;trickle-ice;... | |<--------------------------------------------------| | | | INVITE sip:b1@example.com;gr=hha9s8d-999a SIP/2.0 | | Supported: trickle-ice | | (Offer) | |-------------------------------------------------->| | | | 183 (Answer) | |<--------------------------------------------------| | INFO/OK (Trickling) | |<------------------------------------------------->| | | | ... | | |
Confirming support for Trickle ICE through gives SIP UAs the option to engage in Full Trickle negotiation (as opposed to the more lengthy Half Trickle) from the very first Offer they send.
Fall Back to Half Trickle In cases where none of the other mechanisms in this section are acceptable, SIP UAs should use the Half Trickle mode defined in . With Half Trickle, agents initiate sessions the same way they would when using ICE for SIP . This means that, prior to actually sending an Offer, agents first gather ICE candidates in a blocking way and then send them all in that Offer. The blocking nature of the process implies that some amount of latency will be accumulated, and it is advised that agents try to anticipate it where possible, for example, when user actions indicate a high likelihood for an imminent call (e.g., activity on a keypad or a phone going off hook). Using Half Trickle results in Offers that are compatible with both ICE SIP endpoints and legacy endpoints .
Example of a Typical (Half) Trickle ICE Exchange with SIP STUN/TURN STUN/TURN Servers Alice Bob Servers | | | | |<--------------| | | | | | | | | | | | Candidate | | | | | | | | | | | | Discovery | | | | | | | | | | | |-------------->| INVITE (Offer) | | | |---------------------------->| | | | 183 (Answer) |-------------->| | |<----------------------------| | | | INFO (repeated candidates) | | | |---------------------------->| | | | | | | | INFO (more candidates) | Candidate | | |<----------------------------| | | | Connectivity Checks | | | |<===========================>| Discovery | | | INFO (more candidates) | | | |<----------------------------| | | | Connectivity Checks |<--------------| | |<===========================>| | | | | | | | 200 OK | | | |<----------------------------| | | | | | | |<======= MEDIA FLOWS =======>| | | | | |
As a reminder, once a single Offer or Answer has been exchanged within a specific dialog, support for Trickle ICE will have been determined. No further use of Half Trickle will therefore be necessary within that same dialog, and all subsequent exchanges can use the Full Trickle mode of operation.
Considerations for RTP and RTCP Multiplexing The following consideration describes options for Trickle ICE in order to give some guidance to implementers on how trickling can be optimized with respect to providing RTCP candidates. Handling of the "rtcp" attribute and the "rtcp-mux" attribute for RTP/RTCP multiplexing is already considered in and in . These considerations are still valid for Trickle ICE; however, trickling provides more flexibility for the sequence of candidate exchange in case of RTCP multiplexing. If the Offerer supports RTP/RTCP multiplexing exclusively as specified in , the procedures in that document apply for the handling of the "rtcp-mux-only", "rtcp", and "rtcp-mux" attributes. While a Half Trickle Offerer has to send an Offer compliant to and including candidates for all components, the flexibility of a Full Trickle Offerer allows the sending of only RTP candidates (component 1) in the initial Offer assuming that RTCP multiplexing is supported by the Answerer. A Full Trickle Offerer would need to start gathering and trickling RTCP candidates (component 2) only after having received an indication in the Answer that the Answerer unexpectedly does not support RTCP multiplexing. A Trickle Answerer MAY include an "rtcp-mux" attribute in the "application/trickle-ice-sdpfrag" body if it supports and uses RTP and RTCP multiplexing. The Trickle Answerer needs to follow the guidance on the usage of the "rtcp" attribute as given in and . Receipt of this attribute at the Offerer in an INFO request prior to the Answer indicates that the Answerer supports and uses RTP and RTCP multiplexing. The Offerer can use this information, e.g., for stopping the gathering of RTCP candidates and/or for freeing corresponding resources. This behavior is illustrated by the following example Offer that indicates support for RTP and RTCP multiplexing. v=0 o=alice 2890844526 2890844526 IN IP6 atlanta.example.com s= c=IN IP6 2001:db8:a0b:12f0::3 t=0 0 a=ice-pwd:777uzjYhagZgasd88fgpdd a=ice-ufrag:Yhh8 m=audio 5000 RTP/AVP 0 a=mid:1 a=rtcp-mux a=candidate:1 1 UDP 1658497328 2001:db8:a0b:12f0::3 5000 typ host Once the dialog is established as described in , the Answerer sends the following INFO request. INFO sip:alice@example.com SIP/2.0 ... Info-Package: trickle-ice Content-type: application/trickle-ice-sdpfrag Content-Disposition: Info-Package Content-length: 161 a=ice-pwd:asd88fgpdd777uzjYhagZg a=ice-ufrag:8hhY m=audio 9 RTP/AVP 0 a=mid:1 a=rtcp-mux a=candidate:1 1 UDP 1658497382 2001:db8:a0b:12f0::4 6000 typ host This INFO request indicates that the Answerer supports and uses RTP and RTCP multiplexing as well. It allows the Offerer to omit gathering RTCP candidates or releasing already gathered RTCP candidates. If the INFO request did not contain the "rtcp-mux" attribute, the Offerer has to gather RTCP candidates unless it wants to wait until receipt of an Answer that eventually confirms support or non-support for RTP and RTCP multiplexing. In case the Offerer already sent RTCP candidates in a previous INFO request, it still needs to repeat them in subsequent INFO requests, even when that support for RTCP multiplexing was confirmed by the Answerer and the Offerer has released its RTCP candidates.
Considerations for Media Multiplexing The following considerations describe options for Trickle ICE in order to give some guidance to implementers on how trickling can be optimized with respect to providing candidates in case of Media Multiplexing . It is assumed that the reader is familiar with . ICE candidate exchange is already considered in . These considerations are still valid for Trickle ICE; however, trickling provides more flexibility for the sequence of candidate exchange, especially in Full Trickle mode. Except for bundle-only "m=" lines, a Half Trickle Offerer has to send an Offer with candidates for all bundled "m=" lines. The additional flexibility, however, allows a Full Trickle Offerer to initially send only candidates for the "m=" line with the suggested Offerer BUNDLE address. On receipt of the Answer, the Offerer will detect if BUNDLE is supported by the Answerer and if the suggested Offerer BUNDLE address was selected. In this case, the Offerer does not need to trickle further candidates for the remaining "m=" lines in a bundle. However, if BUNDLE is not supported, the Full Trickle Offerer needs to gather and trickle candidates for the remaining "m=" lines as necessary. If the Answerer selects an Offerer BUNDLE address that is different from the suggested Offerer BUNDLE address, the Full Trickle Offerer needs to gather and trickle candidates for the "m=" line that carries the selected Offerer BUNDLE address. A Trickle Answerer SHOULD include a "group:BUNDLE" attribute at session level in the "application/trickle-ice-sdpfrag" body if it supports and uses bundling. When doing so, the Answerer MUST include all identification-tags in the same order that is used or will be used in the Answer. Receipt of this attribute at the Offerer in an INFO request prior to the Answer indicates that the Answerer supports and uses bundling. The Offerer can use this information, e.g., for stopping the gathering of candidates for the remaining "m=" lines in a bundle and/or for freeing corresponding resources. This behavior is illustrated by the following example Offer that indicates support for Media Multiplexing. If the Offerer already sent candidates for "m=" lines in a bundle in a previous INFO request, it still needs to repeat them in subsequent INFO requests, even when that support for bundling was confirmed by the Answerer and the Offerer has released candidates that are no longer needed. v=0 o=alice 2890844526 2890844526 IN IP6 atlanta.example.com s= c=IN IP6 2001:db8:a0b:12f0::3 t=0 0 a=group:BUNDLE foo bar a=ice-pwd:777uzjYhagZgasd88fgpdd a=ice-ufrag:Yhh8 m=audio 10000 RTP/AVP 0 a=mid:foo a=rtcp-mux a=rtpmap:0 PCMU/8000 a=extmap 1 urn:ietf:params:rtp-hdrext:sdes:mid a=candidate:1 1 UDP 1658497328 2001:db8:a0b:12f0::3 10000 typ host m=video 10002 RTP/AVP 31 a=mid:bar a=rtcp-mux a=rtpmap:31 H261/90000 a=extmap 1 urn:ietf:params:rtp-hdrext:sdes:mid The example Offer indicates support for RTP and RTCP multiplexing and contains a "candidate" attribute only for the "m=" line with the suggested Offerer BUNDLE address. Once the dialog is established as described in , the Answerer sends the following INFO request. INFO sip:alice@example.com SIP/2.0 ... Info-Package: trickle-ice Content-type: application/trickle-ice-sdpfrag Content-Disposition: Info-Package Content-length: 219 a=group:BUNDLE foo bar a=ice-pwd:asd88fgpdd777uzjYhagZg a=ice-ufrag:8hhY m=audio 9 RTP/AVP 0 a=mid:foo a=rtcp-mux a=candidate:1 1 UDP 1658497328 2001:db8:a0b:12f0::3 5000 typ host This INFO request indicates that the Answerer supports and uses Media Multiplexing as well. Note that the Answerer only includes a single pseudo "m=" line since candidates matching those from the second "m=" line in the offer are not needed from the Answerer. The INFO request also indicates that the Answerer accepted the suggested Offerer BUNDLE address. This allows the Offerer to omit gathering RTP and RTCP candidates for the other "m=" lines or releasing already gathered candidates. If the INFO request did not contain the "group:BUNDLE" attribute, the Offerer has to gather RTP and RTCP candidates for the other "m=" lines unless it wants to wait until receipt of an Answer that eventually confirms support or non-support for Media Multiplexing. Independent of using Full Trickle or Half Trickle mode, the rules from apply to both, Offerer and Answerer, when putting attributes as specified in in the "application/trickle-ice-sdpfrag" body.
SDP "end-of-candidates" Attribute
Definition This section defines the new SDP media-level and session-level "end-of-candidates" attribute. "end-of-candidates" is a property attribute ; hence, it has no value. By including this attribute in an Offer or Answer, the sending agent indicates that it will not trickle further candidates. When included at the session level, this indication applies to the whole session; when included at the media level, the indication applies only to the corresponding media description.
  • Name:
    end-of-candidates
    Value:
    N/A
    Usage Level:
    media and session level
    Charset Dependent:
    no
    Mux Category:
    IDENTICAL
    Example:
    a=end-of-candidates
Offer/Answer Procedures The Offerer or Answerer MAY include an "end-of-candidates" attribute in case candidate discovery has ended and no further candidates are to be trickled. The Offerer or Answerer MUST provide the "end-of-candidates" attribute together with the "ice-ufrag" and "ice-pwd" attributes of the current ICE generation as required by . When included at the session level, this indication applies to the whole session; when included at the media level, the indication applies only to the corresponding media description. Receipt of an "end-of-candidates" attribute at an Offerer or Answerer -- with the "ice-ufrag" and "ice-pwd" attributes matching the current ICE generation -- indicates that the gathering of candidates has ended at the peer, for either the session or only the corresponding media description as specified above. The receiving agent forwards an end-of-candidates indication to the ICE Agent, which in turn acts as specified in .
Content Type "application/trickle-ice-sdpfrag"
Overall Description An "application/trickle-ice-sdpfrag" body is used exclusively by the "trickle-ice" Info Package. Other SDP-related applications need to define their own media type. The INFO request body uses a subset of the possible SDP lines as defined by the grammar in . A valid body uses only pseudo "m=" lines and certain attributes that are needed and/or useful for trickling candidates. The content adheres to the following grammar.
Grammar The grammar of an "application/trickle-ice-sdpfrag" body is based on the following ABNF . It specifies the subset of existing SDP attributes that is needed or useful for trickling candidates. The grammar uses the indicator for case-sensitive %s, as defined in , but it also imports grammar for other SDP attributes that precede the production of . A sender SHOULD use lower case for attributes from such earlier grammar, but a receiver MUST treat them as case insensitive. ; Syntax trickle-ice-sdpfrag = session-level-fields pseudo-media-descriptions session-level-fields = *(session-level-field CRLF) session-level-field = ice-lite-attribute / ice-pwd-attribute / ice-ufrag-attribute / ice-options-attribute / ice-pacing-attribute / end-of-candidates-attribute / bundle-group-attribute / extension-attribute-fields ; for future extensions ice-lite-attribute = %s"a" "=" ice-lite ice-pwd-attribute = %s"a" "=" ice-pwd-att ice-ufrag-attribute = %s"a" "=" ice-ufrag-att ice-pacing-attribute = %s"a" "=" ice-pacing-att ice-options-attribute = %s"a" "=" ice-options end-of-candidates-attribute = %s"a" "=" end-of-candidates end-of-candidates = %s"end-of-candidates" bundle-group-attribute = %s"a" "=" %s"group:" bundle-semantics *(SP identification-tag) bundle-semantics = "BUNDLE" extension-attribute-fields = attribute-fields pseudo-media-descriptions = *( media-field trickle-ice-attribute-fields ) trickle-ice-attribute-fields = *(trickle-ice-attribute-field CRLF) trickle-ice-attribute-field = mid-attribute / candidate-attributes / ice-pwd-attribute / ice-ufrag-attribute / remote-candidate-attribute / end-of-candidates-attribute / rtcp-attribute / rtcp-mux-attribute / rtcp-mux-only-attribute / extension-attribute-fields ; for future extensions rtcp-attribute = %s"a" "=" %s"rtcp" rtcp-mux-attribute = %s"a" "=" %s"rtcp-mux" rtcp-mux-only-attribute = %s"a" "=" %s"rtcp-mux-only" candidate-attributes = %s"a" "=" candidate-attribute remote-candidate-attribute = %s"a" "=" remote-candidate-att ice-lite, ice-pwd-att, remote-candidate-att, ice-ufrag-att, ice-pacing-att, ice-options, candidate-attribute, and remote-candidate-att are from ; identification-tag and mid-attribute are from ; and media-field and attribute-fields are from . The "rtcp" attribute is defined in , the "rtcp-mux" attribute is defined in , and the "rtcp-mux-only" attribute is defined in . The latter attributes lack formal grammar in their corresponding RFCs and are reproduced here. The "ice-pwd" and "ice-ufrag" attributes MUST appear at the same level as the ones in the Offer/Answer exchange. In other words, if they were present as session-level attributes, they will also appear at the beginning of all INFO request payloads, i.e., preceding all pseudo "m=" lines. If they were originally exchanged as media-level attributes, potentially overriding session-level values, then they will also be included in INFO request payloads following the corresponding pseudo "m=" lines. An Agent MUST ignore any received unknown extension-attribute-fields.
Info Package
Rationale -- Why INFO? The decision to use SIP INFO requests as a candidate transport method is based primarily on their lightweight nature. Once a dialog has been established, INFO requests can be exchanged both ways with no restrictions on timing and frequency and no risk of collision. A critical fact is that the sending of Trickle ICE candidates in one direction is entirely uncoupled from sending candidates in the other direction. Thus, the sending of candidates in each direction can be done by a stream of INFO requests that is not correlated with the stream of INFO requests in the other direction. And since each INFO request cumulatively includes the contents of all previous INFO requests in that direction, the ordering between INFO requests need not be preserved. All of this permits using largely independent INFO requests. Contrarily, UPDATE or other Offer/Answer mechanisms assume that the messages in each direction are tightly coupled with messages in the other direction. Using Offer/Answer and UPDATE requests would introduce the following complications:
Blocking of messages:
Offer/Answer is defined as a strictly sequential mechanism in . There can only be a maximum of one active exchange at any point of time. Both sides cannot simultaneously send Offers nor can they generate multiple Offers prior to receiving an Answer. Using UPDATE requests for candidate transport would therefore imply the implementation of a candidate pool at every agent where candidates can be stored until it is once again that agent's "turn" to emit an Answer or a new Offer. Such an approach would introduce non-negligible complexity for no additional value.
Elevated risk of glare:
The sequential nature of Offer/Answer also makes it impossible for both sides to send Offers simultaneously. What's worse is that there are no mechanisms in SIP to actually prevent that. , where the situation of Offers crossing on the wire is described as "glare", only defines a procedure for addressing the issue after it has occurred. According to that procedure, both Offers are invalidated and both sides need to retry the negotiation after a period between 0 and 4 seconds. The high likelihood for glare and the average two-second backoff intervals to occur implies that the duration of Trickle ICE processing would not only fail to improve but actually exceed those of regular ICE.
INFO messages decouple the exchange of candidates from the Offer/Answer negotiation and are subject to none of the glare issues described above, which makes them a very convenient and lightweight mechanism for asynchronous delivery of candidates. Using in-dialog INFO messages also provides a way of guaranteeing that candidates are delivered end to end, between the same entities that are actually in the process of initiating a session. Out-of-dialog alternatives would have implied requiring support for GRUU that, given GRUUs relatively low adoption levels, would have constituted too strong of a constraint to the adoption of Trickle ICE.
Overall Description This specification defines an Info Package for use by SIP UAs implementing Trickle ICE. INFO requests carry ICE candidates discovered after the peer UAs have confirmed mutual support for Trickle ICE.
Applicability The purpose of the ICE protocol is to establish a media path in the presence of NAT and firewalls. The candidates are transported in INFO requests and are part of this establishment. Candidates sent by a Trickle ICE Agent after the Offer follow the same signaling path and reach the same entity as the Offer itself. While it is true that GRUUs can be used to achieve this, one of the goals of this specification is to allow operation of Trickle ICE in as many environments as possible including those without GRUU support. Using out-of-dialog SUBSCRIBE/NOTIFY requests would not satisfy this goal.
Info Package Name This document defines a SIP Info Package as per . The Info Package token name for this package is "trickle-ice".
Info Package Parameters This document does not define any Info Package parameters.
SIP Option Tags allows Info Package specifications to define SIP option-tags. This specification extends the option-tag construct of the SIP grammar as follows: option-tag /= "trickle-ice" SIP entities that support this specification MUST place the "trickle-ice" option-tag in a SIP Supported: or Require: header field within all SIP INVITE requests and responses. When responding to, or generating, a SIP OPTIONS request, a SIP entity MUST also include the "trickle-ice" option-tag in a SIP Supported: or Require: header field.
INFO Request Body Parts Entities implementing this specification MUST include a payload of type "application/trickle-ice-sdpfrag" in SIP INFO requests as defined in . The payload is used to convey SDP-encoded ICE candidates.
Info Package Usage Restrictions This document does not define any Info Package Usage Restrictions.
Rate of INFO Requests Given that IP addresses may be gathered rapidly, a Trickle ICE Agent with many network interfaces might create a high rate of INFO requests if every newly detected candidate is trickled individually without aggregation. An implementation MUST aggregate ICE candidates in case an unreliable transport protocol such as UDP is used. A Trickle ICE Agent MUST NOT have more than one INFO request pending at any one time. When INFO messages are sent over an unreliable transport, they are retransmitted according to the rules specified in . If the INFO requests are sent on top of TCP, which is probably the standard way, it is not an issue for the network anymore, but it can remain one for SIP proxies and other intermediaries forwarding the SIP INFO messages. Also, an endpoint may not be able to tell that it has congestion controlled transport all the way.
Info Package Security Considerations See .
Deployment Considerations Trickle ICE uses two mechanisms for the exchange of candidate information. This imposes new requirements to certain middleboxes that are used in some networks, e.g., for monitoring purposes. While the first mechanism, SDP Offers and Answers, is already used by regular ICE and is assumed to be supported, the second mechanism, INFO request bodies, needs to be considered by such middleboxes as well when trickle ICE is used. Such middleboxes need to make sure that they remain in the signaling path of the INFO requests and understand the INFO request body.
IANA Considerations
SDP "end-of-candidates" Attribute This section defines a new SDP media-level and session-level "end-of-candidates" attribute, which is a property attribute and hence has no value.
  • Name:
    end-of-candidates
    Value:
    N/A
    Usage Level:
    media and session
    Charset Dependent:
    no
    Purpose:
    The sender indicates that it will not trickle further ICE candidates.
    O/A Procedures:
    RFC 8840 defines the detailed SDP Offer/Answer procedures for the "end-of-candidates" attribute.
    Mux Category:
    IDENTICAL
    Reference:
    RFC 8840
    Example:
    a=end-of-candidates
Media Type "application/trickle-ice-sdpfrag" This document defines the new media type "application/trickle-ice-sdpfrag" in accordance with .
Type name:
application
Subtype name:
trickle-ice-sdpfrag
Required parameters:
None.
Optional parameters:
None.
Encoding considerations:
The media contents follow the same rules as SDP, except as noted in this document. The media contents are text, with the grammar specified in . Although the initially defined content of a trickle-ice-sdpfrag body does only include ASCII characters, UTF-8-encoded content might be introduced via extension attributes. The "charset" attribute may be used to signal the presence of other character sets in certain parts of a trickle-ice-sdpfrag body (see ). Arbitrary binary content cannot be directly represented in SDP or a trickle-ice-sdpfrag body.
Security considerations:
See and RFC 8840
Interoperability considerations:
See RFC 8840
Published specification:
See RFC 8840
Applications that use this media type:
Trickle ICE
Fragment identifier considerations:
N/A
Additional information:
Deprecated alias names for this type:
N/A
Magic number(s):
N/A
File extension(s):
N/A
Macintosh File Type Code(s):
N/A
Person and email address to contact for further information:
The IESG (iesg@ietf.org)
Intended usage:
Trickle ICE for SIP as specified in RFC 8840.
Restrictions on usage:
N/A
Author/Change controller:
The IESG (iesg@ietf.org)
Provisional registration? (standards tree only):
N/A
SIP Info Package "trickle-ice" This document defines a new SIP Info Package named "trickle-ice" and updates the "Info Packages Registry" with the following entry.
Name Reference
trickle-ice RFC 8840
SIP Option Tag "trickle-ice" This specification registers a new SIP option tag "trickle-ice" as per the guidelines in and updates the "Option Tags" subregistry of the SIP Parameters registry with the following entry:
Name Description Reference
trickle‑ice This option tag is used to indicate that a UA supports and understands Trickle ICE. RFC 8840
Security Considerations The Security Considerations of , , and apply. This document clarifies how the above specifications are used together for trickling candidates and does not create additional security risks. The new Info Package "trickle-ice" and the new media type "application/trickle-ice-sdpfrag" do not introduce additional security considerations when used in the context of Trickle ICE. Both are not intended to be used for other applications, so any security considerations for its use in other contexts is out of the scope of this document
References Normative References Key words for use in RFCs to Indicate Requirement Levels In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements. SIP: Session Initiation Protocol This document describes Session Initiation Protocol (SIP), an application-layer control (signaling) protocol for creating, modifying, and terminating sessions with one or more participants. These sessions include Internet telephone calls, multimedia distribution, and multimedia conferences. [STANDARDS-TRACK] Reliability of Provisional Responses in Session Initiation Protocol (SIP) This document specifies an extension to the Session Initiation Protocol (SIP) providing reliable provisional response messages. This extension uses the option tag 100rel and defines the Provisional Response ACKnowledgement (PRACK) method. [STANDARDS-TRACK] An Offer/Answer Model with Session Description Protocol (SDP) This document defines a mechanism by which two entities can make use of the Session Description Protocol (SDP) to arrive at a common view of a multimedia session between them. In the model, one participant offers the other a description of the desired session from their perspective, and the other participant answers with the desired session from their perspective. This offer/answer model is most useful in unicast sessions where information from both participants is needed for the complete view of the session. The offer/answer model is used by protocols like the Session Initiation Protocol (SIP). [STANDARDS-TRACK] Real Time Control Protocol (RTCP) attribute in Session Description Protocol (SDP) The Session Description Protocol (SDP) is used to describe the parameters of media streams used in multimedia sessions. When a session requires multiple ports, SDP assumes that these ports have consecutive numbers. However, when the session crosses a network address translation device that also uses port mapping, the ordering of ports can be destroyed by the translation. To handle this, we propose an extension attribute to SDP. SDP: Session Description Protocol This memo defines the Session Description Protocol (SDP). SDP is intended for describing multimedia sessions for the purposes of session announcement, session invitation, and other forms of multimedia session initiation. [STANDARDS-TRACK] Augmented BNF for Syntax Specifications: ABNF Internet technical specifications often need to define a formal syntax. Over the years, a modified version of Backus-Naur Form (BNF), called Augmented BNF (ABNF), has been popular among many Internet specifications. The current specification documents ABNF. It balances compactness and simplicity with reasonable representational power. The differences between standard BNF and ABNF involve naming rules, repetition, alternatives, order-independence, and value ranges. This specification also supplies additional rule definitions and encoding for a core lexical analyzer of the type common to several Internet specifications. [STANDARDS-TRACK] Multiplexing RTP Data and Control Packets on a Single Port This memo discusses issues that arise when multiplexing RTP data packets and RTP Control Protocol (RTCP) packets on a single UDP port. It updates RFC 3550 and RFC 3551 to describe when such multiplexing is and is not appropriate, and it explains how the Session Description Protocol (SDP) can be used to signal multiplexed sessions. [STANDARDS-TRACK] The Session Description Protocol (SDP) Grouping Framework In this specification, we define a framework to group "m" lines in the Session Description Protocol (SDP) for different purposes. This framework uses the "group" and "mid" SDP attributes, both of which are defined in this specification. Additionally, we specify how to use the framework for two different purposes: for lip synchronization and for receiving a media flow consisting of several media streams on different transport addresses. This document obsoletes RFC 3388. [STANDARDS-TRACK] Session Initiation Protocol (SIP) INFO Method and Package Framework This document defines a method, INFO, for the Session Initiation Protocol (SIP), and an Info Package mechanism. This document obsoletes RFC 2976. For backward compatibility, this document also specifies a "legacy" mode of usage of the INFO method that is compatible with the usage previously defined in RFC 2976, referred to as "legacy INFO Usage" in this document. [STANDARDS-TRACK] Media Type Specifications and Registration Procedures This document defines procedures for the specification and registration of media types for use in HTTP, MIME, and other Internet protocols. This memo documents an Internet Best Current Practice. Case-Sensitive String Support in ABNF This document extends the base definition of ABNF (Augmented Backus-Naur Form) to include a way to specify US-ASCII string literals that are matched in a case-sensitive manner. Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings. Interactive Connectivity Establishment (ICE): A Protocol for Network Address Translator (NAT) Traversal This document describes a protocol for Network Address Translator (NAT) traversal for UDP-based communication. This protocol is called Interactive Connectivity Establishment (ICE). ICE makes use of the Session Traversal Utilities for NAT (STUN) protocol and its extension, Traversal Using Relay NAT (TURN). This document obsoletes RFC 5245. Trickle ICE: Incremental Provisioning of Candidates for the Interactive Connectivity Establishment (ICE) Protocol Session Description Protocol (SDP) Offer/Answer Procedures for Interactive Connectivity Establishment (ICE) Negotiating Media Multiplexing Using the Session Description Protocol (SDP) Indicating Exclusive Support of RTP and RTP Control Protocol (RTCP) Multiplexing Using the Session Description Protocol (SDP) A Framework for Session Description Protocol (SDP) Attributes When Multiplexing Informative References The Session Initiation Protocol (SIP) UPDATE Method Indicating User Agent Capabilities in the Session Initiation Protocol (SIP) This specification defines mechanisms by which a Session Initiation Protocol (SIP) user agent can convey its capabilities and characteristics to other user agents and to the registrar for its domain. This information is conveyed as parameters of the Contact header field. [STANDARDS-TRACK] Session Traversal Utilities for NAT (STUN) Session Traversal Utilities for NAT (STUN) is a protocol that serves as a tool for other protocols in dealing with Network Address Translator (NAT) traversal. It can be used by an endpoint to determine the IP address and port allocated to it by a NAT. It can also be used to check connectivity between two endpoints, and as a keep-alive protocol to maintain NAT bindings. STUN works with many existing NATs, and does not require any special behavior from them. STUN is not a NAT traversal solution by itself. Rather, it is a tool to be used in the context of a NAT traversal solution. This is an important change from the previous version of this specification (RFC 3489), which presented STUN as a complete solution. This document obsoletes RFC 3489. [STANDARDS-TRACK] Obtaining and Using Globally Routable User Agent URIs (GRUUs) in the Session Initiation Protocol (SIP) Several applications of the Session Initiation Protocol (SIP) require a user agent (UA) to construct and distribute a URI that can be used by anyone on the Internet to route a call to that specific UA instance. A URI that routes to a specific UA instance is called a Globally Routable UA URI (GRUU). This document describes an extension to SIP for obtaining a GRUU from a registrar and for communicating a GRUU to a peer within a dialog. [STANDARDS-TRACK] Traversal Using Relays around NAT (TURN): Relay Extensions to Session Traversal Utilities for NAT (STUN) If a host is located behind a NAT, then in certain situations it can be impossible for that host to communicate directly with other hosts (peers). In these situations, it is necessary for the host to use the services of an intermediate node that acts as a communication relay. This specification defines a protocol, called TURN (Traversal Using Relays around NAT), that allows the host to control the operation of the relay and to exchange packets with its peers using the relay. TURN differs from some other relay control protocols in that it allows a client to communicate with multiple peers using a single relay address. [STANDARDS-TRACK]
Acknowledgements The authors like to thank , , , , , , and for reviewing and/or making various suggestions for improvements and optimizations. The authors also like to thank for shepherding this document and for his AD review and suggestions. In addition, the authors thank , , , and for their comments and/or text proposals for improving the document during IESG review. Many thanks to for the Gen-Art review and proposed enhancements for several sections. Many thanks to for the TSV-Art review and suggested improvements. The authors thank for the Security Directorate review.
Authors' Addresses Jitsi
Strasbourg 67000 France +33 6 72 81 15 55 emcho@jitsi.org
Unaffiliated
Vienna 1130 Austria thomass.stach@gmail.com
Telecom Italia
Via G. Reiss Romoli, 274 Turin 10148 Italy enrico.marocco@telecomitalia.it
Ericsson
Hirsalantie 11 02420 Jorvas Finland christer.holmberg@ericsson.com