Chrome Extension Issues

Troubleshooting the BlueSentinel Chrome extension.


Extension Not Installed

Check Enterprise Policy

The extension must be force-installed via Chrome Enterprise Policy. Verify:

Windows:

powershell
# Check registry
Get-ItemProperty "HKLM:\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist"

macOS:

bash
# Check managed preferences
defaults read com.google.Chrome ExtensionInstallForcelist

Chrome Not Detecting Policy

  1. Open chrome://policy and click "Reload policies"
  2. Check if the extension appears in the policy list
  3. Verify the update URL is accessible from the endpoint

Extension Installed But Not Working

Check Extension Status

  1. Open chrome://extensions
  2. Verify the extension is enabled
  3. Check for error messages

Domain Blocking Not Working

  1. Verify the blocked domains are in the policy
  2. Check if the domain is being accessed via a subdomain (domain matching is suffix-based)
  3. Clear Chrome cache and restart the browser

Upload Blocking Not Working

  1. Check if the site uses a non-standard upload method
  2. Verify the extension has the necessary permissions
  3. Check the extension's background page console for errors (chrome://extensions → Developer mode → Background page → Console)

Extension Removed by User

If the extension is properly force-installed via enterprise policy, users cannot remove it. If removal is possible:

  1. Verify the Chrome Enterprise Policy is correctly configured
  2. Check that the endpoint is domain-joined (Windows) or MDM-managed (macOS)
  3. The DLP agent also installs the extension via install_chrome_extension() on startup