From b3161053d4e2ec81b42cfcf679d1abf71281386b Mon Sep 17 00:00:00 2001 From: Nils Ohlmeier Date: Wed, 16 Apr 2025 15:18:54 -0600 Subject: [PATCH 1/4] Realtime: added warning about port 53 URLs --- src/content/docs/realtime/turn/generate-credentials.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/content/docs/realtime/turn/generate-credentials.mdx b/src/content/docs/realtime/turn/generate-credentials.mdx index c92140ffabda21..d7e38922aded45 100644 --- a/src/content/docs/realtime/turn/generate-credentials.mdx +++ b/src/content/docs/realtime/turn/generate-credentials.mdx @@ -53,6 +53,8 @@ The JSON response below can then be passed on to your front-end application: } ``` +Note: the list of URLs returned contains URLs with the primary and alternate ports. The alternate port 53 is known to be blocked by web browsers. So this TURN URL will time out if used in browsers. If you are using trickle ICE this not going to cause problems. But if you wait for ICE gathering to finish before passing on the ICE candidates you might want to filter out the alternate URL with port 53 to avoid waiting for it to time out. + Use `iceServers` as follows when instantiating the `RTCPeerConnection`: ```js From 90081bd5d7b4ebe684585e069cb01d2897774a05 Mon Sep 17 00:00:00 2001 From: Nils Ohlmeier Date: Wed, 16 Apr 2025 16:57:02 -0600 Subject: [PATCH 2/4] added missing 'is' --- src/content/docs/realtime/turn/generate-credentials.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/realtime/turn/generate-credentials.mdx b/src/content/docs/realtime/turn/generate-credentials.mdx index d7e38922aded45..6df530cc7dbb71 100644 --- a/src/content/docs/realtime/turn/generate-credentials.mdx +++ b/src/content/docs/realtime/turn/generate-credentials.mdx @@ -53,7 +53,7 @@ The JSON response below can then be passed on to your front-end application: } ``` -Note: the list of URLs returned contains URLs with the primary and alternate ports. The alternate port 53 is known to be blocked by web browsers. So this TURN URL will time out if used in browsers. If you are using trickle ICE this not going to cause problems. But if you wait for ICE gathering to finish before passing on the ICE candidates you might want to filter out the alternate URL with port 53 to avoid waiting for it to time out. +Note: the list of URLs returned contains URLs with the primary and alternate ports. The alternate port 53 is known to be blocked by web browsers. So this TURN URL will time out if used in browsers. If you are using trickle ICE this is not going to cause problems. But if you wait for ICE gathering to finish before passing on the ICE candidates you might want to filter out the alternate URL with port 53 to avoid waiting for it to time out. Use `iceServers` as follows when instantiating the `RTCPeerConnection`: From e3e35da0571cd402c32d0901cb398e39fca168a3 Mon Sep 17 00:00:00 2001 From: Nils Ohlmeier Date: Mon, 21 Apr 2025 10:01:45 -0600 Subject: [PATCH 3/4] Update src/content/docs/realtime/turn/generate-credentials.mdx MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Denise Peña <75506267+dcpena@users.noreply.github.com> --- src/content/docs/realtime/turn/generate-credentials.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/src/content/docs/realtime/turn/generate-credentials.mdx b/src/content/docs/realtime/turn/generate-credentials.mdx index 6df530cc7dbb71..d0c5a462829a23 100644 --- a/src/content/docs/realtime/turn/generate-credentials.mdx +++ b/src/content/docs/realtime/turn/generate-credentials.mdx @@ -53,7 +53,9 @@ The JSON response below can then be passed on to your front-end application: } ``` -Note: the list of URLs returned contains URLs with the primary and alternate ports. The alternate port 53 is known to be blocked by web browsers. So this TURN URL will time out if used in browsers. If you are using trickle ICE this is not going to cause problems. But if you wait for ICE gathering to finish before passing on the ICE candidates you might want to filter out the alternate URL with port 53 to avoid waiting for it to time out. +:::note +The list of returned URLs contains URLs with the primary and alternate ports. The alternate port 53 is known to be blocked by web browsers, and the TURN URL will time out if used in browsers. If you are using trickle ICE, this will not cause issues, but you should let ICE gathering finish before passing. +::: Use `iceServers` as follows when instantiating the `RTCPeerConnection`: From fee0dfa5c089c86ca986ab0213e361a05029ab4b Mon Sep 17 00:00:00 2001 From: Nils Ohlmeier Date: Mon, 21 Apr 2025 11:09:39 -0600 Subject: [PATCH 4/4] added sentence about no-trickle back in --- src/content/docs/realtime/turn/generate-credentials.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/realtime/turn/generate-credentials.mdx b/src/content/docs/realtime/turn/generate-credentials.mdx index d0c5a462829a23..f27c5e82dd2dd3 100644 --- a/src/content/docs/realtime/turn/generate-credentials.mdx +++ b/src/content/docs/realtime/turn/generate-credentials.mdx @@ -54,7 +54,7 @@ The JSON response below can then be passed on to your front-end application: ``` :::note -The list of returned URLs contains URLs with the primary and alternate ports. The alternate port 53 is known to be blocked by web browsers, and the TURN URL will time out if used in browsers. If you are using trickle ICE, this will not cause issues, but you should let ICE gathering finish before passing. +The list of returned URLs contains URLs with the primary and alternate ports. The alternate port 53 is known to be blocked by web browsers, and the TURN URL will time out if used in browsers. If you are using trickle ICE, this will not cause issues. Without trickle ICE you might want to filter out the URL with port 53 to avoid waiting for a timeout. ::: Use `iceServers` as follows when instantiating the `RTCPeerConnection`: