This demo does not run on a mobile browser. Chrome on iOS and Android does not support extensions at all, so the extension this demo depends on cannot install there. It needs desktop Chrome Canary on macOS or Windows. The steps below are here to read ahead of time, not to follow on this device.
This demo requires Google Chrome Canary. The extension it depends on does not run in this browser. Open this page in Chrome Canary on macOS or Windows instead.
Set Up the Demo Extension
This demo needs Chrome Canary, the WebRTC Diagnostics Relay extension
force-installed at id hchndajkciejddfgpilblfimhldechnk,
and the feature flag that turns on chrome.enterprise.webrtc.
Pick your OS below.
macOS
- Install Chrome Canary if it is not already on the machine. Chrome is already installed and meets the version this API needs. This check cannot tell Canary apart from another Chromium build at the same version.
- Download the profile that force-installs the extension: demo.mobileconfig. It already has this extension's id and this server's update URL built in.
- Double-click the downloaded file. It opens System Settings. Go to General, then Device Management. Find "Agentforce Demo: Force-install WebRTC Diagnostics Relay" and click Install. Enter your password when asked.
- A plain managed-preferences plist does not work on current macOS. Chrome never receives the value at all, the profile above is what actually reaches it. Some older macOS releases still accept a plain plist drop.
-
Quit Canary completely (Cmd-Q, not just closing the window) and
relaunch it from Terminal with the flag that turns the API on.
The Dock icon does not carry this flag. Launching Canary from the Dock after this step leaves the API off even with the extension installed."/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary" \ --enable-features=ApiEnterpriseWebrtc -
Open
chrome://extensions, find WebRTC Diagnostics Relay, and click Extension options. Set Ingest base URL tohttps://sf.patrickkettner.comand Demo token to the value Patrick gives you, then save. -
Check
chrome://policyforExtensionSettings. "Not set" means the profile was not approved in System Settings. If it is set but the extension never appears force-installed, this Mac is not carrying enough management authority for Chrome to trust an off-store extension policy. A profile installed by hand this way is still local device management, the same low trust tier as a bare plist. A Mac already enrolled in real MDM does not hit this.
Windows
- Install Chrome Canary. Chrome is already installed and meets the version this API needs. This check cannot tell Canary apart from another Chromium build at the same version.
-
Force-install the extension through Chrome's machine policy.
Canary reads policy from the same registry key as every other
channel,
HKLM\SOFTWARE\Policies\Google\Chrome. There is no separate Canary policy key on Windows.reg add "HKLM\SOFTWARE\Policies\Google\Chrome" /v ExtensionSettings /t REG_SZ /d "{\"hchndajkciejddfgpilblfimhldechnk\":{\"installation_mode\":\"force_installed\",\"update_url\":\"https://sf.patrickkettner.com/ext/update.xml\"}}" -
Quit Canary completely and relaunch it with the flag that turns
the API on.
The Start menu and taskbar shortcuts do not carry this flag."%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe" --enable-features=ApiEnterpriseWebrtc -
Open
chrome://extensions, find WebRTC Diagnostics Relay, and click Extension options. Set Ingest base URL tohttps://sf.patrickkettner.comand Demo token to the value Patrick gives you, then save. - A registry policy alone is not enough on an unmanaged machine. Chrome treats an off-store force-installed extension as low-trust and blocks it unless the machine is domain-joined through Active Directory or enrolled in Chrome Browser Cloud Management. This is not a mistake in the steps above, it is Chrome's own policy trust model, and it applies here even though the registry key is set correctly.
Linux
Chrome Canary does not exist on Linux, and this demo targets Canary
specifically. chrome.enterprise.webrtc is gated behind a
flag that is off by default in every channel right now, with no
chrome://flags entry, so the flag has to be passed on
the command line no matter which channel runs it.
When Chrome turns that flag on by default, it lands the same way every Chrome feature does, through Dev, then Beta, then Stable, after Canary. A Linux user without Canary gets the API once it reaches a channel already installed there, not before this demo works on Linux.
Fixing "Installed, But The API Is Not Exposed"
chrome.enterprise.webrtc sits behind the
ApiEnterpriseWebrtc feature flag, off by default with no
chrome://flags entry, so it only turns on through a
command-line switch passed at launch. The extension can force-install
correctly and still see nothing at
chrome.enterprise.webrtc if Canary was running without
that switch.
Quit Canary completely first. The flag only takes effect on a fresh process, and a Canary instance still running in the background will just reopen its existing windows without picking up the switch.
macOS
"/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary" \
--enable-features=ApiEnterpriseWebrtc
Windows
"%LOCALAPPDATA%\Google\Chrome SxS\Application\chrome.exe" --enable-features=ApiEnterpriseWebrtc
Never launch Canary from the Dock, Start menu, or taskbar for this demo. None of those shortcuts carry the flag.
Demo Token
Get the demo token from Patrick directly and paste it into the extension's options page. It does not appear anywhere on this site or in this project's source.