/* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this file, * You can obtain one at http://mozilla.org/MPL/2.0/. */ import { AppConstants } from "resource://gre/modules/AppConstants.sys.mjs"; const lazy = {}; ChromeUtils.defineESModuleGetters(lazy, { ObjectUtils: "resource://gre/modules/ObjectUtils.sys.mjs", }); /** * Default implementation of the helper class to assist in deleting the firefox protocols. * See maybeDeleteBridgeProtocolRegistryEntries for more info. */ class DeleteBridgeProtocolRegistryEntryHelperImplementation { getApplicationPath() { return Services.dirsvc.get("XREExeF", Ci.nsIFile).path; } openRegistryRoot() { const wrk = Cc["@mozilla.org/windows-registry-key;1"].createInstance( Ci.nsIWindowsRegKey ); wrk.open(wrk.ROOT_KEY_CURRENT_USER, "Software\\Classes", wrk.ACCESS_ALL); return wrk; } deleteChildren(start) { // Recursively delete all of the children of the children // Go through the list in reverse order, so that shrinking // the list doesn't rearrange things while iterating for (let i = start.childCount; i > 0; i--) { const childName = start.getChildName(i - 1); const child = start.openChild(childName, start.ACCESS_ALL); this.deleteChildren(child); child.close(); start.removeChild(childName); } } deleteRegistryTree(root, toDeletePath) { var start = root.openChild(toDeletePath, root.ACCESS_ALL); this.deleteChildren(start); start.close(); root.removeChild(toDeletePath); } } export const FirefoxBridgeExtensionUtils = { /** * In Firefox 122, we enabled the firefox and firefox-private protocols. * We switched over to using firefox-bridge and firefox-private-bridge, * * but we want to clean up the use of the other protocols. * * deleteBridgeProtocolRegistryEntryHelper handles everything outside of the logic needed for * this method so that the logic in maybeDeleteBridgeProtocolRegistryEntries can be unit tested * * We only delete the entries for the firefox and firefox-private protocols if * they were set up to use this install and in the format that Firefox installed * them with. If the entries are changed in any way, it is assumed that the user * mucked with them manually and knows what they are doing. */ maybeDeleteBridgeProtocolRegistryEntries( deleteBridgeProtocolRegistryEntryHelper = new DeleteBridgeProtocolRegistryEntryHelperImplementation() ) { try { var wrk = deleteBridgeProtocolRegistryEntryHelper.openRegistryRoot(); const path = deleteBridgeProtocolRegistryEntryHelper.getApplicationPath(); const maybeDeleteRegistryKey = (protocol, protocolCommand) => { const openCommandPath = protocol + "\\shell\\open\\command"; if (wrk.hasChild(openCommandPath)) { let deleteProtocolEntry = false; try { var openCommandKey = wrk.openChild( openCommandPath, wrk.ACCESS_READ ); if (openCommandKey.valueCount == 1) { const defaultKeyName = ""; if (openCommandKey.getValueName(0) == defaultKeyName) { if ( openCommandKey.getValueType(defaultKeyName) == Ci.nsIWindowsRegKey.TYPE_STRING ) { const val = openCommandKey.readStringValue(defaultKeyName); if (val == protocolCommand) { deleteProtocolEntry = true; } } } } } finally { openCommandKey.close(); } if (deleteProtocolEntry) { deleteBridgeProtocolRegistryEntryHelper.deleteRegistryTree( wrk, protocol ); } } }; maybeDeleteRegistryKey("firefox", `\"${path}\" -osint -url \"%1\"`); maybeDeleteRegistryKey( "firefox-private", `\"${path}\" -osint -private-window \"%1\"` ); } catch (err) { console.error(err); } finally { wrk.close(); } }, /** * Registers the firefox-bridge and firefox-private-bridge protocols * on the Windows platform. */ maybeRegisterFirefoxBridgeProtocols() { const FIREFOX_BRIDGE_HANDLER_NAME = "firefox-bridge"; const FIREFOX_PRIVATE_BRIDGE_HANDLER_NAME = "firefox-private-bridge"; const path = Services.dirsvc.get("XREExeF", Ci.nsIFile).path; let wrk = Cc["@mozilla.org/windows-registry-key;1"].createInstance( Ci.nsIWindowsRegKey ); try { wrk.open(wrk.ROOT_KEY_CLASSES_ROOT, "", wrk.ACCESS_READ); let FxSet = wrk.hasChild(FIREFOX_BRIDGE_HANDLER_NAME); let FxPrivateSet = wrk.hasChild(FIREFOX_PRIVATE_BRIDGE_HANDLER_NAME); wrk.close(); if (FxSet && FxPrivateSet) { return; } wrk.open(wrk.ROOT_KEY_CURRENT_USER, "Software\\Classes", wrk.ACCESS_ALL); const maybeUpdateRegistry = (isSetAlready, handler, protocolName) => { if (isSetAlready) { return; } let FxKey = wrk.createChild(handler, wrk.ACCESS_ALL); try { // Write URL protocol key FxKey.writeStringValue("", protocolName); FxKey.writeStringValue("URL Protocol", ""); FxKey.close(); // Write defaultIcon key FxKey.create( FxKey.ROOT_KEY_CURRENT_USER, "Software\\Classes\\" + handler + "\\DefaultIcon", FxKey.ACCESS_ALL ); FxKey.open( FxKey.ROOT_KEY_CURRENT_USER, "Software\\Classes\\" + handler + "\\DefaultIcon", FxKey.ACCESS_ALL ); FxKey.writeStringValue("", `\"${path}\",1`); FxKey.close(); // Write shell\\open\\command key FxKey.create( FxKey.ROOT_KEY_CURRENT_USER, "Software\\Classes\\" + handler + "\\shell", FxKey.ACCESS_ALL ); FxKey.create( FxKey.ROOT_KEY_CURRENT_USER, "Software\\Classes\\" + handler + "\\shell\\open", FxKey.ACCESS_ALL ); FxKey.create( FxKey.ROOT_KEY_CURRENT_USER, "Software\\Classes\\" + handler + "\\shell\\open\\command", FxKey.ACCESS_ALL ); FxKey.open( FxKey.ROOT_KEY_CURRENT_USER, "Software\\Classes\\" + handler + "\\shell\\open\\command", FxKey.ACCESS_ALL ); if (handler == FIREFOX_PRIVATE_BRIDGE_HANDLER_NAME) { FxKey.writeStringValue( "", `\"${path}\" -osint -private-window \"%1\"` ); } else { FxKey.writeStringValue("", `\"${path}\" -osint -url \"%1\"`); } } catch (ex) { console.error(ex); } finally { FxKey.close(); } }; try { maybeUpdateRegistry( FxSet, FIREFOX_BRIDGE_HANDLER_NAME, "URL:Firefox Bridge Protocol" ); } catch (ex) { console.error(ex); } try { maybeUpdateRegistry( FxPrivateSet, FIREFOX_PRIVATE_BRIDGE_HANDLER_NAME, "URL:Firefox Private Bridge Protocol" ); } catch (ex) { console.error(ex); } } catch (ex) { console.error(ex); } finally { wrk.close(); } }, getNativeMessagingHostId() { let nativeMessagingHostId = "org.mozilla.firefox_bridge_nmh"; if (AppConstants.NIGHTLY_BUILD) { nativeMessagingHostId += "_nightly"; } else if (AppConstants.MOZ_DEV_EDITION) { nativeMessagingHostId += "_dev"; } else if (AppConstants.IS_ESR) { nativeMessagingHostId += "_esr"; } return nativeMessagingHostId; }, getExtensionOrigins() { return Services.prefs .getStringPref("browser.firefoxbridge.extensionOrigins", "") .split(","); }, async maybeWriteManifestFiles( nmhManifestFolder, nativeMessagingHostId, dualBrowserExtensionOrigins ) { try { let binFile = Services.dirsvc.get("XREExeF", Ci.nsIFile).parent; if (AppConstants.platform == "win") { binFile.append("nmhproxy.exe"); } else if (AppConstants.platform == "macosx") { binFile.append("nmhproxy"); } else { throw new Error("Unsupported platform"); } let jsonContent = { name: nativeMessagingHostId, description: "Firefox Native Messaging Host", path: binFile.path, type: "stdio", allowed_origins: dualBrowserExtensionOrigins, }; let nmhManifestFile = await IOUtils.getFile( nmhManifestFolder, `${nativeMessagingHostId}.json` ); // This throws an error if the JSON file doesn't exist // or if it's corrupt. let correctFileExists = true; try { correctFileExists = lazy.ObjectUtils.deepEqual( await IOUtils.readJSON(nmhManifestFile.path), jsonContent ); } catch (e) { correctFileExists = false; } if (!correctFileExists) { await IOUtils.writeJSON(nmhManifestFile.path, jsonContent); } } catch (e) { console.error(e); } }, async ensureRegistered() { let nmhManifestFolder = null; if (AppConstants.platform == "win") { // We don't have permission to write to the application install directory // so instead write to %AppData%\Mozilla\Firefox. nmhManifestFolder = PathUtils.join( Services.dirsvc.get("AppData", Ci.nsIFile).path, "Mozilla", "Firefox" ); } else if (AppConstants.platform == "macosx") { nmhManifestFolder = "~/Library/Application Support/Google/Chrome/NativeMessagingHosts/"; } else { throw new Error("Unsupported platform"); } await this.maybeWriteManifestFiles( nmhManifestFolder, this.getNativeMessagingHostId(), this.getExtensionOrigins() ); if (AppConstants.platform == "win") { this.maybeWriteNativeMessagingRegKeys( "Software\\Google\\Chrome\\NativeMessagingHosts", nmhManifestFolder, this.getNativeMessagingHostId() ); } }, maybeWriteNativeMessagingRegKeys( regPath, nmhManifestFolder, NATIVE_MESSAGING_HOST_ID ) { let wrk = Cc["@mozilla.org/windows-registry-key;1"].createInstance( Ci.nsIWindowsRegKey ); try { let expectedValue = PathUtils.join( nmhManifestFolder, `${NATIVE_MESSAGING_HOST_ID}.json` ); try { // If the key already exists it will just be opened wrk.create( wrk.ROOT_KEY_CURRENT_USER, regPath + `\\${NATIVE_MESSAGING_HOST_ID}`, wrk.ACCESS_ALL ); if (wrk.readStringValue("") == expectedValue) { return; } } catch (e) { // The key either doesn't have a value or doesn't exist // In either case we need to write it. } wrk.writeStringValue("", expectedValue); } catch (e) { // The method fails if we can't access the key // which means it doesn't exist. That's a normal situation. // We don't need to do anything here. } finally { wrk.close(); } }, };