Edge Managed Deployment

Updated: May 25, 2026

Deploy the FireTail AI Monitor extension to Edge across your organisation with managed configuration, so end users never interact with credentials directly.

Edge is Chromium-based, so credentials are delivered via chrome.storage.managed. The extension reads this at startup; no user input is required.

If you are deploying the browser extension from the ZIP file below, follow the steps for manual deployment below to find the Edge add-on ID. Otherwise, the Edge add-on ID is phkbmioaghjcghbdlabpdbnbafbbelij.

Edge Download for Edge

Configuration reference

Key Type Required Description
firetailProjectToken string Yes FireTail project token. How to generate a project token
firetailAPIRegion string Yes The region of the FireTail SaaS to use: eu or us

macOS - Manual Deployment

  1. Download the ZIP file above and extract it.
  2. Visit edge://extensions/ and toggle on Developer mode.
  3. Click Load unpacked, then select the extracted folder.
  4. Locate the ID for the new FireTail Edge add-on.
  5. Create a new file and paste in the plist fragment below.
    • Replace <EDGE_ADDON_ID> and <REGION> with your values.
    • Generate two UUIDs and replace both instances of <GENERATED_UUID>.
    • Save as edge-firetail.mobileconfig.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>PayloadType</key>            <string>Configuration</string>
    <key>PayloadVersion</key>         <integer>1</integer>
    <key>PayloadScope</key>           <string>System</string>
    <key>PayloadIdentifier</key>      <string>com.firetail.edge.extension</string>
    <key>PayloadUUID</key>            <string><GENERATED_UUID></string>
    <key>PayloadDisplayName</key>     <string>Firetail Edge Extension Policy</string>
    <key>PayloadContent</key>
    <array>
      <dict>
        <key>PayloadType</key>        <string>com.apple.ManagedClient.preferences</string>
        <key>PayloadVersion</key>     <integer>1</integer>
        <key>PayloadIdentifier</key>  <string>com.firetail.edge.extension.mcx</string>
        <key>PayloadUUID</key>        <string><GENERATED_UUID></string>
        <key>PayloadEnabled</key>     <true/>
        <key>PayloadContent</key>
        <dict>
          <key>com.microsoft.Edge</key>
          <dict>
            <key>Forced</key>
            <array>
              <dict>
                <key>mcx_preference_settings</key>
                <dict>
                  <key>ExtensionSettings</key>
                  <dict>
                    <key><EDGE_ADDON_ID></key>
                    <dict>
                      <key>firetailAPIRegion</key>
                      <string><REGION></string>
                    </dict>
                  </dict>
                </dict>
              </dict>
            </array>
          </dict>
        </dict>
      </dict>
    </array>
  </dict>
</plist>
  1. Open a terminal and run the following command to ensure a clean installation: sudo profiles remove -identifier com.firetail.edge.extension.
  2. Open edge-firetail.mobileconfig to install the FireTail Edge Extension Policy.
    • You may be prompted to open System Settings to approve and complete installation.
  3. Run the following commands in a terminal, then reopen Edge:
sudo killall cfprefsd
sudo killall Edge

Windows - Intune (recommended)

Force-install the extension

In Intune, create a Settings catalog configuration profile for Windows 10 and later, targeting Microsoft Edge. Add the Control which extensions are installed silently (ExtensionInstallForcelist) setting with the following value:

<EDGE_ADDON_ID>;https://edge.microsoft.com/extensionwebstorebase/v1/crx

Push managed credentials

In the same profile, add a custom OMA-URI:

  • OMA-URI: ./Device/Vendor/MSFT/Policy/Config/Edge~Policy~microsoft_edge~3rdparty~extensions~<EDGE_ADDON_ID>~policy
  • Data type: String
  • Value:
{
  "firetailProjectToken": "<PROJECT_TOKEN>",
  "firetailAPIRegion": "<REGION>"
}

Windows - Group Policy

  1. Download the Microsoft Edge ADMX templates from Microsoft and copy them to your central policy store:
Copy-Item msedge.admx "C:\Windows\PolicyDefinitions\"
Copy-Item en-US\msedge.adml "C:\Windows\PolicyDefinitions\en-US\"
  1. In Group Policy Management Console, navigate to: Computer Configuration -> Administrative Templates -> Microsoft Edge -> Extensions
  2. Enable Configure extension management settings and paste:
{
  "<EDGE_ADDON_ID>": {
    "installation_mode": "force_installed",
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
    "toolbar_pin": "force_pinned"
  }
}
  1. Under 3rd party extensions -> <EDGE_ADDON_ID> -> Extension policy, enable the policy and paste:
{
  "firetailProjectToken": "<PROJECT_TOKEN>",
  "firetailAPIRegion": "<REGION>"
}
  1. Run gpupdate /force on a test device and restart Edge.

macOS - Jamf Pro

Deploy a configuration profile via your MDM (Jamf Pro, Intune, or Workspace ONE) targeting the com.microsoft.Edge domain. Set the scope to device-level so users cannot remove the extension.

Example plist fragment:

<key>ExtensionInstallForcelist</key>
<array>
  <string><EDGE_ADDON_ID>;https://edge.microsoft.com/extensionwebstorebase/v1/crx</string>
</array>
<key>3rdparty</key>
<dict>
  <key>extensions</key>
  <dict>
    <key><EDGE_ADDON_ID></key>
    <dict>
      <key>firetailProjectToken</key>
      <string><PROJECT_TOKEN></string>
      <key>firetailAPIRegion</key>
      <string><REGION></string>
    </dict>
  </dict>
</dict>

Linux - JSON policy files

Create the following files as root with permissions root:root / 0644.

/etc/opt/edge/policies/managed/firetail-install.json:

{
  "ExtensionInstallForcelist": [
    "<EDGE_ADDON_ID>;https://edge.microsoft.com/extensionwebstorebase/v1/crx"
  ]
}

/etc/opt/edge/policies/managed/firetail-config.json:

{
  "3rdparty": {
    "extensions": {
      "<EDGE_ADDON_ID>": {
        "firetailProjectToken": "<PROJECT_TOKEN>",
        "firetailAPIRegion": "<REGION>"
      }
    }
  }
}

Verifying the deployment

  1. On a target device, open edge://policy. Confirm ExtensionInstallForcelist is present and the 3rdparty block for your extension ID shows status OK.
  2. Open edge://extensions. The FireTail AI Monitor should be installed and not removable by the user.
  3. Open the extension's service worker console (edge://extensions -> Details -> Inspect views: service worker) and run:
chrome.storage.managed.get(null).then(console.log)

You should see the exact payload you pushed.

  1. Interact with an AI provider and confirm events appear in the FireTail platform.