diff --git a/schema/.source.json b/schema/.source.json index 3d719b7..457fb57 100644 --- a/schema/.source.json +++ b/schema/.source.json @@ -1,5 +1,5 @@ { "url": "https://raw.githubusercontent.com/mozilla/enterprise-firefox/enterprise-main/browser/components/enterprisepolicies/schemas/policies-schema.json", - "commit": "a7a371d1a042e5df49e19bd836aadc7dc0b16be1", - "permalink": "https://github.com/mozilla/enterprise-firefox/blob/a7a371d1a042e5df49e19bd836aadc7dc0b16be1/browser/components/enterprisepolicies/schemas/policies-schema.json" + "commit": "1ef73232f124111633ae1c6b410ec0cd761ba3c7", + "permalink": "https://github.com/mozilla/enterprise-firefox/blob/1ef73232f124111633ae1c6b410ec0cd761ba3c7/browser/components/enterprisepolicies/schemas/policies-schema.json" } diff --git a/schema/policies-schema.json b/schema/policies-schema.json index 544c836..6fee72a 100644 --- a/schema/policies-schema.json +++ b/schema/policies-schema.json @@ -668,7 +668,8 @@ "x-compatibility": { "firefox": { "version_added": "90" }, "firefox_esr": { "version_added": "91" }, - "firefox_enterprise": { "version_added": "149" } + "firefox_enterprise": { "version_added": "149" }, + "notes": "Only applicable to Windows." }, "x-restart-required": true, "description": "Enable or disable automatic application update in the background, when the application is not running.", @@ -1086,6 +1087,11 @@ }, "ClipboardCopy": { "type": "object", + "x-compatibility": { + "firefox": { "version_added": "158" }, + "firefox_esr": { "version_added": false }, + "firefox_enterprise": { "version_added": "158" } + }, "properties": { "Enabled": { "type": "boolean" @@ -1097,6 +1103,11 @@ }, "Download": { "type": "object", + "x-compatibility": { + "firefox": { "version_added": "141" }, + "firefox_esr": { "version_added": "140.2.0" }, + "firefox_enterprise": { "version_added": "149" } + }, "properties": { "Enabled": { "type": "boolean" @@ -1185,6 +1196,9 @@ "properties": { "Allow": { "type": "array", + "x-compatibility": { + "notes": "From Firefox 154, using `Allow` to exempt sites from clearing on shutdown is deprecated. Use `SanitizeOnShutdown` `Exceptions` instead." + }, "items": { "$ref": "#/definitions/origin" } }, "AllowSession": { @@ -1242,7 +1256,8 @@ "x-compatibility": { "firefox": { "version_added": "95" }, "firefox_esr": { "version_added": "91.4.0" }, - "firefox_enterprise": { "version_added": "149" } + "firefox_enterprise": { "version_added": "149" }, + "notes": "`partition-foreign` was added in Firefox 153 / Firefox ESR 153, replacing `reject-tracker-and-partition-foreign`, which is deprecated." }, "oneOf": [ { @@ -1284,6 +1299,12 @@ }, "BehaviorPrivateBrowsing": { "type": "string", + "x-compatibility": { + "firefox": { "version_added": "95" }, + "firefox_esr": { "version_added": "91.4.0" }, + "firefox_enterprise": { "version_added": "149" }, + "notes": "`partition-foreign` was added in Firefox 153 / Firefox ESR 153, replacing `reject-tracker-and-partition-foreign`, which is deprecated." + }, "oneOf": [ { "const": "accept", @@ -1527,7 +1548,8 @@ "x-compatibility": { "firefox": { "version_added": "76" }, "firefox_esr": { "version_added": "68.8.0" }, - "firefox_enterprise": { "version_added": "149" } + "firefox_enterprise": { "version_added": "149" }, + "notes": "Before Firefox 78 / Firefox ESR 68.11, setting a cipher to `false` also disabled it." }, "x-restart-required": true, "description": "Disable specific cryptographic ciphers, listed below.", @@ -1547,28 +1569,58 @@ "type": "boolean" }, "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "97" }, + "firefox_esr": { "version_added": "91.6.0" }, + "firefox_enterprise": { "version_added": "149" } + } }, "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "97" }, + "firefox_esr": { "version_added": "91.6.0" }, + "firefox_enterprise": { "version_added": "149" } + } }, "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "97" }, + "firefox_esr": { "version_added": "91.6.0" }, + "firefox_enterprise": { "version_added": "149" } + } }, "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "97" }, + "firefox_esr": { "version_added": "91.6.0" }, + "firefox_enterprise": { "version_added": "149" } + } }, "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA": { "type": "boolean" }, "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "97" }, + "firefox_esr": { "version_added": "91.6.0" }, + "firefox_enterprise": { "version_added": "149" } + } }, "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA": { "type": "boolean" }, "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "97" }, + "firefox_esr": { "version_added": "91.6.0" }, + "firefox_enterprise": { "version_added": "149" } + } }, "TLS_DHE_RSA_WITH_AES_128_CBC_SHA": { "type": "boolean" @@ -1577,10 +1629,20 @@ "type": "boolean" }, "TLS_RSA_WITH_AES_128_GCM_SHA256": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "78" }, + "firefox_esr": { "version_added": "78" }, + "firefox_enterprise": { "version_added": "149" } + } }, "TLS_RSA_WITH_AES_256_GCM_SHA384": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "78" }, + "firefox_esr": { "version_added": "78" }, + "firefox_enterprise": { "version_added": "149" } + } }, "TLS_RSA_WITH_AES_128_CBC_SHA": { "type": "boolean" @@ -1592,13 +1654,28 @@ "type": "boolean" }, "TLS_CHACHA20_POLY1305_SHA256": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "138" }, + "firefox_esr": { "version_added": "128.10.0" }, + "firefox_enterprise": { "version_added": "149" } + } }, "TLS_AES_128_GCM_SHA256": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "138" }, + "firefox_esr": { "version_added": "128.10.0" }, + "firefox_enterprise": { "version_added": "149" } + } }, "TLS_AES_256_GCM_SHA384": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "138" }, + "firefox_esr": { "version_added": "128.10.0" }, + "firefox_enterprise": { "version_added": "149" } + } } } }, @@ -1940,7 +2017,8 @@ "x-compatibility": { "firefox": { "version_added": "60" }, "firefox_esr": { "version_added": "60" }, - "firefox_enterprise": { "version_added": false } + "firefox_enterprise": { "version_added": false }, + "notes": "From Firefox 83 / Firefox ESR 78.5, local storage of telemetry data is also turned off." }, "x-restart-required": true, "description": "Prevent the upload of telemetry data.", @@ -1954,7 +2032,10 @@ "firefox": { "version_added": "110" }, "firefox_esr": { "version_added": "115" }, "firefox_enterprise": { "version_added": "149" }, - "notes": "Only applicable to Windows." + "notes": [ + "Only applicable to Windows.", + "Set through Group Policy, Firefox does not load the dynamic blocklist. Set in `policies.json`, it only removes the option to block modules in `about:third-party`, and modules blocked earlier stay blocked." + ] }, "x-restart-required": true, "description": "Prevent the user from using Third-party Module Information (about:third-party) to block third-party modules injected into the Firefox process.", @@ -2007,7 +2088,8 @@ "x-compatibility": { "firefox": { "version_added": "60" }, "firefox_esr": { "version_added": "60" }, - "firefox_enterprise": { "version_added": "149" } + "firefox_enterprise": { "version_added": "149" }, + "notes": "Only applicable to Windows and some Linux desktops." }, "x-restart-required": true, "description": "Set the state of the menubar.", @@ -2342,7 +2424,8 @@ "x-compatibility": { "firefox": { "version_added": "69" }, "firefox_esr": { "version_added": "68.1.0" }, - "firefox_enterprise": { "version_added": "149" } + "firefox_enterprise": { "version_added": "149" }, + "notes": "From Firefox 85 / Firefox ESR 78.7, a theme installed by this policy becomes the active theme." }, "x-restart-required": false, "description": "Manage all aspects of extensions.", @@ -2710,16 +2793,27 @@ ], "properties": { "WebSuggestions": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "notes": "From Firefox 146 / Firefox ESR 153, `false` turns off Firefox Suggest completely. Earlier versions turn off only non-sponsored suggestions." + } }, "SponsoredSuggestions": { "type": "boolean" }, "ImproveSuggest": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "notes": "Deprecated in Firefox 146. Use `OnlineEnabled` instead." + } }, "OnlineEnabled": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "146" }, + "firefox_esr": { "version_added": "153" }, + "firefox_enterprise": { "version_added": "149" } + } }, "Locked": { "type": "boolean" @@ -2751,7 +2845,12 @@ "type": "boolean" }, "SmartWindow": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "firefox": { "version_added": "150" }, + "firefox_esr": { "version_added": "153" }, + "firefox_enterprise": { "version_added": "150" } + } }, "LinkPreviews": { "type": "boolean" @@ -3057,7 +3156,11 @@ "x-compatibility": { "firefox": { "version_added": "70" }, "firefox_esr": { "version_added": "68.2.0" }, - "firefox_enterprise": { "version_added": false } + "firefox_enterprise": { "version_added": false }, + "notes": [ + "Only applicable to Windows.", + "Only takes effect when set through Group Policy. Firefox ignores it in `policies.json`." + ] }, "x-restart-required": true, "description": "Disable the feature enforcing a separate profile for each installation.", @@ -3335,7 +3438,8 @@ "x-compatibility": { "firefox": { "version_added": "60" }, "firefox_esr": { "version_added": "60" }, - "firefox_enterprise": { "version_added": "149" } + "firefox_enterprise": { "version_added": "149" }, + "notes": "Multiple URLs separated by `|` are accepted from Firefox 83 / Firefox ESR 78.5." }, "x-restart-required": true, "description": "Override the first run page.", @@ -3361,7 +3465,11 @@ "x-compatibility": { "firefox": { "version_added": "70" }, "firefox_esr": { "version_added": "68.2.0" }, - "firefox_enterprise": { "version_added": "149" } + "firefox_enterprise": { "version_added": "149" }, + "notes": [ + "Blocking `about:logins` was added in Firefox 70 / Firefox ESR 78.", + "From Firefox 153 / Firefox ESR 153, `false` also turns off the passwords sidebar." + ] }, "x-restart-required": true, "description": "Enable or disable saving passwords to the password manager. If disabled, Passwords (about:logins) is also blocked.", @@ -4004,7 +4112,8 @@ "x-compatibility": { "firefox": { "version_added": "64" }, "firefox_esr": { "version_added": "60.4.0" }, - "firefox_enterprise": { "version_added": "149" } + "firefox_enterprise": { "version_added": "149" }, + "notes": "A string value is accepted from Firefox 68 / Firefox ESR 68, so an empty value (`\"\"`) can be set. Earlier versions accept only an array." }, "x-restart-required": true, "description": "Set the list of requested locales for the application in order of preference.", @@ -4020,7 +4129,8 @@ "x-compatibility": { "firefox": { "version_added": "60" }, "firefox_esr": { "version_added": "60" }, - "firefox_enterprise": { "version_added": "149" } + "firefox_enterprise": { "version_added": "149" }, + "notes": "The object form was added in Firefox 68 / Firefox ESR 68. Earlier versions accept only `true` / `false`." }, "x-restart-required": true, "description": "Clear specified data on shutdown, such as History, Cookies, Logins, Cache, Form History, Site Preferences and Offline Website Data.", @@ -4047,7 +4157,10 @@ "type": "boolean" }, "FormData": { - "type": "boolean" + "type": "boolean", + "x-compatibility": { + "notes": "From Firefox 136 / Firefox ESR 140, form data is cleared separately from `History`. In earlier versions, `History` also clears form data." + } }, "History": { "type": "boolean" @@ -4981,7 +5094,8 @@ "x-compatibility": { "firefox": { "version_added": "91" }, "firefox_esr": { "version_added": "91" }, - "firefox_enterprise": { "version_added": "149" } + "firefox_enterprise": { "version_added": "149" }, + "notes": "Only applicable to Windows." }, "x-restart-required": true, "description": "Allow Windows single sign-on for Microsoft, work, and school accounts.",