WebRtcIPHandlingUrl

Article
2025-05-09

WebRTC IP Handling Policy for URL Patterns

Supported versions

On Windows and macOS since 135 or later

Description

Controls which IP addresses and network interfaces WebRTC can use when establishing connections for specific URL patterns.

How It Works: Accepts a list of URL patterns, each paired with a handling type. WebRTC evaluates patterns sequentially; the first match determines the handling type. If no match is found, WebRTC defaults to the WebRtcLocalhostIpHandling WebRtcLocalhostIpHandling. policy. This policy applies only to origins—URL path components are ignored. Wildcards (*) are supported in URL patterns.

Supported Handling Values: default – Uses all available network interfaces. default_public_and_private_interfaces – WebRTC uses all public and private interfaces. default_public_interface_only – WebRTC uses only public interfaces. disable_non_proxied_udp – WebRTC uses UDP SOCKS proxying or falls back to TCP proxying.

More Information: Valid input patterns: https://go.microsoft.com/fwlink/?linkid=2095322 Handling types: https://tools.ietf.org/html/rfc8828.html#section-5.2

Supported features

Can be mandatory: Yes
Can be recommended: No
Dynamic Policy Refresh: Yes
Per Profile: Yes
Applies to a profile that is signed in with a Microsoft account: No

Data type

Dictionary

Windows information and settings

Group Policy (ADMX) info

GP unique name: WebRtcIPHandlingUrl
GP name: WebRTC IP Handling Policy for URL Patterns
GP path (Mandatory): Administrative Templates/Microsoft Edge/WebRtc settings
GP path (Recommended): N/A
GP ADMX file name: MSEdge.admx

Example value

[{"handling": "default_public_and_private_interfaces", "url": "https://www.example.com"}, {"handling": "default_public_interface_only", "url": "https://[*.]example.edu"}, {"handling": "disable_non_proxied_udp", "url": "*"}]

Registry settings

Path (Mandatory): SOFTWARE\Policies\Microsoft\Edge
Path (Recommended): N/A
Value name: WebRtcIPHandlingUrl
Value type: REG_SZ

Example registry value

[{"handling": "default_public_and_private_interfaces", "url": "https://www.example.com"}, {"handling": "default_public_interface_only", "url": "https://[*.]example.edu"}, {"handling": "disable_non_proxied_udp", "url": "*"}]

Expanded example registry value

[
  {
    "handling": "default_public_and_private_interfaces",
    "url": "https://www.example.com"
  },
  {
    "handling": "default_public_interface_only",
    "url": "https://[*.]example.edu"
  },
  {
    "handling": "disable_non_proxied_udp",
    "url": "*"
  }
]

Mac information and settings

Preference Key name: WebRtcIPHandlingUrl
Example value:

<key>WebRtcIPHandlingUrl</key>
<array>
  <dict>
    <key>handling</key>
    <string>default_public_and_private_interfaces</string>
    <key>url</key>
    <string>https://www.example.com</string>
  </dict>
  <dict>
    <key>handling</key>
    <string>default_public_interface_only</string>
    <key>url</key>
    <string>https://[*.]example.edu</string>
  </dict>
  <dict>
    <key>handling</key>
    <string>disable_non_proxied_udp</string>
    <key>url</key>
    <string>*</string>
  </dict>
</array>

Share via