Add README, Add heading for dropdowns, cleanup tabs

[policy-templates.git] / README.md

diff --git a/README.md b/README.md
index 6aa956819198d5dda8450c9751de67e64b81f60a..13db59a5381463a6e96152021a0e676e8b8060c0 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,2 +1,283 @@
-# policy-templates
-Policy Templates for Firefox
+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.
+
+### 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.
+
+```
+{
+  "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]
+  }
+}
+```