WebRTC use cases: Web Real-Time Communication Use Cases and Requirements
What web browsers need to support real-time voice, video, and data communication
Holmberg, C., Hakansson, S., and G. Eriksson, "Web Real-Time Communication Use Cases and Requirements", RFC 7478, DOI 10.17487/RFC7478, March 2015, <https://www.rfc-editor.org/info/rfc7478>.
@misc{rfc7478,
series = {Request for Comments},
number = 7478,
howpublished = {RFC 7478},
publisher = {RFC Editor},
doi = {10.17487/RFC7478},
url = {https://www.rfc-editor.org/info/rfc7478},
author = {C. Holmberg and S. Hakansson and G. Eriksson},
title = {{Web Real-Time Communication Use Cases and Requirements}},
pagetotal = 28,
year = 2015,
month = mar,
} RFC text
Contents
Internet Engineering Task Force (IETF) C. Holmberg
Request for Comments: 7478 S. Hakansson
Category: Informational G. Eriksson
ISSN: 2070-1721 Ericsson
March 2015
Web Real-Time Communication Use Cases and Requirements
Abstract
This document describes web-based real-time communication use cases.
Requirements on the browser functionality are derived from the use
cases.
This document was developed in an initial phase of the work with
rather minor updates at later stages. It has not really served as a
tool in deciding features or scope for the WG's efforts so far. It
is being published to record the early conclusions of the WG. It
will not be used as a set of rigid guidelines that specifications and
implementations will be held to in the future.
Status of This Memo
This document is not an Internet Standards Track specification; it is
published for informational purposes.
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). Not all documents
approved by the IESG are a candidate for any level of Internet
Standard; see Section 2 of RFC 5741.
Information about the current status of this document, any errata,
and how to provide feedback on it may be obtained at
http://www.rfc-editor.org/info/rfc7478.
Copyright Notice
Copyright (c) 2015 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
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 ....................................................4
2. Use Cases .......................................................4
2.1. Introduction ...............................................4
2.2. Common Requirements ........................................5
2.3. Browser-to-Browser Use Cases ...............................5
2.3.1. Simple Video Communication Service ..................5
2.3.2. Simple Video Communication Service:
NAT/Firewall That Blocks UDP ........................8
2.3.3. Simple Video Communication Service: Firewall
That Only Allows Traffic via an HTTP Proxy ..........8
2.3.4. Simple Video Communication Service: Global
Service Provider ....................................8
2.3.5. Simple Video Communication Service:
Enterprise Aspects ..................................9
2.3.6. Simple Video Communication Service: Access Change ..10
2.3.7. Simple Video Communication Service: QoS ............11
2.3.8. Simple Video Communication Service with
Screen Sharing .....................................11
2.3.9. Simple Video Communication Service with
File Exchange ......................................12
2.3.10. Hockey Game Viewer ................................12
2.3.11. Multiparty Video Communication ....................14
2.3.12. Multiparty Online Game with Voice Communication ...15
2.4. Browser - GW/Server Use Cases .............................17
2.4.1. Telephony Terminal .................................17
2.4.2. FedEx Call .........................................17
2.4.3. Video Conferencing System with Central Server ......18
3. Requirements Summary ...........................................19
3.1. General ...................................................19
3.2. Browser Requirements ......................................19
4. Security Considerations ........................................23
4.1. Introduction ..............................................23
4.2. Browser Considerations ....................................24
4.3. Web Application Considerations ............................24
5. Normative References ...........................................25
Appendix A. API Requirements ......................................26
Acknowledgements ..................................................29
Authors' Addresses ................................................29
1. Introduction
This document presents a few use cases of web applications that are
executed in a browser and use real-time communication capabilities.
In most of the use cases, all end-user clients are web applications,
but there are some use cases where at least one of the end-user
clients is of another type (e.g., a mobile phone or a SIP User Agent
(UA)).
Based on the use cases, the document derives requirements related to
browser functionality. These requirements are named "Fn", where n is
an integer, and are listed in conjunction with the use cases. A
summary is provided in Section 3.2.
This document was developed in an initial phase of the work with
rather minor updates at later stages. It has not really served as a
tool in deciding features or scope for the WG's efforts so far. It
is proposed to be used in a later phase to evaluate the protocols and
solutions developed by the WG.
This document also lists requirements related to the API to be used
by web applications as an appendix. The reason is that the W3C
WebRTC WG has decided to not develop its own use-case or requirement
document, but instead will use this document. These requirements are
named "An", where n is an integer, and are described in Appendix A.
This document was developed in an initial phase of the work with
rather minor updates at later stages. It has not really served as a
tool in deciding features or scope for the WG's efforts so far. It
is being published to record the early conclusions of the WG. It
will not be used as a set of rigid guidelines that specifications and
implementations will be held to in the future.
2. Use Cases
2.1. Introduction
This section describes web-based real-time communication use cases,
from which requirements are derived.
The following considerations are applicable to all use cases:
o Clients can be on IPv4-only
o Clients can be on IPv6-only
o Clients can be on dual-stack
o Clients can be connected to networks with different throughput
capabilities
o Clients can be on variable-media-quality networks (wireless)
o Clients can be on congested networks
o Clients can be on firewalled networks with no UDP allowed
o Clients can be on networks with a NAT or IPv4-IPv6 translation
devices using any type of Mapping and Filtering behaviors (as
described in RFC 4787).
2.2. Common Requirements
The requirements retrieved from the
Simple Video Communication Service use case (Section 2.3.1) by
default apply to all other use cases and are considered common. For
each use case, only the additional requirements are listed.
2.3. Browser-to-Browser Use Cases
2.3.1. Simple Video Communication Service
2.3.1.1. Description
Two or more users have loaded a video communication web application
into their browsers, provided by the same service provider, and
logged into the service it provides. The web service publishes
information about user login status by pushing updates to the web
application in the browsers. When one online user selects a peer
online user, a 1:1 audiovisual communication session between the
browsers of the two peers is initiated. The invited user might
accept or reject the session.
During session establishment, a self view is displayed, and once the
session has been established the video sent from the remote peer is
displayed in addition to the self view. During the session, each
user can:
o select to remove and reinsert the self-view as often as desired,
o change the sizes of his/her two video displays during the session,
and
o pause the sending of media (audio, video, or both) and mute
incoming media.
It is essential that media and data be encrypted, authenticated, and
integrity protected on a per-IP-packet basis and that media and data
packets failing the integrity check not be delivered to the
application.
The application gives the users the opportunity to stop it from
exposing the host IP address to the application of the other user.
Any session participant can end the session at any time.
The two users may be using communication devices with different
operating systems and browsers from different vendors.
The web service monitors the quality of the service (focus on quality
of audio and video) that the end users experience.
2.3.1.2. Common Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F1 The browser must be able to use microphones and
cameras as input devices to generate streams.
----------------------------------------------------------------
F2 The browser must be able to send streams and
data to a peer in the presence of NATs.
----------------------------------------------------------------
F3 Transmitted streams and data must be rate
controlled (meaning that the browser must, regardless
of application behavior, reduce send rate when
there is congestion).
----------------------------------------------------------------
F4 The browser must be able to receive, process, and
render streams and data ("render" does not
apply for data) from peers.
----------------------------------------------------------------
F5 The browser should be able to render good quality
audio and video even in the presence of
reasonable levels of jitter and packet losses.
----------------------------------------------------------------
F6 The browser must detect when a stream from a
peer is not received anymore.
----------------------------------------------------------------
F7 When there are both incoming and outgoing audio
streams, echo cancellation must be made
available to avoid disturbing echo during
conversation.
----------------------------------------------------------------
F8 The browser must support synchronization of
audio and video.
----------------------------------------------------------------
F9 The browser should use encoding of streams
suitable for the current rendering (e.g.,
video display size) and should change parameters
if the rendering changes during the session.
----------------------------------------------------------------
F10 The browser must support a baseline audio and
video codec.
----------------------------------------------------------------
F11 It must be possible to protect streams and data
from wiretapping [RFC2804] [RFC7258].
----------------------------------------------------------------
F12 The browser must enable verification, given
the right circumstances and by use of other
trusted communication, that streams and
data received have not been manipulated by
any party.
----------------------------------------------------------------
F13 The browser must encrypt, authenticate, and
integrity protect media and data on a
per-IP-packet basis, and it must drop incoming media
and data packets that fail the per-IP-packet
integrity check. In addition, the browser
must support a mechanism for cryptographically
binding media and data security keys to the
user identity (see R-ID-BINDING in [RFC5479]).
----------------------------------------------------------------
F14 The browser must make it possible to set up a
call between two parties without one party
learning the other party's host IP address.
----------------------------------------------------------------
F15 The browser must be able to collect statistics,
related to the transport of audio and video
between peers, needed to estimate quality of
experience.
----------------------------------------------------------------
A1, A2, A3, A4, A5, A6, A7, A8, A9, A10, A11, A12, A25, A26
2.3.2. Simple Video Communication Service: NAT/Firewall That Blocks UDP
2.3.2.1. Description
This use case is almost identical to the
Simple Video Communication Service use case (Section 2.3.1). The
difference is that one of the users is behind a NAT/firewall that
blocks UDP traffic.
2.3.2.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F18 The browser must be able to send streams and
data to a peer in the presence of NATs and
firewalls that block UDP traffic.
----------------------------------------------------------------
2.3.3. Simple Video Communication Service: Firewall That Only Allows
Traffic via an HTTP Proxy
2.3.3.1. Description
This use case is almost identical to the
Simple Video Communication Service use case (Section 2.3.1). The
difference is that one of the users is behind a firewall that only
allows traffic via an HTTP Proxy.
2.3.3.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F21 The browser must be able to send streams and
data to a peer in the presence of firewalls that only
allow traffic via an HTTP Proxy, when firewall policy
allows WebRTC traffic.
----------------------------------------------------------------
2.3.4. Simple Video Communication Service: Global Service Provider
2.3.4.1. Description
This use case is almost identical to the
Simple Video Communication Service use case (Section 2.3.1). What is
added is that the service provider is operating over large
geographical areas (or even globally).
Assuming that the Interactive Connectivity Establishment (ICE)
mechanism [RFC5245] will be used, this means that the service
provider would like to be able to provide several Session Traversal
Utilities for NAT (STUN) and Traversal Using Relay NAT (TURN) servers
(via the app) to the browser; selection of which one(s) to use is
part of the ICE processing. Other reasons for wanting to provide
several STUN and TURN servers include support for IPv4 and IPv6, load
balancing, and redundancy.
Note that ICE support being mandatory does not preclude a WebRTC
endpoint from supporting more traversal mechanisms than ICE using
STUN and TURN.
2.3.4.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F19 The browser must be able to use several STUN
and TURN servers.
----------------------------------------------------------------
A22
2.3.5. Simple Video Communication Service: Enterprise Aspects
2.3.5.1. Description
This use case is similar to the Simple Video Communication Service
use case (Section 2.3.1).
What is added is aspects when using the service in enterprises. ICE
is assumed in the further description of this use case.
An enterprise that uses a WebRTC-based web application for
communication desires to audit all WebRTC-based application sessions
used from inside the company towards any external peer. To be able
to do this, they deploy a TURN server that straddles the boundary
between the internal and the external network.
The firewall will block all attempts to use STUN with an external
destination unless they go to the enterprise auditing TURN server.
In cases where employees are using WebRTC applications provided by an
external service provider, they still want the traffic to stay inside
their internal network and in addition not load the straddling TURN
server; thus, they deploy a STUN server allowing the WebRTC client to
determine its server reflexive address on the internal side. Thus,
enabling cases where peers are both on the internal side to connect
without the traffic leaving the internal network. It must be
possible to configure the browsers used in the enterprise with
network specific STUN and TURN servers. This should be possible to
achieve by autoconfiguration methods. The WebRTC functionality will
need to utilize both network specific STUN and TURN resources and
STUN and TURN servers provisioned by the web application.
2.3.5.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F20 The browser must support the use of STUN and TURN
servers that are supplied by entities other than
the web application (i.e., the network provider).
----------------------------------------------------------------
2.3.6. Simple Video Communication Service: Access Change
2.3.6.1. Description
This use case is almost identical to the
Simple Video Communication Service use case (Section 2.3.1). The
difference is that the user changes network access during the
session.
The communication device used by one of the users has several network
adapters (Ethernet, Wi-Fi, Cellular). The communication device is
accessing the Internet using Ethernet, but the user has to start a
trip during the session. The communication device automatically
changes to use Wi-Fi when the Ethernet cable is removed and then
moves to cellular access to the Internet when moving out of Wi-Fi
coverage. The session continues even though the access method
changes.
2.3.6.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F17 The communication session must survive across a
change of the network interface used by the
session.
----------------------------------------------------------------
2.3.7. Simple Video Communication Service: QoS
2.3.7.1. Description
This use case is almost identical to the
Simple Video Communication Service: Access Change use case
(Section 2.3.6). The use of Quality of Service (QoS) capabilities is
added:
The user in the previous use case that starts a trip is behind a
common residential router that supports differentiation of traffic.
In addition, the user's provider of cellular access has QoS support
enabled. The user is able to take advantage of the QoS support both
when accessing via the residential router and when using cellular.
2.3.7.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F17 The communication session must survive across a
change of the network interface used by the
session.
----------------------------------------------------------------
F22 The browser should be able to take advantage
of available capabilities (supplied by network
nodes) to differentiate voice, video, and data
appropriately.
----------------------------------------------------------------
2.3.8. Simple Video Communication Service with Screen Sharing
2.3.8.1. Description
This use case has the audio and video communication of the
Simple Video Communication Service use case (Section 2.3.1).
However, in addition to this, one of the users can share what is
being displayed on her/his screen with a peer. The user can choose
to share the entire screen, part of the screen (part selected by the
user), or what a selected application displays with the peer.
2.3.8.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F36 The browser must be able to generate streams
using the entire user display, a specific area
of the user display, or the information being
displayed by a specific application.
----------------------------------------------------------------
A21
2.3.9. Simple Video Communication Service with File Exchange
2.3.9.1. Description
This use case has the audio and video communication of the
Simple Video Communication Service use case (Section 3.3.1).
However, in addition to this, the users can send and receive files
stored in the file system of the device used.
2.3.9.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F35 The browser must be able to send reliable
data traffic to a peer browser.
----------------------------------------------------------------
A21, A24
2.3.10. Hockey Game Viewer
2.3.10.1. Description
An ice-hockey club uses an application that enables talent scouts to,
in real-time, show and discuss games and players with the club
manager. The talent scouts use a mobile phone with two cameras: one
front facing and one rear facing.
The club manager uses a desktop, equipped with one camera, for
viewing the game and discussing with the talent scout.
Before the game starts, and during game breaks, the talent scout and
the manager have a 1:1 audiovisual communication session. On the
mobile phone, only the camera facing the talent scout is used. On
the user display of the mobile phone, the video of the club manager
is shown with a picture-in-picture thumbnail of the rear-facing
camera (self view). On the display of the desktop, the video of the
talent scout is shown with a picture-in-picture thumbnail of the
desktop camera (self view).
When the game is ongoing, the talent scout activates the use of the
front-facing camera, and that stream is sent to the desktop (the
stream from the rear-facing camera continues to be sent all the
time). The video stream captured by the front-facing camera (that is
capturing the game) of the mobile phone is shown in a big window on
the desktop screen, with picture-in-picture thumbnails of the rear-
facing camera and the desktop camera (self view). On the display of
the mobile phone the game is shown (front-facing camera) with
picture-in-picture thumbnails of the rear-facing camera (self view)
and the desktop camera. Because the most important stream in this
phase is the video showing the game, the application used in the
talent scout's mobile phone sets higher priority for that stream.
2.3.10.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F22 The browser should be able to take advantage
of available capabilities (supplied by network
nodes) to differentiate voice, video, and data
appropriately.
----------------------------------------------------------------
F25 The browser must be able to render several
concurrent audio and video streams.
----------------------------------------------------------------
A17, A23
2.3.11. Multiparty Video Communication
2.3.11.1. Description
In this use case, the Simple Video Communication Service use case
(Section 2.3.1) is extended by allowing multiparty sessions. No
central server is involved -- the browser of each participant sends
and receives streams to and from all other session participants. The
web application in the browser of each user is responsible for
setting up streams to all receivers.
In order to enhance the user experience, the web application renders
the audio coming from different participants so that it is
experienced to come from different spatial locations. This is done
automatically, but users can change how the different participants
are placed in the (virtual) room. In addition, the levels in the
audio signals are adjusted before mixing.
Another feature intended to enhance the user experience is the
highlighting of the video window that displays the video of the
currently speaking peer.
Each video stream received is, by default, displayed in a thumbnail
frame within the browser, but users can change the display size.
Note: What this use case adds in terms of requirements are
capabilities to send streams to and receive streams from several
peers concurrently as well as the capabilities to render the video
from all received streams and be able to spatialize, level adjust,
and mix the audio from all received streams locally in the browser.
It also adds the capability to measure the audio level/activity.
2.3.11.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F23 The browser must be able to transmit streams and
data to several peers concurrently.
----------------------------------------------------------------
F24 The browser must be able to receive streams and
data from multiple peers concurrently.
----------------------------------------------------------------
F25 The browser must be able to render several
concurrent audio and video streams.
----------------------------------------------------------------
F26 The browser must be able to mix several
audio streams.
----------------------------------------------------------------
F27 The browser must be able to apply spatialization
effects to audio streams.
----------------------------------------------------------------
F28 The browser must be able to measure the
voice activity level in audio streams.
----------------------------------------------------------------
F29 The browser must be able to change the
voice activity level in audio streams.
----------------------------------------------------------------
A13, A14, A15, A16
2.3.12. Multiparty Online Game with Voice Communication
2.3.12.1. Description
This use case is based on the previous one. In this use case, the
voice part of the multiparty video communication use case is used in
the context of an online game. The received voice audio media is
rendered together with game sound objects. For example, the sound of
a tank moving from left to right over the screen must be rendered and
played to the user together with the voice media.
Quick updates of the game state are required, and they have higher
priority than the voice.
Note: the difference regarding local audio processing compared to the
"Multiparty Video Communication" use case is that other sound objects
than the streams must be possible to be included in the
spatialization and mixing. "Other sound objects" could for example
be a file with the sound of the tank; that file could be stored
locally or remotely.
2.3.12.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F22 The browser should be able to take advantage
of available capabilities (supplied by network
nodes) to differentiate voice, video, and data
appropriately.
----------------------------------------------------------------
F23 The browser must be able to transmit streams and
data to several peers concurrently.
----------------------------------------------------------------
F24 The browser must be able to receive streams and
data from multiple peers concurrently.
----------------------------------------------------------------
F25 The browser must be able to render several
concurrent audio and video streams.
----------------------------------------------------------------
F26 The browser must be able to mix several
audio streams.
----------------------------------------------------------------
F27 The browser must be able to apply spatialization
effects when playing audio streams.
----------------------------------------------------------------
F28 The browser must be able to measure the
voice activity level in audio streams.
----------------------------------------------------------------
F29 The browser must be able to change the
voice activity level in audio streams.
----------------------------------------------------------------
F30 The browser must be able to process and mix
sound objects (media that is retrieved from
another source than the established media
stream(s) with the peer(s) with audio streams).
----------------------------------------------------------------
F34 The browser must be able to send short
latency unreliable datagram traffic to a
peer browser [RFC5405].
----------------------------------------------------------------
A13, A14, A15, A16, A17, A18, A23
2.4. Browser - GW/Server Use Cases
2.4.1. Telephony Terminal
2.4.1.1. Description
A mobile telephony operator allows its customers to use a web browser
to access their services. After a simple log in, the user can place
and receive calls in the same way as when using a normal mobile
phone. When a call is received or placed, the identity is shown in
the same manner as when a mobile phone is used.
Note: "place and receive calls in the same way as when using a normal
mobile phone" means that you can dial a number and your mobile
telephony operator has made available your phone contacts online so
that they are available and can be clicked to call and they can be
used to present the identity of an incoming call. If the callee is
not in your phone contacts, the number is displayed. Furthermore,
your call logs are available, and updated with the calls made/
received from the browser. For people receiving calls made from the
web browser, the usual identity (i.e., the phone number of the mobile
phone) will be presented.
2.4.1.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F31 The browser must support an audio media format
(codec) that is commonly supported by existing
telephony services.
----------------------------------------------------------------
F33 The browser must be able to initiate and
accept a media session where the data needed
for establishment can be carried in SIP.
----------------------------------------------------------------
2.4.2. FedEx Call
2.4.2.1. Description
Alice uses her web browser with a service that allows her to call
Public Switched Telephone Network (PSTN) numbers. Alice calls
1-800-123-4567. Alice should be able to hear the initial prompts
from the FedEx Interactive Voice Responder (IVR), and when the IVR
says press 1, there should be a way for Alice to navigate the IVR.
2.4.2.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F31 The browser must support an audio media format
(codec) that is commonly supported by existing
telephony services.
----------------------------------------------------------------
F32 There should be a way to navigate
a dual-tone multi-frequency signaling (DTMF)
based Interactive Voice Response (IVR) system.
----------------------------------------------------------------
2.4.3. Video Conferencing System with Central Server
2.4.3.1. Description
An organization uses a video communication system that supports the
establishment of multiparty video sessions using a central conference
server.
The browser of each participant sends an audio stream (type in terms
of mono, stereo, 5.1 -- depending on the equipment of the
participant) to the central server. The central server mixes the
audio streams (and can in the mixing process naturally add effects
such as spatialization) and sends towards each participant a mixed
audio stream that is played to the user.
The browser of each participant sends video towards the server. For
each participant, one high-resolution video is displayed in a large
window, while a number of low-resolution videos are displayed in
smaller windows. The server selects what video streams to be
forwarded as main and thumbnail videos, respectively, based on speech
activity. As the video streams to display can change quite
frequently (as the conversation flows), it is important that the
delay from when a video stream is selected for display until the
video can be displayed is short.
All participants are authenticated by the central server and
authorized to connect to the central server. The participants are
identified to each other by the central server, and the participants
do not have access to each others' credentials such as email
addresses or login IDs.
Note: This use case adds requirements on support for fast stream
switches (F16). There exist several solutions that enable the server
to forward one high-resolution and several low-resolution video
streams: a) each browser could send a high-resolution, but scalable
stream, and the server could send just the base layer for the low-
resolution streams, b) each browser could in a simulcast fashion send
one high-resolution and one low-resolution stream, and the server
just selects, or c) each browser sends just a high-resolution stream,
the server transcodes into low-resolution streams as required.
2.4.3.2. Additional Requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F16 The browser must support insertion of reference frames
in outgoing media streams when requested by a peer.
----------------------------------------------------------------
F25 The browser must be able to render several
concurrent audio and video streams.
----------------------------------------------------------------
3. Requirements Summary
3.1. General
This section contains the requirements on the browser derived from
the use cases in Section 2.
Note: It is assumed that the user applications are executed on a
browser. Whether the capabilities to implement specific browser
requirements are implemented by the browser application, or are
provided to the browser application by the underlying operating
system, is outside the scope of this document.
3.2. Browser Requirements
----------------------------------------------------------------
Common, basic requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F1 The browser must be able to use microphones and
cameras as input devices to generate streams.
----------------------------------------------------------------
F2 The browser must be able to send streams and
data to a peer in the presence of NATs.
----------------------------------------------------------------
F3 Transmitted streams and data must be rate
controlled (meaning that the browser must, regardless
of application behavior, reduce send rate when
there is congestion).
----------------------------------------------------------------
F4 The browser must be able to receive, process, and
render streams and data ("render" does not
apply for data) from peers.
----------------------------------------------------------------
F5 The browser should be able to render good quality
audio and video even in the presence of
reasonable levels of jitter and packet losses.
----------------------------------------------------------------
F6 The browser must detect when a stream from a
peer is not received anymore.
----------------------------------------------------------------
F7 When there are both incoming and outgoing audio
streams, echo cancellation must be made
available to avoid disturbing echo during
conversation.
----------------------------------------------------------------
F8 The browser must support synchronization of
audio and video.
----------------------------------------------------------------
F9 The browser should use encoding of streams
suitable for the current rendering (e.g.,
video display size) and should change parameters
if the rendering changes during the session
----------------------------------------------------------------
F10 The browser must support a baseline audio and
video codec.
----------------------------------------------------------------
F11 It must be possible to protect streams and data
from wiretapping [RFC2804] [RFC7258].
----------------------------------------------------------------
F12 The browser must enable verification, given
the right circumstances and by use of other
trusted communication, that streams and
data received have not been manipulated by
any party.
----------------------------------------------------------------
F13 The browser must encrypt, authenticate, and
integrity protect media and data on a
per-IP-packet basis, and it must drop incoming media
and data packets that fail the per-IP-packet
integrity check. In addition, the browser
must support a mechanism for cryptographically
binding media and data security keys to the
user identity (see R-ID-BINDING in [RFC5479]).
----------------------------------------------------------------
F14 The browser must make it possible to set up a
call between two parties without one party
learning the other party's host IP address.
----------------------------------------------------------------
F15 The browser must be able to collect statistics,
related to the transport of audio and video
between peers, needed to estimate quality of
experience.
----------------------------------------------------------------
Requirements related to network and topology
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F16 The browser must support insertion of reference frames
in outgoing media streams when requested by a peer.
----------------------------------------------------------------
F17 The communication session must survive across a
change of the network interface used by the
session.
----------------------------------------------------------------
F18 The browser must be able to send streams and
data to a peer in the presence of NATs and
firewalls that block UDP traffic.
----------------------------------------------------------------
F19 The browser must be able to use several STUN
and TURN servers.
----------------------------------------------------------------
F20 The browser must support the use of STUN and TURN
servers that are supplied by entities other than
the web application (i.e., the network provider).
----------------------------------------------------------------
F21 The browser must be able to send streams and
data to a peer in the presence of firewalls that only
allow traffic via an HTTP Proxy, when firewall policy
allows WebRTC traffic.
----------------------------------------------------------------
F22 The browser should be able to take advantage
of available capabilities (supplied by network
nodes) to differentiate voice, video, and data
appropriately.
----------------------------------------------------------------
Requirements related to multiple peers and streams
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F23 The browser must be able to transmit streams and
data to several peers concurrently.
----------------------------------------------------------------
F24 The browser must be able to receive streams and
data from multiple peers concurrently.
----------------------------------------------------------------
F25 The browser must be able to render several
concurrent audio and video streams.
----------------------------------------------------------------
F26 The browser must be able to mix several
audio streams.
----------------------------------------------------------------
Requirements related to audio processing
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F27 The browser must be able to apply spatialization
effects when playing audio streams.
----------------------------------------------------------------
F28 The browser must be able to measure the
voice activity level in audio streams.
----------------------------------------------------------------
F29 The browser must be able to change the
voice activity level in audio streams.
----------------------------------------------------------------
F30 The browser must be able to process and mix
sound objects (media that is retrieved from
another source than the established media
stream(s) with the peer(s) with audio streams).
----------------------------------------------------------------
Requirements related to legacy interop
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F31 The browser must support an audio media format
(codec) that is commonly supported by existing
telephony services.
----------------------------------------------------------------
F32 There should be a way to navigate
a dual-tone multi-frequency signaling (DTMF)
based Interactive Voice Response (IVR) system.
----------------------------------------------------------------
F33 The browser must be able to initiate and
accept a media session where the data needed
for establishment can be carried in SIP.
----------------------------------------------------------------
Other requirements
----------------------------------------------------------------
REQ-ID DESCRIPTION
----------------------------------------------------------------
F34 The browser must be able to send short
latency unreliable datagram traffic to a
peer browser [RFC5405].
----------------------------------------------------------------
F35 The browser must be able to send reliable
data traffic to a peer browser.
----------------------------------------------------------------
F36 The browser must be able to generate streams
using the entire user display, a specific area
of the user display or the information being
displayed by a specific application.
----------------------------------------------------------------
4. Security Considerations
4.1. Introduction
A malicious web application might use the browser to perform Denial-
of-Service (DoS) attacks on NAT infrastructure, or on peer devices.
For example, a malicious web application might leak TURN credentials
to unauthorized parties, allowing them to consume the TURN server's
bandwidth. To address this risk, web applications should be prepared
to revoke TURN credentials and issue new ones. Also, a malicious web
application might silently establish outgoing, and accept incoming,
streams on an already established connection.
Based on the identified security risks, this section will describe
security considerations for the browser and web application.
4.2. Browser Considerations
The browser is expected to provide mechanisms for getting user
consent to use device resources such as camera and microphone.
The browser is expected to provide mechanisms for informing the user
that device resources such as camera and microphone are in use
("hot").
The browser must provide mechanisms for users to revise and even
completely revoke consent to use device resources such as camera and
microphone.
The browser is expected to provide mechanisms for getting user
consent to use the screen (or a certain part of it) or what a certain
application displays on the screen as source for streams.
The browser is expected to provide mechanisms for informing the user
that the screen, part thereof, or an application is serving as a
stream source ("hot").
The browser must provide mechanisms for users to revise and even
completely revoke consent to use the screen, part thereof, or an
application as a stream source.
The browser is expected to provide mechanisms in order to assure that
streams are the ones the recipient intended to receive.
The browser is expected to provide mechanisms that allow the users to
verify that the streams received have not be manipulated (F12).
The browser needs to ensure that media is not sent, and that received
media is not rendered, until the associated stream establishment and
handshake procedures with the remote peer have been successfully
finished.
The browser needs to ensure that the stream negotiation procedures
are not seen as DoS by other entities.
4.3. Web Application Considerations
The web application is expected to ensure user consent in sending and
receiving media streams.
5. Normative References
[RFC2804] IAB and , "IETF Policy on Wiretapping", RFC 2804, May
2000, <http://www.rfc-editor.org/info/rfc2804>.
[RFC5245] Rosenberg, J., "Interactive Connectivity Establishment
(ICE): A Protocol for Network Address Translator (NAT)
Traversal for Offer/Answer Protocols", RFC 5245, April
2010, <http://www.rfc-editor.org/info/rfc5245>.
[RFC5405] Eggert, L. and G. Fairhurst, "Unicast UDP Usage Guidelines
for Application Designers", BCP 145, RFC 5405, November
2008, <http://www.rfc-editor.org/info/rfc5405>.
[RFC5479] Wing, D., Ed., Fries, S., Tschofenig, H., and F. Audet,
"Requirements and Analysis of Media Security Management
Protocols", RFC 5479, April 2009,
<http://www.rfc-editor.org/info/rfc5479>.
[RFC7258] Farrell, S. and H. Tschofenig, "Pervasive Monitoring Is an
Attack", BCP 188, RFC 7258, May 2014,
<http://www.rfc-editor.org/info/rfc7258>.
Appendix A. API Requirements
This section contains the requirements on the API derived from the
use cases in Section 2.
Note: As the W3C is responsible for the API, the API requirements in
this specification are not normative.
REQ-ID DESCRIPTION
----------------------------------------------------------------
A1 The web API must provide means for the
application to ask the browser for permission
to use cameras and microphones as input devices
and to have access to the local file system.
----------------------------------------------------------------
A2 The web API must provide means for the web
application to control how streams generated
by input devices are used.
----------------------------------------------------------------
A3 The web API must provide means for the web
application to control the local rendering of
streams (locally generated streams and streams
received from a peer).
----------------------------------------------------------------
A4 The web API must provide means for the web
application to initiate the sending of a
stream / stream components to a peer.
----------------------------------------------------------------
A5 The web API must provide means for the web
application to control the media format (codec)
to be used for the streams sent to a peer.
Note: The level of control depends on whether
the codec negotiation is handled by the browser
or the web application.
----------------------------------------------------------------
A6 The web API must provide means for the web
application to modify the media format for
streams sent to a peer after a media stream
has been established.
----------------------------------------------------------------
A7 The web API must provide means for
informing the web application of whether or not
the establishment of a stream with a peer was
successful.
----------------------------------------------------------------
A8 The web API must provide means for the web
application to mute/unmute a stream or stream
component(s). When a stream is sent to a peer,
mute status must be preserved in the stream
received by the peer.
----------------------------------------------------------------
A9 The web API must provide means for the web
application to cease the sending of a stream
to a peer.
----------------------------------------------------------------
A10 The web API must provide means for the web
application to cease the processing and rendering
of a stream received from a peer.
----------------------------------------------------------------
A11 The web API must provide means for
informing the web application when a
stream from a peer is no longer received.
----------------------------------------------------------------
A12 The web API must provide means for
informing the web application when high
loss rates occur.
----------------------------------------------------------------
A13 The web API must provide means for the web
application to apply spatialization effects to
audio streams.
----------------------------------------------------------------
A14 The web API must provide means for the web
application to detect the level in audio
streams.
----------------------------------------------------------------
A15 The web API must provide means for the web
application to adjust the level in audio
streams.
----------------------------------------------------------------
A16 The web API must provide means for the web
application to mix audio streams.
----------------------------------------------------------------
A17 The web API must provide a way to identify
streams such that an application is able to
match streams on a sending peer with the same
stream on all receiving peers.
----------------------------------------------------------------
A18 The web API must provide a mechanism for sending
and receiving isolated discrete chunks of data.
----------------------------------------------------------------
A19 The web API must provide means for the web
application to indicate the type of audio signal
(speech, audio) for audio stream(s) / stream
component(s).
----------------------------------------------------------------
A20 It must be possible for an initiator or a
responder web application to indicate the types
of media it is willing to accept incoming
streams for when setting up a connection (audio,
video, other). The types of media to be accepted
can be a subset of the types of media the browser
is able to accept.
----------------------------------------------------------------
A21 The web API must provide means for the
application to ask the browser for permission
to use the screen, a certain area on the screen,
or what a certain application displays on the
screen as input to streams.
----------------------------------------------------------------
A22 The web API must provide means for the
application to specify several STUN and/or
TURN servers to use.
----------------------------------------------------------------
A23 The web API must provide means for the
application to specify the priority to
apply for outgoing streams and data.
----------------------------------------------------------------
A24 The web API must provide a mechanism for sending
and receiving files.
----------------------------------------------------------------
A25 It must be possible for the application to
instruct the browser to refrain from exposing
the host IP address to the application.
----------------------------------------------------------------
A26 The web API must provide means for the
application to obtain the statistics (related
to transport, and collected by the browser)
needed to estimate the quality of service.
----------------------------------------------------------------
Acknowledgements
The authors wish to thank Bernard Aboba, Gunnar Hellstrom, Martin
Thomson, Lars Eggert, Matthew Kaufman, Emil Ivov, Eric Rescorla, Eric
Burger, John Leslie, Dan Wing, Richard Barnes, Barry Dingle, Dale
Worley, Ted Hardie, Mary Barnes, Dan Burnett, Stephan Wenger, Harald
Alvestrand, Cullen Jennings, Andrew Hutton and everyone else in the
RTCWEB community that have provided comments, feedback, text and
improvement proposals on the document. A big thank you to everyone
that provided comments as part of the IESG evaluation and to everyone
else that provided comments and input in order to improve the
document.
Authors' Addresses
Christer Holmberg
Ericsson
Hirsalantie 11
Jorvas 02420
Finland
EMail: christer.holmberg@ericsson.com
Stefan Hakansson
Ericsson
Laboratoriegrand 11
Lulea 97128
Sweden
EMail: stefan.lk.hakansson@ericsson.com
Goran AP Eriksson
Ericsson
Farogatan 6
Stockholm 16480
Sweden
EMail: goran.ap.eriksson@ericsson.com
ISO Plain Language
On this page
§1What the Document Sets Out to Do
RFC 7478 is an informational document that lists scenarios where a web application running in a browser exchanges live sound, video and data in real time, and turns each scenario into a numbered requirement on the browser. The scenarios range from a one-to-one video call between two browsers to a group call with no central server, an online game with voice chat, and a call that reaches an ordinary telephone network.
The browser requirements are numbered F1 to F36 and are listed next to the use case that produced them. A second set, numbered A1 to A26, covers the programming interface the web application uses; these sit in Appendix A and are not normative, because the W3C WebRTC working group is responsible for the API and decided to use this document's use cases and requirements instead of writing its own.
The authors are explicit about the document's standing. It was written in an initial phase of the work, with rather minor updates at later stages. It is published to record the early conclusions of the working group, and it will not be used as a set of rigid guidelines that specifications and implementations are held to in the future.
This document lists what people want to do with live sound and video in a browser, then turns each activity into a numbered demand on the browser. The authors say it records early conclusions, not rules that later work must follow.
§2Use Cases and the Networks They Run On
The base scenario, the simple video communication service, has two users load the same web application, log in, and select each other as online. The service pushes login status to the application in each browser, and a one-to-one audiovisual session starts between the two browsers. The invited user may accept or reject. While the session is being set up the user sees a self view; afterwards the remote video is shown alongside it.
The document lists network conditions that apply to every use case: a client may be on an IPv4-only network, an IPv6-only network, or a dual-stack one; it may be on a link with a different throughput from its peer, on a variable-quality wireless link, or on a congested link; it may sit behind a firewall that allows no UDP; and it may sit behind a NAT or an IPv4-IPv6 translation device with any of the mapping and filtering behaviours described in RFC 4787.
Most of the other browser-to-browser use cases start from the simple video communication service and add one demand. A firewall that blocks UDP adds F18. A firewall that only permits traffic through an HTTP proxy adds F21. A service provider spread over a large area wants several STUN and TURN servers for IPv4 and IPv6 support, load balancing and redundancy, which adds F19; an enterprise that wants to audit sessions from inside its network supplies its own STUN and TURN servers, which adds F20. A user who moves from Ethernet to Wi-Fi to cellular mid-call adds F17, which requires the session to survive a change of network interface. Screen sharing adds F36 and file exchange adds F35.
Two use cases scale the model up. Multiparty video communication has no central server: each participant's browser sends and receives streams to and from all the others, renders several streams at once, mixes the audio locally, places each speaker in a different position in the room, and measures and adjusts the voice activity level. Multiparty online game with voice communication keeps the voice part and adds sound objects from another source, such as a file with the sound of a moving tank, mixed into the spatialised audio; quick game state updates are needed and have a higher priority than the voice, which adds F34 for short-latency unreliable datagram traffic.
The document describes a basic video call and then adds one new demand for each problem that can appear: a firewall that blocks UDP, a proxy-only firewall, a large service provider, a corporate network that wants to audit calls, a user who changes network mid-call, screen sharing and file transfer. It also covers group calls with no central server and voice chat inside an online game.
- Login statusThe service publishes who is online by pushing updates to the application in the browsers.
- Login status
- Select peerAlice selects an online peer to call.
- Session invitationBob may accept or reject.
- Accept
- Audio and videoA 1:1 audiovisual session between the two browsers.
§2.4Calls That Reach a Gateway or a Central Server
Not every client in these scenarios is a browser. A mobile telephony operator can let its customers make and receive calls from a browser that behaves like a normal phone, showing the caller's identity and the call history. The browser must support an audio codec that existing telephony services already understand (F31) and must be able to start and accept a media session whose setup data can be carried in SIP (F33).
In the FedEx call scenario a user dials a public telephone number from the browser, hears the prompts of an interactive voice response system and needs a way to navigate it when it says to press 1. The browser must support a dual-tone multi-frequency (DTMF) based interactive voice response system, which is requirement F32.
The third scenario puts a central conference server in the middle. Each participant's browser sends an audio stream to the server; the server mixes the streams, adding effects such as spatialisation if it likes, and returns one mixed stream to each participant. Video goes the same way, but the server shows one participant at full resolution in a large window and the others as small thumbnails, choosing which streams to forward based on speech activity. Because the choice changes often as the conversation moves, the delay from selecting a stream to displaying it has to be short. The document lists three ways to achieve this: a browser sends one high-resolution scalable stream and the server sends only its base layer for thumbnails; the browser sends one high and one low resolution stream in a simulcast fashion and the server selects; or the browser sends one high-resolution stream and the server transcodes it. The requirement added here is F16, which asks the browser to insert reference frames into an outgoing stream when the peer requests them.
Some calls do not go straight from browser to browser. The document covers calls into the ordinary telephone network, calls where the user must press keys to navigate an automated phone menu, and group calls that run through a central server. In the last case the server mixes everyone's voices and picks whose face to show large, so the browser has to react quickly when that choice changes.
§3The Requirement List
Section 3 collects the browser requirements and groups them. The common and basic group runs from F1, which asks the browser to use microphones and cameras as input devices, to F15, which asks it to collect statistics about the transport of audio and video between peers so that quality of experience can be estimated. Between them sit the demands to send streams and data in the presence of NATs (F2), to rate control transmitted streams and data so the send rate drops when there is congestion (F3), to receive, process and render what peers send (F4), to keep good quality under reasonable jitter and packet loss (F5), to detect when a peer's stream stops arriving (F6), to make echo cancellation available when sound is both sent and received (F7), to synchronise audio and video (F8), to encode for the current rendering size and change when that size changes (F9), to support a baseline audio and video codec (F10), to keep streams and data safe from wiretapping (F11, F12) and to hide the host IP address from the other party (F14).
The next group covers the network and topology: reference frame insertion (F16), surviving a change of network interface (F17), working through NATs and firewalls that block UDP (F18), using several STUN and TURN servers (F19), using STUN and TURN servers supplied by the network rather than the application (F20), working through a proxy-only firewall (F21) and taking advantage of network quality-of-service capabilities to differentiate voice, video and data (F22). A third group covers multiple peers and streams (F23 to F26), a fourth covers audio processing such as spatialisation and voice activity levels (F27 to F30), a fifth covers legacy interoperation with telephony (F31 to F33) and the last covers unreliable datagram traffic, reliable data traffic and screen sharing (F34 to F36).
Appendix A lists the API requirements. The API must let the application ask the browser for permission to use cameras, microphones and the local file system (A1), control how streams are used and rendered (A2, A3), start and stop sending and receiving (A4, A9, A10), choose and later change the codec (A5, A6), be told whether a stream was set up successfully and whether a peer's stream has stopped or is being lost badly (A7, A11, A12), mute and unmute while keeping the mute status visible to the peer (A8), apply spatialisation, detect and adjust levels and mix audio (A13 to A16), identify streams so the same stream can be matched across peers (A17), send and receive isolated data chunks (A18), declare the type of audio signal (A19), state which media types it will accept (A20), ask for permission to share the screen (A21), name several STUN and TURN servers (A22), set a priority for outgoing streams and data (A23), send and receive files (A24), ask the browser to withhold the host IP address (A25) and read the statistics needed to estimate service quality (A26).
The requirements are numbered so they can be referred to precisely. F1 to F15 cover the basics of a call, F16 to F22 cover the network, F23 to F30 cover group calls and audio processing, F31 to F36 cover older telephone systems and other extras. Appendix A does the same for the programming interface the web application calls.
- F1 to F15Common and basic: devices, NATs, rate control, rendering, echo cancellation, codecs, protection and statistics.
- F16 to F22Network and topology: reference frames, interface changes, UDP blocking, several STUN and TURN servers, proxy-only firewalls and quality of service.
- F23 to F26Multiple peers and streams: send to and receive from several peers, render several streams and mix several audio streams.
- F27 to F30Audio processing: spatialisation, measuring and changing the voice activity level, mixing other sound objects.
- F31 to F33Legacy interoperation: telephony codecs, navigating DTMF voice response systems, session setup carried in SIP.
- F34 to F36Other: short-latency unreliable datagram traffic, reliable data traffic and screen sharing.
§4Security Considerations
Section 4 splits the risks between the browser and the web application. A malicious web application might use the browser to mount a denial-of-service attack on NAT infrastructure or on peer devices. It might leak TURN credentials to unauthorised parties, letting them consume the TURN server's bandwidth; the answer is that web applications should be ready to revoke credentials and issue new ones. A malicious application might also silently establish outgoing streams and accept incoming streams on an already established connection.
On the browser side, the document expects mechanisms for obtaining user consent to use device resources such as the camera and microphone, for telling the user that those resources are in use, and for letting a user revise or completely revoke that consent. The same set of mechanisms is expected for the screen, a part of it, or the contents of a particular application window. The browser is also expected to let users verify that received streams have not been manipulated (F12), and it must ensure that media is neither sent nor rendered until the stream establishment and handshake procedures with the remote peer have finished successfully. Finally the browser must ensure that the stream negotiation procedures cannot be mistaken for a denial-of-service attack by other entities.
The web application is expected to make sure the user consents to sending and receiving media streams. Requirement F13 is the strongest statement in the document: the browser must encrypt, authenticate and integrity protect media and data on a per-IP-packet basis, and it must drop incoming media and data packets that fail the per-IP-packet integrity check. It must also support a mechanism for cryptographically binding media and data security keys to the user identity, referring to R-ID-BINDING in RFC 5479.
The security section says two things. The browser must ask permission before it uses the camera, the microphone or the screen, and it must not send or play any media until the handshake with the other side has finished. Every media packet must be encrypted and checked, and a packet that fails the check is thrown away rather than passed to the application.