X-Git-Url: https://git.p6c8.net/policy-templates.git/blobdiff_plain/2cde024a39d0df54fb441d1a33ca433b9158aa29..d056a62629daa23795ceb68917eab38a922d271e:/README.md?ds=sidebyside diff --git a/README.md b/README.md index 13db59a..2bb261e 100644 --- a/README.md +++ b/README.md @@ -1,283 +1,5 @@ -Policies can either be specified using the GPO templates or by putting a file called policies.json in the distribution directory. -The content of the JSON file should look like this: -``` -{ - "policies": { - ...POLICIES... - } -} -``` -Policies are documented below. +**These policies are in active development and so might contain changes that do not work with current versions of Firefox.** -### BlockAboutAddons -This policy removes access to about:addons. -``` -{ - "policies": { - "BlockAboutAddons": true - } -} -``` -### BlockAboutConfig -This policy removes access to about:config. -``` -{ - "policies": { - "BlockAboutConfig": true - } -} -``` -### BlockAboutSupport -This policy removes access to about:support. -``` -{ - "policies": { - "BlockAboutSupport": true -} -``` -### BlockSetDesktopBackground -This policy removes the "Set As Desktop Background..." menuitem when right clicking on an image. -``` -{ - "policies": { - "BlockAboutSupport": true - } -} -``` -### CreateMasterPassword -This policy removes the master password functionality. -``` -{ - "policies": { - "CreateMasterPassword": false - } -} -``` -### DisableAppUpdate -This policy turns off application updates. -``` -{ - "policies": { - "DisableAppUpdate": true - } -} -``` -### DisableDeveloperTools -This policy removes access to all developer tools. -``` -{ - "policies": { - "DisableDeveloperTools": true - } -} -``` -### DisableDeveloperTools -This policy removes access to all developer tools. -``` -{ - "policies": { - "DisableDeveloperTools": true - } -} -``` -### DisableFirefoxScreenshots -This policy removes access to Firefox Screenshots -``` -{ - "policies": { - "DisableFirefoxScreenshots": true - } -} -``` -### DisableFirefoxAccounts -This policy disables Sync -``` -{ - "policies": { - "DisableFirefoxAccounts": true - } -} -``` -### DisableFirefoxStudies -This policy disables Firefox studies (Shield) -``` -{ - "policies": { - "DisableFirefoxAccounts": true - } -} -``` -### DisableFormHistory -This policy turns off the browser.formfill.enable preferences -``` -{ - "policies": { - "DisableFormHistory": true - } -} -``` -### DisablePocket -This policy turns off Pocket -``` -{ - "policies": { - "DisablePocket": true - } -} -``` -### DisablePrivateBrowsing -This policy removes access to private browsing -``` -{ - "policies": { - "DisablePrivateBrowsing": true - } -} -``` -### DisableSysAddonUpdate -This policy prevents system add-ons from being updated or installed. -``` -{ - "policies": { - "DisableSysAddonUpdate": true - } -} -``` -### DisplayBookmarksToolbar -This policy turns on the bookmarks toolbar by default. A user can still turn it off and it will stay off. -``` -{ - "policies": { - "DisplayBookmarksToolbar": true - } -} -``` -### DisplayMenuBar -This policy turns on the menubar by default. A user can still turn it off and it will stay off. -``` -{ - "policies": { - "DisplayMenuBar": true - } -} -``` -### DontCheckDefaultBrowser -This policy stops Firefox from checking if it is the default browser at startup. -``` -{ - "policies": { - "DontCheckDefaultBrowser": true - } -} -``` -### RememberPasswords -This policy sets the signon.rememberSignons preference. It can either be enabled or disabled. -``` -{ - "policies": { - "RememberPasswords": true - } -} -``` -### Homepage -This policy sets the default homepage value. It can also be used to lock the homepage and add additional homepages. -``` -{ - "policies": { - "Homepage": { - "URL": "http://example.com/", - "Locked": true, - "Additional": ["http://example.org/", - "http://example.edu/"] - } - } -} -``` -### Popups -This policy sets domains for which popups are allowed -``` -{ - "policies": { - "Popups": { - "Allow": ["http://example.org/", - "http://example.edu/"] - } - } -} -``` -### InstallAddons -This policy sets domains that can install extensions -``` -{ - "policies": { - "InstallAddons": { - "Allow": ["http://example.org/", - "http://example.edu/"] - } - } -} -``` -### Cookies -This policy sets domains that can set or not set cookies. -``` -{ - "policies": { - "Cookies": { - "Allow": ["http://example.org/"], - "Block": ["http://example.edu/"] - } - } -} -``` -### FlashPlugin -This policy sets domains that can use or not use Flash -``` -{ - "policies": { - "FlashPlugin": { - "Allow": ["http://example.org/"], - "Block": ["http://example.edu/"] - } - } -} -``` -### Bookmarks -This policy allows you to specify bookmarks. You can have any number of bookmarks although only ten are specified in the ADMX file. -Placement can be specified as either toolbar or menu. If a folder is specified, it is automatically created and bookmarks with the -same folder name are grouped together. +**You should use the [officially released versions](https://github.com/mozilla/policy-templates/releases) if you are deploying changes.** -``` -{ - "policies": { - "Bookmarks": [ - {"Title": "Example", - "URL": "http://example.org", - "Favicon": "http://example.com/favicon.ico", - "Placement": "toolbar", - "Folder": "Bookmarks" - } - ] - } -} -``` -### Proxy -This policy allows you to specify proxy settings. These settings correspond to the connection settings in Firefox preferences. -To specify ports, append them to the URLs with a colon (:). If Locked is set to true, the values can't be changed by the user. -``` -{ - "Proxy": { - "Mode": ["none", "system", "manual", "autoDetect", "autoConfig"] - "Locked": [true, false] -Z "HTTPProxy": "URL_TO_PROXY", - "UseHTTPProxyForAllProtocols": [true, false] - "SSLProxy": "URL_TO_PROXY", - "FTPProxy": "URL_TO_PROXY", - "SOCKSProxy": { "URL_TO_PROXY", - "SOCKSVersion": [4, 5], - "Passthrough": "List of passthrough addresses/domains", - "AutoConfigURL": "URL_TO_AUTOCONFIG", - "AutoLogin": [true, false], - "UseProxyForDNS": [true, false] - } -} -``` +Official policy documentation has been moved to https://mozilla.github.io/policy-templates/. \ No newline at end of file