From: Michael Kaply <345868+mkaply@users.noreply.github.com> Date: Mon, 14 Sep 2020 20:51:10 +0000 (-0500) Subject: Merge pull request #681 from mozilla/Preferences X-Git-Tag: v2.3~5 X-Git-Url: https://git.p6c8.net/policy-templates.git/commitdiff_plain/a502970c61549d5b31679e97658df0f07d122a05?hp=2478d4df5932b738cb0bca1af4242fcb5a6df652 Merge pull request #681 from mozilla/Preferences Preferences --- diff --git a/README.md b/README.md index 5b0a194..dc293d6 100644 --- a/README.md +++ b/README.md @@ -75,7 +75,8 @@ Policies can be specified using the [Group Policy templates on Windows](https:// | **[`Permissions`](#permissions)** | Set permissions associated with camera, microphone, location, and notifications. | **[`PictureInPicture`](#pictureinpicture)** | Enable or disable Picture-in-Picture. | **[`PopupBlocking`](#popupblocking)** | Configure the default pop-up window policy as well as origins for which pop-up windows are allowed. -| **[`Preferences`](#preferences)** | Set and lock some preferences. +| **[`Preferences`](#preferences)** | Set and lock preferences. +| **[`Preferences (Deprecated)`](#preferences--deprecated)** | Set and lock some preferences. | **[`PromptForDownloadLocation`](#promptfordownloadlocation)** | Ask where to save each file before downloading. | **[`Proxy`](#proxy)** | Configure proxy settings. | **[`RequestedLocales`](#requestedlocales)** | Set the the list of requested locales for the application in order of preference. @@ -3749,6 +3750,149 @@ Value (string): } ``` ### Preferences +Set and lock preferences. + +Previously you could only set and lock a subset of preferences. Starting with Firefox 81 and Firefox ESR 78.3 you can set many more preferences. You can also set default preferences, user preferences and you can clear preferences. + +Preferences that start with the following prefixes are supported: +``` +accessibility. +browser. +datareporting.policy. +dom. +extensions. +geo. +intl. +layout. +media. +network. +places. +print. +ui. +widget. +``` +as well as the following security preferences: +``` +security.default_personal_cert +security.insecure_connection_text.enabled +security.insecure_connection_text.pbmode.enabled +security.insecure_field_warning.contextual.enabled +security.mixed_content.block_active_content +security.osclientcerts.autoload +security.ssl.errorReporting.enabled +security.tls.hello_downgrade_check +security.warn_submit_secure_to_insecure +``` +Using the preference as the key, set the `Value` to the corresponding preference value. + +`Status` can be "default", "locked", "user" or "clear" + +If a value is locked, it is also set as the default. + +User preferences persist across invocations of Firefox. + +See the examples below for more detail. + +IMPORTANT: Make sure you're only setting a particular preference using this mechanism and not some other way. + +Status +**Compatibility:** Firefox 81, Firefox ESR 78.3\ +**CCK2 Equivalent:** `preferences`\ +**Preferences Affected:** Many + +#### Windows (GPO) +``` +Software\Policies\Mozilla\Firefox\Preferences (REG_MULTI_SZ) = +{ + "accessibility.force_disabled": { + "Value": 1, + "Status": "default" + }, + "browser.cache.disk.parent_directory": { + "Value": "SOME_NATIVE_PATH", + "Status": "user" + }, + "browser.tabs.warnOnClose": { + "Value": false, + "Status": "locked" + } +} +``` +#### Windows (Intune) +OMA-URI: +``` +./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox/Preferences +``` +Value (string): +``` + + +``` +#### macOS +``` + + Preferences + + accessibility.force_disabled + + Value + 1 + Status + default + + browser.cache.disk.parent_directory + + Value + SOME_NATIVE_PATH + Status + user + + browser.tabs.warnOnClose + + Value + + Status + locked + + + +``` +#### policies.json +``` +{ + "policies": { + "Preferences": { + "accessibility.force_disabled": { + "Value": 1, + "Status": "default" + }, + "browser.cache.disk.parent_directory": { + "Value": "SOME_NATIVE_PATH", + "Status": "user" + }, + "browser.tabs.warnOnClose": { + "Value": false, + "Status": "locked" + } + } + } +} +``` +### Preferences (Deprecated) Set and lock certain preferences. **Compatibility:** See below\ diff --git a/mac/org.mozilla.firefox.plist b/mac/org.mozilla.firefox.plist index 6b0026a..3070383 100644 --- a/mac/org.mozilla.firefox.plist +++ b/mac/org.mozilla.firefox.plist @@ -512,10 +512,27 @@ Preferences - app.update.auto - - security.default_personal_cert - Ask Every Time + accessibility.force_disabled + + Value + 1 + Status + default + + browser.cache.disk.parent_directory + + Value + SOME_NATIVE_PATH + Status + user + + browser.tabs.warnOnClose + + Value + + Status + locked + Proxy diff --git a/windows/de-DE/firefox.adml b/windows/de-DE/firefox.adml index 898aca9..4e45b30 100644 --- a/windows/de-DE/firefox.adml +++ b/windows/de-DE/firefox.adml @@ -50,7 +50,7 @@ Flash Startseite Suche - Einstellungen + Einstellungen (Veraltet) Benutzer-Benachrichtigungen Disabled Ciphers DRM-Medien Erweiterungen @@ -803,6 +803,12 @@ Wenn diese Richtlinieneinstellung deaktiviert oder nicht konfiguriert ist, werde Für eine Beschreibung der Einstellung, siehe: https://github.com/mozilla/policy-templates/blob/master/README.md#handlers (Englisch) + Einstellungen + If this policy is enabled, you can use JSON to configure preferences. + +If this policy is disabled or not configured, preferences are not modified. + +For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences. Wenn diese Richtlinieneinstellung aktiviert ist, ist die Einstellung auf true gesperrt. Wenn diese Richtlinieneinstellung deaktiviert ist, ist die Einstellung auf false gesperrt. Für eine Beschreibung der Einstellung, siehe: @@ -1108,6 +1114,9 @@ https://github.com/mozilla/policy-templates/blob/master/README.md#preferences (E + + + diff --git a/windows/en-US/firefox.adml b/windows/en-US/firefox.adml index de5d5a7..4f42c02 100644 --- a/windows/en-US/firefox.adml +++ b/windows/en-US/firefox.adml @@ -50,7 +50,7 @@ Flash Home page Search - Preferences + Preferences (Deprecated) User Messaging Disabled Ciphers Encrypted Media Extensions @@ -804,6 +804,12 @@ If this policy is not configured, users can choose to create a primary password. If this policy is disabled or not configured, Firefox defaults are used. For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#handlers. + Preferences + If this policy is enabled, you can use JSON to configure preferences. + +If this policy is disabled or not configured, preferences are not modified. + +For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences. If this policy is enabled, the preference is locked to true. If this policy is disabled, the preference is locked to false. For a description of the preference, see: @@ -1108,6 +1114,9 @@ https://github.com/mozilla/policy-templates/blob/master/README.md#preferences. + + + diff --git a/windows/es-ES/firefox.adml b/windows/es-ES/firefox.adml index ab3e4b1..ff1ccf9 100644 --- a/windows/es-ES/firefox.adml +++ b/windows/es-ES/firefox.adml @@ -50,7 +50,7 @@ Flash Página de inicio Búsqueda - Preferencias + Preferencias (obsoleto) Mensajería del usuario Cifrados deshabilitados Extensiones de medios cifrados @@ -804,6 +804,12 @@ If this policy is not configured, users can choose to create a primary password. If this policy is disabled or not configured, Firefox defaults are used. For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#handlers. + Preferencias + If this policy is enabled, you can use JSON to configure preferences. + +If this policy is disabled or not configured, preferences are not modified. + +For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences. Si esta política está habilitada, la preferencia se bloquea en true. Si esta política está deshabilitada, la preferencia está bloqueada en false. Para una descripción de la preferencia, visita: @@ -1108,6 +1114,9 @@ https://github.com/mozilla/policy-templates/blob/master/README.md#preferences + + + diff --git a/windows/firefox.admx b/windows/firefox.admx index a63eb85..8a72161 100644 --- a/windows/firefox.admx +++ b/windows/firefox.admx @@ -3688,5 +3688,12 @@ + "> + + + + + + diff --git a/windows/fr-FR/firefox.adml b/windows/fr-FR/firefox.adml index 0526f6d..0137bfe 100644 --- a/windows/fr-FR/firefox.adml +++ b/windows/fr-FR/firefox.adml @@ -50,7 +50,7 @@ Flash Page d'accueil Recherche - Préférences + Préférences (Deprecated) User Messaging Disabled Ciphers Encrypted Media Extensions @@ -803,6 +803,12 @@ If this policy is not configured, users can choose to create a primary password. If this policy is disabled or not configured, Firefox defaults are used. For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#handlers. + Préférences + If this policy is enabled, you can use JSON to configure preferences. + +If this policy is disabled or not configured, preferences are not modified. + +For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences. Si cette stratégie est activée, la préférence est verrouillée sur true. Si cette stratégie est désactivée, la préférence est verrouillée sur false. Pour une description de la préférence, voir: @@ -1107,6 +1113,9 @@ https://github.com/mozilla/policy-templates/blob/master/README.md#preferences + + + diff --git a/windows/it-IT/firefox.adml b/windows/it-IT/firefox.adml index 6bd975b..89a1a64 100644 --- a/windows/it-IT/firefox.adml +++ b/windows/it-IT/firefox.adml @@ -50,7 +50,7 @@ Flash Pagina iniziale Ricerca - Preferenze + Preferenze (deprecata) Messaggi utente Cifrari disabilitati Encrypted Media Extensions @@ -804,6 +804,12 @@ Se questo criterio è non configurato, gli utenti possono scegliere di creare un Se questo criterio è disabilitato o non configurato, vengono utilizzati i criteri predefiniti di Firefox. Per informazioni dettagliate sulla creazione del criterio, si veda https://github.com/mozilla/policy-templates/blob/master/README.md#handlers. + Preferenze + If this policy is enabled, you can use JSON to configure preferences. + +If this policy is disabled or not configured, preferences are not modified. + +For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences. Se questo criterio è abilitato, la preferenza è impostata a Vero e resa non modificabile. Se questo criterio è disabilitato, la preferenza è impostata a Falso e resa non modificabile. Per una descrizione della preferenza, si veda: @@ -1108,6 +1114,9 @@ https://github.com/mozilla/policy-templates/blob/master/README.md#preferences + + + diff --git a/windows/zh-TW/firefox.adml b/windows/zh-TW/firefox.adml index b884f61..14939ec 100644 --- a/windows/zh-TW/firefox.adml +++ b/windows/zh-TW/firefox.adml @@ -50,7 +50,7 @@ Flash 首頁 搜尋 - 偏好設定 + 偏好設定（已棄用） 顯示給使用者的訊息 停用加密演算法 加密媒體擴充功能 @@ -802,6 +802,12 @@ Mozilla 建議您不要停用 Telemetry。透過 Telemetry 收集到的資訊可 若停用或不設定此原則，則使用 Firefox 預設設定。 若需要建立原則的詳細資訊，請參考 https://github.com/mozilla/policy-templates/blob/master/README.md#handlers。 + 偏好設定 + If this policy is enabled, you can use JSON to configure preferences. + +If this policy is disabled or not configured, preferences are not modified. + +For detailed information on creating the policy, see https://github.com/mozilla/policy-templates/blob/master/README.md#preferences. 若啟用此原則，偏好設定將鎖定為 true。若停用此原則，偏好設定則鎖定為 false。 若需要偏好設定的詳細說明，請參考： @@ -1106,6 +1112,9 @@ https://github.com/mozilla/policy-templates/blob/master/README.md#preferences。 + + + \ No newline at end of file