Skip to content

Commit 49efac9

Browse files
authored
Update proxy-calling-support-tutorial.md
1 parent 5c84e0c commit 49efac9

File tree

1 file changed

+4
-3
lines changed

1 file changed

+4
-3
lines changed

articles/communication-services/tutorials/proxy-calling-support-tutorial.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,15 +12,16 @@ ms.service: azure-communication-services
1212
ms.subservice: calling
1313
ms.custom: mode-other
1414
---
15+
# How to focce calling traffic to be relayed and proxyed across your own servers
1516

1617
In certain situations it might be useful to have all your client traffic be proxyed to a TURN server that you can control. This tutorial will walk you through the process to ena. When the SDK is initializing you can provide the details of your TURN servers that you would like the traffic to route to. When this is enabled all the media traffic (audio/video/screen sharing) will flow through the provided TURN servers instead of the Azure Communication Services defaults. Once your provide your TURN server details while initializing the `CallClient`, all the calls to and from this `CallClient` will be using the provided TURN servers. Below is a guide on how to do provide your TURN configurations to the WebJS SDK.
1718

1819
>[!IMPORTANT]
1920
> The custom proxy feature is available starting on the public preview version [1.13.0-beta.1](https://www.npmjs.com/package/@azure/communication-calling/v/1.13.0-beta.4) of the Calling SDK. Please ensure that you use this or a newer SDK when trying to use this feature. This quickstart uses the Azure Communication Services Calling SDK version greater than `1.13.0`.
2021
21-
[!INCLUDE [Public Preview](../../includes/public-preview-include-document.md)]
22+
[!INCLUDE [Public Preview](../../../includes/public-preview-include-document.md)]
2223

23-
### What is a STUN/TURN server?
24+
## What is a STUN/TURN server?
2425
Many times establishing connection between two peers is not straightforward and a direct connection will not work because of many reasons - firewalls with strict rules, peers sitting behind a private network, etc. In many situations your device does not have a public IP address to establish a connection straightaway and so relaying data via a relay server, that is usually known to both peers, is a way to allow this connection to happen. The WebRTC ICE (Interactive Connectivity Establishment) framework helps make this happen. STUN and TURN servers are the relay servers here. See [Network Traversal Concepts](../../../../concepts/network-traversal.md) for more details on how ACS mitigates network challenges with STUN and TURN.
2526

2627
## Providing your TURN servers to the SDK
@@ -73,7 +74,7 @@ const callClient = new CallClient({
7374
7475
The API reference for the `CallClientOptions` object, and the `networkConfiguration` property within it can be found here - [CallClientOptions](https://learn.microsoft.com/en-gb/javascript/api/azure-communication-services/@azure/communication-calling/callclientoptions?view=azure-communication-services-js).
7576

76-
### Setting up a TURN server in Azure
77+
## Setting up a TURN server in Azure
7778
You can create a Linux virtual machine in the Azure portal using this guide - [Quickstart: Create a Linux virtual machine in the Azure portal](https://learn.microsoft.com/en-us/azure/virtual-machines/linux/quick-create-portal?tabs=ubuntu), and deploy a TURN server using [coturn](https://github.com/coturn/coturn), a free and open source implementation of a TURN and STUN server for VoIP and WebRTC.
7879
Best spot to start from - [coturn turnserver README](https://github.com/coturn/coturn/blob/master/README.turnserver)
7980

0 commit comments

Comments
 (0)