X-Git-Url: https://git.p6c8.net/policy-templates.git/blobdiff_plain/3b75b4f4febbf729c942006c5edfe29d432dcda5..64bb954590726fb4077511256d06c060948f3692:/docs/index.md
diff --git a/docs/index.md b/docs/index.md
index 9d40284..5ca4ddc 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -31,6 +31,7 @@ Note: The `policies.json` must use the UTF-8 encoding.
| **[`BlockAboutProfiles`](#blockaboutprofiles)** | Block access to About Profiles (about:profiles).
| **[`BlockAboutSupport`](#blockaboutsupport)** | Block access to Troubleshooting Information (about:support).
| **[`Bookmarks`](#bookmarks)** | Add bookmarks in either the bookmarks toolbar or menu.
+| **[`BrowserDataBackup`](#browserdatabackup)** | Disable backup or restore of profile data.
| **[`CaptivePortal`](#captiveportal)** | Enable or disable the detection of captive portals.
| **[`Certificates`](#certificates)** |
| **[`Certificates -> ImportEnterpriseRoots`](#certificates--importenterpriseroots)** | Trust certificates that have been added to the operating system certificate store by a user or administrator.
@@ -55,7 +56,7 @@ Note: The `policies.json` must use the UTF-8 encoding.
| **[`DisablePasswordReveal`](#disablepasswordreveal)** | Do not allow passwords to be revealed in saved logins.
| **[`DisablePocket`](#disablepocket-deprecated)** | Remove Pocket in the Firefox UI.
| **[`DisablePrivateBrowsing`](#disableprivatebrowsing)** | Remove access to private browsing.
-| **[`DisableProfileImport`](#disableprofileimport)** | Disables the "Import data from another browser" option in the bookmarks window.
+| **[`DisableProfileImport`](#disableprofileimport)** | Remove the ability to import data from other browers.
| **[`DisableProfileRefresh`](#disableprofilerefresh)** | Disable the Refresh Firefox button on about:support and support.mozilla.org
| **[`DisableSafeMode`](#disablesafemode)** | Disable safe mode within the browser.
| **[`DisableSecurityBypass`](#disablesecuritybypass)** | Prevent the user from bypassing security in certain cases.
@@ -317,7 +318,9 @@ Prevent Firefox from being updated beyond the specified version.
You can specify the any version as ```xx.``` and Firefox will be updated with all minor versions, but will not be updated beyond the major version.
-You can also specify the version as ```xx.xx``` and Firefox will be updated with all patch versions, but will not be updated beyond the minor version.
+You can also specify the version as ```xx.xx.``` and Firefox will be updated with all patch versions, but will not be updated beyond the minor version.
+
+Note: The value MUST end in a dot(.).
You should specify a version that exists or is guaranteed to exist. If you specify a version that doesn't end up existing, Firefox will update beyond that version.
@@ -1000,6 +1003,56 @@ Value (string):
}
}
```
+
+### BrowserDataBackup
+
+Disable backup or restore of profile data. Backup and restore can be disabled individually.
+
+Note: The policy can be used to disable backup and restore if it would otherwise be enabled, but cannot be used to force backup or restore to be enabled under conditions where it would not otherwise be (such as a platform on which backup or restore are not yet supported).
+
+**Compatibility:** Firefox 146\
+**CCK2 Equivalent:** N/A\
+**Preferences Affected:** N/A\
+
+#### Windows (GPO)
+```
+Software\Policies\Mozilla\Firefox\BrowserDataBackup\AllowBackup = 0x1 | 0x0
+Software\Policies\Mozilla\Firefox\BrowserDataBackup\AllowRestore = 0x1 | 0x0
+```
+#### Windows (Intune)
+OMA-URI:
+```
+./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Backup/BrowserDataBackup_AllowBackup
+./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~Backup/BrowserDataBackup_AllowRestore
+```
+Value (string):
+```
+ or
+```
+#### macOS
+```
+
+ BrowserDataBackup/key>
+
+ AllowBackup
+ |
+ AllowRestore
+ |
+
+
+```
+#### policies.json
+```
+{
+ "policies": {
+ "BrowserDataBackup": {
+ "AllowBackup": true | false,
+ "AllowRestore": true | false
+ }
+ }
+}
+```
+
### CaptivePortal
Enable or disable the detection of captive portals.
@@ -2322,7 +2375,7 @@ Value (string):
}
```
### DisableProfileImport
-Disables the "Import data from another browser" option in the bookmarks window.
+Remove the ability to import data from other browers.
**Compatibility:** Firefox 60, Firefox ESR 60\
**CCK2 Equivalent:** N/A\
@@ -2928,6 +2981,8 @@ Software\Policies\Mozilla\Firefox\EnableTrackingProtection\EmailTracking = 0x1 |
Software\Policies\Mozilla\Firefox\EnableTrackingProtection\SuspectedFingerprinting = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Exceptions\1 = "https://example.com"
Software\Policies\Mozilla\Firefox\EnableTrackingProtection\Category = "strict" | "standard"
+Software\Policies\Mozilla\Firefox\EnableTrackingProtection\BaselineExceptions = 0x1 | 0x0
+Software\Policies\Mozilla\Firefox\EnableTrackingProtection\ConvenienceExceptions = 0x1 | 0x0
```
#### Windows (Intune)
OMA-URI:
@@ -2995,6 +3050,22 @@ Value (string):
```
or
```
+OMA-URI:
+```
+./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~TrackingProtection/H_TrackingProtection_BaselineExceptions
+```
+Value (string):
+```
+ or
+```
+OMA-URI:
+```
+./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~TrackingProtection/H_TrackingProtection_ConvenienceExceptions
+```
+Value (string):
+```
+ or
+```
#### macOS
```
@@ -3018,6 +3089,10 @@ Value (string):
https://example.com
+ BaselineExceptions
+ |
+ ConvenienceExceptions
+ |
```
@@ -3033,7 +3108,9 @@ Value (string):
"EmailTracking": true | false,
"SuspectedFingerprinting": true | false,
"Category": "strict" | "standard",
- "Exceptions": ["https://example.com"]
+ "Exceptions": ["https://example.com"],
+ "BaselineExceptions": true | false,
+ "ConvenienceExceptions": true | false
}
}
}
@@ -3555,9 +3632,11 @@ Value (string):
### FirefoxSuggest
Customize Firefox Suggest (US only).
+As of Firefox 146, `WebSuggestions` turns off Suggest completely.
+
**Compatibility:** Firefox 118, Firefox ESR 115.3.
**CCK2 Equivalent:** N/A\
-**Preferences Affected:** `browser.urlbar.suggest.quicksuggest.nonsponsored`, `browser.urlbar.suggest.quicksuggest.sponsored`, `browser.urlbar.quicksuggest.dataCollection.enabled`
+**Preferences Affected:** `browser.urlbar.suggest.quicksuggest.all`, `browser.urlbar.suggest.quicksuggest.sponsored`, `browser.urlbar.quicksuggest.dataCollection.enabled`
#### Windows (GPO)
```
@@ -3632,20 +3711,23 @@ Value (string):
Configure generative AI features.
-`Chatbot` If false, AI chatbots are not available in the sidebar.
+`Enabled` Controls whether generative AI features are enabled by default. If false, all generative AI features are disabled by default. Individual generative AI policies can override this setting.
-`LinkPreviews` If false, AI is not used to generate link previews (Firefox 144).
+`Chatbot` Controls access to AI chatbots in the sidebar. If false, AI chatbots are not available in the sidebar.
-`TabGroups` If false, AI is not used to suggest names and tabs for tab groups (Firefox 144).
+`LinkPreviews` (Firefox 144+) Controls whether AI is used to generate link previews. If false, AI is not used to generate link previews.
-`Locked` prevents the user from changing generative AI preferences.
+`TabGroups` (Firefox 144+) Controls whether AI is used to suggest names and tabs for tab groups. If false, AI is not used to suggest names or tabs for tab groups.
+
+`Locked` Prevents the user from changing generative AI preferences.
**Compatibility:** Firefox 144, Firefox ESR 140.4\
**CCK2 Equivalent:** N/A\
-**Preferences Affected:** `browser.ml.chat.enabled`, `browser.ml.linkPreview.optin`, `browser.tabs.groups.smart.userEnabled`
+**Preferences Affected:** `browser.ml.chat.enabled`, `browser.ml.chat.page`, `browser.ml.linkPreview.optin`, `browser.tabs.groups.smart.userEnabled`
#### Windows (GPO)
```
+Software\Policies\Mozilla\Firefox\GenerativeAI\Enabled = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\GenerativeAI\Chatbot = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\GenerativeAI\LinkPreviews = 0x1 | 0x0
Software\Policies\Mozilla\Firefox\GenerativeAI\TabGroups = 0x1 | 0x0
@@ -3654,6 +3736,7 @@ Software\Policies\Mozilla\Firefox\GenerativeAI\Locked = 0x1 | 0x0
#### Windows (Intune)
OMA-URI:
```
+./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~GenerativeAI/GenerativeAI_Enabled
./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~GenerativeAI/GenerativeAI_Chatbot
./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~GenerativeAI/GenerativeAI_LinkPreviews
./Device/Vendor/MSFT/Policy/Config/Firefox~Policy~firefox~GenerativeAI/GenerativeAI_TabGroups
@@ -3668,6 +3751,8 @@ Value (string):
GenerativeAI
+ Enabled
+ |
Chatbot
|
LinkPreviews
@@ -3684,6 +3769,7 @@ Value (string):
{
"policies": {
"GenerativeAI": {
+ "Enabled": true | false,
"Chatbot": true | false,
"LinkPreviews": true | false,
"TabGroups": true | false,
@@ -6244,8 +6330,6 @@ or
}
}
```
-
-
### SanitizeOnShutdown (Selective)
Clear data on shutdown.
@@ -6449,8 +6533,6 @@ Value (string):
}
}
```
-
-
### SearchEngines
As of Firefox 139, this policy is available in all versions of Firefox.
@@ -7116,8 +7198,6 @@ Prevent Firefox from messaging the user in certain situations.
`FirefoxLabs` If false, don't show the "Firefox Labs" section in Preferences. (Firefox 130.0.1)
-Note: Firefox Labs is now controlled by Nimbus, our testing platform, so disabling telemetry also disables Firefox Labs.
-
`Locked` prevents the user from changing user messaging preferences.
**Compatibility:** Firefox 75, Firefox ESR 68.7\