Extensão em versões do Firefox anteriores à v128 ou v115 ESR

De acordo com o anúncio da Mozilla sobre a expiração do certificado raiz do Firefox em 14 de março de 2025, as extensões não conseguem ser instaladas em versões do Firefox anteriores à v128 ou v115.13 ESR.

• Se a extensão já estiver instalada no Firefox, ela continuará a funcionar mesmo após o certificado raiz expirar.
• Se a extensão for instalada após o certificado raiz expirar, ela será desabilitada e não funcionará.

Você pode aplicar algumas soluções alternativas, mas isso depende da idade da sua versão do Firefox e se ela é ou não uma versão ESR (Extended Support Release).

Solução para Firefox ESR

1. Acesse about:config.
2. Alternar sinalizador xpinstall.signatures.requiredpara false.

É preferível aplicar automaticamente essa configuração a todos os perfis usando um dos métodos listados abaixo.

Firefox v102.10 ESR ou mais recente

Você pode usar a Política de Grupo para modificar a preferência xpinstall.signatures.required para todos os usuários e perfis automaticamente.Para obter mais detalhes, consulte Modelos de Política para o Firefox.

Firefox mais antigo que v102.10 ESR

Versões mais antigas do Firefox não oferecem suporte a xpinstall.signatures.required por meio da Política de Grupo. Como alternativa, você pode usar os arquivos do AutoConfig:

1. Salve o seguinte em um arquivo de texto:

   // First line must be a comment.
   pref("xpinstall.signatures.required", false);

2. Nomeie o arquivo de texto allow-unsigned-extensions.cfg.
3. Salve o seguinte em um arquivo de texto:

   // First line must be a comment. 
   pref("general.config.filename", "allow-unsigned-extensions.cfg");
   pref("general.config.obscure_value", 0);

4. Nomeie o arquivo de texto allow-unsigned-extensions.js.
5. Localize o diretório de instalação do Firefox, normalmente C:\Program Files\Mozilla Firefox.
6. Copie allow-unsigned-extensions.cfg para C:\Program Files\Mozilla Firefox.
7. Copie allow-unsigned-extensions.js para C:\Program Files\Mozilla Firefox\defaults\pref.

Firefox - versões padrão

Para versões do Firefox não ESR, você deve usar os arquivos AutoConfig.

1. Salve o seguinte em um arquivo de texto:

   // First line must be a comment.
   // In Firefox 55+, settings to configure add-on signing (and legacy add-ons) are stored in AddonSettings.jsm
   // The module exports an object with read-only properties, but that is not an issue since we can just replace
   // the exported object.
   // https://searchfox.org/mozilla-central/rev/2e08acdf8862e68b13166970e17809a3b5d6a555/toolkit/mozapps/extensions/internal/AddonSettings.jsm
   
   Components.utils.import("resource://gre/modules/XPCOMUtils.jsm");
   
   function patchAddonSettings(modulePath) {
       var Module = Components.utils.import(modulePath, {});
       // Note: we read the data from preferences instead of hard-coding a "true", so
       // that by default legacy add-ons are disabled. This enables the user to only
       // enable legacy add-ons for specific Firefox profiles when really needed.
       var AddonSettings;
   
       if ("lazy" in Module) {
         AddonSettings = Object.create(Module.lazy.AddonSettings);
       } else {
         AddonSettings = Object.create(Module.AddonSettings);
       }
       XPCOMUtils.defineLazyPreferenceGetter(AddonSettings, "REQUIRE_SIGNING", "xpinstall.signatures.required", false);
       XPCOMUtils.defineLazyPreferenceGetter(AddonSettings, "ALLOW_LEGACY_EXTENSIONS", "extensions.legacy.enabled", true);
       XPCOMUtils.defineLazyPreferenceGetter(AddonSettings, "LANGPACKS_REQUIRE_SIGNING", "extensions.langpacks.signatures.required", false);
   
       if ("lazy" in Module) {
         Module.lazy.AddonSettings = AddonSettings;
       } else {
         Module.AddonSettings = AddonSettings;
       }
   }
   
   // This is necessary to allow legacy add-ons via preferences.
   try {
     patchAddonSettings("resource://gre/modules/addons/XPIProvider.jsm");
   } catch (e) {
     // AddonSettings is not in this file starting with Firefox 61,
     // but it comes back in Firefox 74
   }
   
   try {
     patchAddonSettings("resource://gre/modules/addons/XPIDatabase.jsm");
   } catch (e) {
     // AddonSettings is not in this file until Firefox 61
   }
   
   // This override is needed to enable unsigned add-ons via preferences.
   patchAddonSettings("resource://gre/modules/addons/XPIInstall.jsm");
   
   // This override is needed to allow unsigned add-ons to show up without warning in about:addons.
   // (this is UI-only, the add-on is not actually disabled despite what the UI claims).
   patchAddonSettings("resource://gre/modules/addons/AddonSettings.jsm");
   
   Components.classes['@mozilla.org/consoleservice;1']
   .getService(Components.interfaces.nsIConsoleService)
   .logStringMessage("enablelegacy.cfg: the extensions.legacy.enabled preference is working again.");
   
   pref("xpinstall.signatures.required", false);

2. Nomeie o arquivo de texto enablelegacy.cfg.
3. Salve o seguinte em um arquivo de texto:

   // First line must be a comment. 
   pref("general.config.filename", "enablelegacy.cfg");
   pref("general.config.obscure_value", 0);
   pref("general.config.sandbox_enabled", false);

4. Nomeie o arquivo de texto enablelegacy-prefs.js.
5. Localize o diretório de instalação do Firefox, normalmente C:\Program Files\Mozilla Firefox.
6. Copie enablelegacy.cfg para C:\Program Files\Mozilla Firefox.
7. Copie enablelegacy-prefs.js para C:\Program Files\Mozilla Firefox\defaults\pref.

Note: Recent versions of Firefox, like 102.10 ESR, re-enable the extension automatically once the flag is set. In older versions such as 68.0.2 ESR, it may be necessary to reinstall the extension.

Note: Firefox older than 68.0.2 ESR does not work with our implementation of Group Policy installation. The following script is a fix to be executed after running our installers. Studio 25.10 or newer will fix the incompatibility.

# Define the registry path
$regPath = "HKLM:\SOFTWARE\Policies\Mozilla\Firefox\Extensions\Install"

function Convert-WindowsPathToFileUrl($path) {
    $unixPath = $path -replace '\\', '/'
    $escapedPath = $unixPath -replace ' ', '%20'
    return "file:///" + $escapedPath
}

function Fix-FirefoxProfile($prefsPath, $fileUrl) {
    if (-not (Test-Path $prefsPath)) {
        Write-Host "prefs.js not found: $prefsPath"
        return
    }

    Write-Host "Processing prefs.js: $prefsPath"

    $content = Get-Content -Path $prefsPath -Raw

    $pattern = 'user_pref\("browser\.policies\.runOncePerModification\.extensionsInstall",\s*"(.+?)"\);'

    if (-not ($content -match $pattern)) {
        Write-Host " -> No matching preference found in prefs.js."
        return
    }

    $jsonArrayString = $matches[1]

    # Unescape \" to "
    $jsonArrayStringUnescaped = $jsonArrayString -replace '\\\"', '"'

    try {
        $list = ConvertFrom-Json -InputObject $jsonArrayStringUnescaped
    } catch {
        Write-Host " -> Error parsing JSON inside prefs.js preference (after unescaping)."
        return
    }

    if (-not ($list -contains $fileUrl)) {
        Write-Host " -> File URL not present in extensionsInstall list."
        return
    }

    $newList = $list | Where-Object { $_ -ne $fileUrl }

    $newJsonArrayString = ($newList | ConvertTo-Json -Compress)

    # prefs.js expects it wrapped as a string, escaping " as \"
    $escapedNewJsonArrayString = $newJsonArrayString -replace '"', '\"'

    $newPrefLine = "user_pref(""browser.policies.runOncePerModification.extensionsInstall"", `"$escapedNewJsonArrayString`");"

    # Replace the old line
    $oldPrefLine = $matches[0]
    $content = $content -replace [regex]::Escape($oldPrefLine), $newPrefLine

    Set-Content -Path $prefsPath -Value $content -Encoding UTF8
    Write-Host " -> prefs.js updated."
}

function Fix-AllFirefoxProfiles($fileUrl) {
    $profilesPath = "$env:APPDATA\Mozilla\Firefox\Profiles"

    if (-not (Test-Path $profilesPath)) {
        Write-Host "Firefox profiles directory not found: $profilesPath"
        return
    }

    $profiles = Get-ChildItem -Path $profilesPath -Directory
    foreach ($profile in $profiles) {
        $prefsPath = Join-Path $profile.FullName "prefs.js"
        Fix-FirefoxProfile -prefsPath $prefsPath -fileUrl $fileUrl
    }
}

if (-not (Test-Path $regPath)) {
    Write-Host "Registry path not found: $regPath"
    return
}

$values = Get-ItemProperty -Path $regPath

foreach ($property in $values.PSObject.Properties) {
    $name = $property.Name
    $value = $property.Value

    if ($value -notmatch "^[a-zA-Z]:\\.*\\uipath-ff\.xpi$") {
        continue
    }

    Write-Host "Found Windows path for uipath-ff.xpi in entry '$name': $value"

    $fileUrl = Convert-WindowsPathToFileUrl $value
    Write-Host " -> Converted to file URL: $fileUrl"

    Set-ItemProperty -Path $regPath -Name $name -Value $fileUrl
    Write-Host " -> Updated registry key '$name'."

    Fix-AllFirefoxProfiles -fileUrl $fileUrl
}