PDF(355.8 KB) View with Adobe Reader on a variety of devices
ePub(391.0 KB) View in various apps on iPhone, iPad, Android, Sony Reader, or Windows Phone
Mobi (Kindle)(384.4 KB) View on Kindle device or Kindle app on multiple devices
Updated:March 10, 2021
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This document describes the steps to configure and troubleshoot Cisco Meeting Server (CMS) WebRTC over Expressway.
Cisco recommends that you have knowledge of these topics:
Expressway X12.6.1 and later (x12.6.1 and later will only work with CMS 2.9.2 or later due to changes in Exp TURN behavior)
CMS server 2.9.3 and later
Network Address Translation (NAT)
Traversal Using Relays around NAT (TURN)
Session Traversal Utilities for NAT (STUN)
Domain Name System (DNS)
Basic Mobile and Remote Access (MRA) related settings (UC Traversal zone, SSH tunnels) must be already enabled and configured on the Expressway, click here for MRA guides
For CMS 2.9.x - WebBridge (WB), XMPP and CallBridge configured and enabled on CMS, see the configuration guide
TURN option key installed on the Expressway-E
TCP Port 443 opened on Firewall from the public internet to the Expressway-E's public IP address
TCP and UDP Port 3478 (TURN requests) opened on Firewall from Public Internet to the Expressway-E's public IP address
TCP 3478 only needed if 'turnservers' in CMS API has tcpPortNumberOverride set to 3478
UDP Port 3478 (TURN requests) opened on Firewall from CMS to the Expressway-E's private IP address (if you use Dual-NIC on the Expressway-E)
CMS 2.9.2 and earlier sends Binding Requests to the Exp E, while 2.9.3 onward sends Allocate Requests
External DNS records for the Join URL for webbridge, resolvable to the Expressway-E's public-facing IP address
Internal DNS record for Join URL resolvable to the webbridge server's IP address
If running X12.5.2 or earlier ensure NAT reflection allowed on external firewall for Expressway-E's Public IP address, click here for example configuration. As of X12.5.3 this is no longer needed for a standalone Expressway.
When using TURN443, you will still need to open UDP port 3478 for media on the external firewall
Note: Expressway pair which is used for Jabber Guest services cannot be used for CMS WebRTC proxy services.
This document is not restricted to specific software and hardware versions, however the minimum software version requirements must be met.
CMS Application Program Interface (API)
The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, ensure that you understand the potential impact of any command.
WebRTC proxy support has been added to Expressway from Version X8.9.2, which enables off-premises users to browse to a Cisco Meeting Server Web Bridge.
External clients and Guests can manage or join spaces without the need of any software other than a supported browser. Click here for a list of supported browsers.
As of February 5, 2021, these are the supported browsers for CMS 3.1.1:
This image provides an example of connections flow of Web Proxy for CMS WebRTC: (from Exp IP port Usage configuration guide)
Note: When running X12.5.2 or earlier you must configure your external firewall to allow NAT reflection for the Expressway-E& public IP address (firewalls typically mistrust packets which have the same source and destination IP address). As of X12.5.3 this is no longer needed for a standalone Expressway.
Step 1. Integrate CMS WB onto Expressway-C
a. Navigate to Configuration > Unified Communication > Cisco Meeting Server.
b. Enable Meeting Server Web Proxy.
c. Enter the Join URL in the Guest account client URI field.
Step 2. Enable TURN on the Expressway-E and add the authentication credential to the local authentication database
a. Navigate to Configuration > Traversal > TURN.
b. Enable TURN services, from off to on.
c. Choose Configure TURN client credentials on local database and add the credentials (username and password).
Note: If you have a cluster of Expressway-Es and they are all to be used as TURN servers, then ensure that you enable it on all the nodes. You must configure two separate turnServer instances over API, and point them to each of the Expressway-E servers in the cluster (as per the configurational process shown in Step 4, which shows the process for one Expressway-E server; the second turnServer's configuration would be similar, only using the respective IP addresses and turn credentials for the other Expressway-E server).
Note: You can use a network load balancer in front of your expressways for TCP/HTTPS traffic, but TURN media must still go from client to TURN servers public IP. TURN media must not pass through the network load balancer
Step 3. Change the administration port of the Expressway-E
This step is required since webrtc connections come in on TCP 443, but Exp 12.7 introduced a new Dedicated Management Interface (DMI) that can be used for 443.
a. Navigate to System > Administration.
b. Under Web server configuration, change the Web administrator port to 445 from the drop-down options, then click Save
c. Repeat steps 3a to 3b on all Expressway-Es used for WebRTC proxy services
Note: Cisco recommends the administration port be changed because WebRTC clients use 443. If the WebRTC browser tries to access port 80, the Expressway-E redirects the connection to 443.
Step 4. Add the Expressway-E as TURN server(s) for media NAT traversal onto the CMS server
In CMS 2.9.x onward, use the Configuration --> API menu to add turn servers:
serverAddress: (Private IP address of Expressway)
clientAddress: (Public IP address of Expressway)
username: (as configured in step 2c)
password: (as configured in step 2c)
d. Repeat step 4c for every Expressway-E server to be used for TURN
This image provide examples of the configurational steps:
Use this section in order to confirm that your configuration works properly.
Step 1. On Expressway-C, check that the WB is correctly integrated
a. Navigate to Configuration > Unified Communication > Cisco Meeting Server, and you must see the IP address of the WB:
b. Navigate to Configuration > Unified Communication > HTTP allow list > Automatically added rules, check that this has been added to the rules:
Meeting Server web bridges https 443 Prefix / GET, POST, PUT, HEAD, DELETE
Meeting Server web bridges wss 443 Prefix / GET, POST, PUT, HEAD, DELETE
Note: It is not expected to find the WB in the Discovered nodes because the rules are simply to allow for the proxy of HTTPS traffic to the WB, and not necessarily for unified communication.
c. Check that the Secure Shell (SSH) tunnel for the WB FQDN has been built on the Expressway-C to the Expressway-E and that it is active. Navigate to Status > Unified Communications > Unified Communications SSH tunnels status, you must see the FQDN of the WB and the target must be the Expressway-E:
Step 2. Verify that the TURN server has been added to the CMS server
In the CMS API menu, look up the turn servers, and click on each one. Within each object, there is a link to check the status:
The output displays information which includes the Round-trip time (RTT) in milliseconds (Ms) associated the TURN server. This information is important to the CB selection of the best TURN server to use.
Step 3. Verify TURN relay usage an during ongoing call
At the time that a live call that is made with the use of the WebRTC client, you can view the TURN media Relay status on the Expressway. Navigate to Status > TURN relay usage, then choose view.
Check the TURN credentials configured on the CMS and ensure that it matches that which is configured on the Expressway-E local authentication database.
External WebRTC client does not get Join Call option
On the Callbridge Status > General page, this is displayed:
2017-04-15 12:09:06.647 Web bridge connection to "webbridge.alero.aca" failed (DNS failure)
2017-04-15 12:10:11.634 Warning web bridge link 2: name resolution for "webbridge.alero.aca" failed
2017-04-15 11:55:50.835 Info failed to establish connection to web bridge link 2 (unknown error)
Ensure that the Callbridge can resolve the Join URL to the webbridge FQDN (the Callbridge must not resolve this to the Expressway-E's IP address).
Flush the DNS cache on the Callbridge, via Command line interface (CLI), with the command dns flush.
Ensure that the WB trusts the Callbridge server certificate (not the issuer).
External WebRTC client stuck (on Loading media) when connecting to cospace and then gets redirected to the WB initial page
Ensure that CMS can resolve the _xmpp-client SRV record on the internal network for the CB domain and make sure that WebRTC connections work internally.
Collect a Wireshark capture on the client and Diagnostic logging including tcpdump on the Expressway-E while attempting to connect with the External client:
Navigate to Maintenance > Diagnostics > Diagnostic logging and ensure that Take tcpdump while logging is checked, as shown in this image, before you select Start new log:
Note: Ensure that the Wireshark capture on the client's device and the logging on the Expressway-E are started before reproducing the failing call. When the failing call has been reproduced, stop and download the logging on the Expressway-E and the capture on the client.
Extract/unzip the log bundle dowloaded from the Expressway-E and open the .pcap file taken on the Public-facing interface.
Filter on both packet captures with stun:
Then look for the binding request from the External client to the Expressway-E Public IP address, right-click and select Follow > UDP Stream.
Usually the destination port of the Binding request from the client would be in the range of 24000-29999, which is the TURN relays port range on the Expressway-E.
If no response to the Binding requests is received on the client's side, check on the Expressway-E's capture if the requests are arriving.
If the requests are arriving and the Expressway-E is replying to the client, check if the External FW is allowing the outbound UDP traffic.
If the requests are not arriving, check the FW to ensure that the port range above are not blocked.
If the Expressway-E is deployed with a Dual Network Interface Controller (DUAL-NIC) with static NAT mode enabled and is X12.5.2 or earlier, then ensure that NAT reflection is supported and configured on your External FW. As of X12.5.3 this is no longer needed for a standalone Expressway.
External WebRTC client unable to join cospace and gets the warning (Unable to connect - try again later)
In this scenario, the RTC client is able to resolve the Call ID to jalero.space, but when you enter your name and select Join call, the warning Unable to connect - try again later is displayed immediately:
Check that CMS, on the internal network, is able to always resolve the _xmpp-client SRV record for the CB domain.