Internet DRAFT - draft-cbran-rtcweb-nat
draft-cbran-rtcweb-nat
Network Working Group C. Bran
Internet-Draft Plantrontics
Intended status: Standards Track M. Kaufman
Expires: May 1, 2012 Skype
C. Jennings
Cisco
J. Rosenberg
Skype
October 29, 2011
WebRTC Network Address Translation
draft-cbran-rtcweb-nat-02
Abstract
This document outlines the network address translation (NAT)
traversal requirements and for WebRTC client applications.
Status of this Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79. This document may not be modified,
and derivative works of it may not be created, and it may not be
published except as an Internet-Draft.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/.
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."
This Internet-Draft will expire on May 1, 2012.
Copyright Notice
Copyright (c) 2011 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
(http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
Bran, et al. Expires May 1, 2012 [Page 1]
Internet-Draft Abbreviated-Title October 2011
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
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . 3
3. Connection Management Requirements . . . . . . . . . . . . . . 3
3.1. NAT Traversal Requirements . . . . . . . . . . . . . . . . 3
3.2. Data Transmission Requirements . . . . . . . . . . . . . . 3
3.3. IPv4 to IPv6 Transition Requirements . . . . . . . . . . . 4
3.4. Legacy Phone System Interoperability Requirements . . . . . 4
4. Connection Management Mechanism . . . . . . . . . . . . . . . . 4
4.1. ICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
4.1.1. ICE as a Consent Mechanism . . . . . . . . . . . . . . 4
4.2. Web Browsers and ICE . . . . . . . . . . . . . . . . . . . 5
4.2.1. Native ICE Support . . . . . . . . . . . . . . . . . . 5
4.2.2. STUN Configuration . . . . . . . . . . . . . . . . . . 5
5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . . 6
6. Security Considerations . . . . . . . . . . . . . . . . . . . . 6
7. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 6
8. Normative References . . . . . . . . . . . . . . . . . . . . . 6
Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 7
Bran, et al. Expires May 1, 2012 [Page 2]
Internet-Draft Abbreviated-Title October 2011
1. Introduction
An integral part of the of the Web Real Time Communications (WebRTC)
will be the ability for client application implementations to have
native, secure Network Address Translation (NAT) [RFC1631] traversal
capabilities. This document provides requirements and implementation
specifications WebRTC client 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].
3. Connection Management Requirements
This section identifies the requirements for RTC-Web client
applications to connection requirements.
3.1. NAT Traversal Requirements
A majority of WebRTC clients will be web browsers and used behind a
NAT and or firewall. WebRTC clients will use a UDP-based data
transmission scheme for multimedia sessions [Open Issue: what draft
should be cited for this requirement?]. UDP has well know NAT
traversal problems and without native capabilities to traverse a NAT,
WebRTC clients will be extremely limited in their functionality.
Fortunately NAT traversal for UDP is a solved problem, but solutions
require that clients transmitting media between each other need to
use the same NAT traversal algorithms. Without a consistent, well
specified NAT traversal mechanism WebRTC client implementations would
likely be inoperable with each other. To address the identified
problems WebRTC clients are REQUIRED to implement the NAT traversal
mechanism as defined in Section 4.
3.2. Data Transmission Requirements
Whenever a calling WebRTC client attempts to establish a connection,
the receiving WebRTC client MUST provide consent before the calling
client can transmit data to the receiver. Providing consent on the
receiving end before data transmission commence is needed to help to
prevent malicious attacks by the calling client. All WebRTC clients
are REQUIRED to implement connection management that provides a
consent mechanism for media transmission. Furthermore it is REQUIRED
that consent be given by the recipient before an WebRTC client can
transmit media.
Bran, et al. Expires May 1, 2012 [Page 3]
Internet-Draft Abbreviated-Title October 2011
As a note providing consent to open a media connection does not
involve user-level consent, rather it is the responsibility of the
WebRTC client application (e.g. web browser) to enforce this
requirement.
3.3. IPv4 to IPv6 Transition Requirements
RTC-Web clients MUST support IPv4 to IPv6 transition.
3.4. Legacy Phone System Interoperability Requirements
There is no way to meet all the connection management requirements
and maintain compatibility with all legacy phone systems. It is
highly desirable that the WebRTC connection management mechanism be
interoperable with legacy phone systems such as a VOIP endpoints,
PSTN gateways and SIP trunks.
4. Connection Management Mechanism
This section specifies the connection management system that will
address the identified requirements.
4.1. ICE
To address the NAT traversal, data transmission, and interoperability
requirements all WebRTC client applications are REQUIRED to implement
ICE [RFC5245]. Implicit to ICE, and listed here for clarity, WebRTC
client implementations will are also REQUIRED to implement STUN
[RFC3489] and TURN [RFC5766].
Additional ICE requirements:
o Support of ICE's Aggressive Nomination is REQUIRED
o Support of ICE's Regular Nomination is OPTIONAL
o WebRTC media gateways MAY implement ICE-Lite instead of full ICE
4.1.1. ICE as a Consent Mechanism
Of the connection management requirements listed above, the least
obvious is how ICE will satisfy being a consent mechanism for data
transmission Section 3.2. The reason ICE can satisfy this
requirement is due to its reliance on STUN transactions to succeed in
order to establish a connection. The success of a STUN transaction
can be viewed as semantically the same thing as a recipient providing
consent to transmit data. Conversely the failure of the STUN
Bran, et al. Expires May 1, 2012 [Page 4]
Internet-Draft Abbreviated-Title October 2011
transaction would semantically map to the recipient rejecting the
request to transmit data.
4.2. Web Browsers and ICE
This section specifies the web browser implementation requirements
for WebRTC client connection management.
4.2.1. Native ICE Support
To meet the WebRTC connectivity requirements, web browser vendors
MUST natively support ICE [RFC5245]. Access to the web browser's ICE
implementation will be defined in the W3C WebRTC-API
specification[I.D.w3c-webrtc].
Alternate proposals have been made that advocate for natively
exposing STUN[RFC3489] APIs in the web browser. The ICE
implementation would be realized via a JavaScript library that uses
the browser's native STUN API. After reviewing the alternate
proposals the solution several issues were identified.
1. JavaScript running within "real world" web applications cannot
reliably handle the ICE timing and pacing requirements. An
example of this is long running JavaScript code from embedded
advertisers. A big JavaScript file can take a significant amount
of time to execute and can prevent web application timers from
firing in correctly. Given the pacing requirements for ICE are
in the 20ms range, it is highly likely that ICE will break if it
is implemented in a JavaScript library.
2. Multiple implementations of a JavaScript ICE library is a
logistical nightmare. Coordinating updates, bug fixes,
enhancements and a testing matrix for interoperability at
Internet scale will simply be impossible.
4.2.2. STUN Configuration
Web browsers MUST provide a mechanism to configure access to a STUN
server.
Below are some proposed mechanisms by which the STUN server could be
configured:
o A preference page, similar to the what web browser's use for
configuring web proxy settings
o Exposed as a JavaScript API and added to the W3C WebRTC-API
specification
Bran, et al. Expires May 1, 2012 [Page 5]
Internet-Draft Abbreviated-Title October 2011
Regardless of the mechanism adopted by the web browser vendor, the
following configuration data is REQUIRED to be exposed and settable
through the web browsers configuration mechanism:
o STUN Server Address - the IPv4 or IPv6 address of the STUN server
o STUN Server Port
o Credentials to access the STUN server (these are not STUN
generated credentials)
5. IANA Considerations
This document makes no request of IANA.
Note to RFC Editor: this section may be removed on publication as an
RFC.
6. Security Considerations
To guard against spoofing RTC-Web client applications are REQUIRED
to:
o Internally encapsulate the generation of STUN transaction IDs
o Block read/write access to the generated STUN transaction IDs
7. Acknowledgements
This draft incorporates ideas and text from the IETF mailing list.
In particularly we would like to acknowledge, and say thanks for,
work we incorporated from Timothy Terriberry and Christopher
Blizzard.
8. Normative References
[I.D.w3c-webrtc]
Bergkvist, A., Burnett, D., Jennings, C., and A.
Narayanan, "WebRTC 1.0: Real-time Communication Between
Browsers", October 2011.
[RFC1631] Egevang, K. and P. Francis, "The IP Network Address
Translator (NAT)", RFC 1631, May 1994.
Bran, et al. Expires May 1, 2012 [Page 6]
Internet-Draft Abbreviated-Title October 2011
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC3489] Rosenberg, J., Weinberger, J., Huitema, C., and R. Mahy,
"STUN - Simple Traversal of User Datagram Protocol (UDP)
Through Network Address Translators (NATs)", RFC 3489,
March 2003.
[RFC5245] Rosenberg, J., "Interactive Connectivity Establishment
(ICE): A Protocol for Network Address Translator (NAT)
Traversal for Offer/Answer Protocols", RFC 5245,
April 2010.
[RFC5766] Mahy, R., Matthews, P., and J. Rosenberg, "Traversal Using
Relays around NAT (TURN): Relay Extensions to Session
Traversal Utilities for NAT (STUN)", RFC 5766, April 2010.
Authors' Addresses
Cary Bran
Plantrontics
345 Encinal Street
Santa Cruz, CA 95060
USA
Phone: +1 206 661-2398
Email: cary.bran@plantronics.com
Matthew Kaufman
Skype
3210 Porter Drive
Palo Alto, California 94304
US
Phone: +1 831 440 8771
Email: matthew.kaufman@skype.net
Bran, et al. Expires May 1, 2012 [Page 7]
Internet-Draft Abbreviated-Title October 2011
Cullen Jennings
Cisco
170 West Tasman Drive
San Jose, CA 95134
USA
Phone: +1 408 421-9990
Email: fluffy@cisco.com
Jonathan Rosenberg
Skype
3210 Porter Drive
Palo Alto, California 94304
US
Email: jdrosen@skype.net
Bran, et al. Expires May 1, 2012 [Page 8]