README.md

   1 Policies can either be specified using the GPO templates or by putting a file called policies.json in the distribution directory.
   2 The content of the JSON file should look like this:
   3 ```
   4 {
   5   "policies": {
   6     ...POLICIES...
   7 }
   8 ```
   9 Policies are documented below.
  10
  11 ### BlockAboutAddons
  12 This policy removes access to about:addons.
  13 ```
  14 {
  15   "policies": {
  16     "BlockAboutAddons": true
  17 }
  18 ```
  19 ### BlockAboutConfig
  20 This policy removes access to about:config.
  21 ```
  22 {
  23   "policies": {
  24     "BlockAboutConfig": true
  25 }
  26 ```
  27 ### BlockAboutSupport
  28 This policy removes access to about:support.
  29 ```
  30 {
  31   "policies": {
  32     "BlockAboutSupport": true
  33 }
  34 ```
  35 ### BlockSetDesktopBackground
  36 This policy removes the "Set As Desktop Background..." menuitem when right clicking on an image.
  37 ```
  38 {
  39   "policies": {
  40     "BlockAboutSupport": true
  41   }
  42 }
  43 ```
  44 ### CreateMasterPassword
  45 This policy removes the master password functionality.
  46 ```
  47 {
  48   "policies": {
  49     "CreateMasterPassword": false
  50   }
  51 }
  52 ```
  53 ### DisableAppUpdate
  54 This policy turns off application updates.
  55 ```
  56 {
  57   "policies": {
  58     "DisableAppUpdate": true
  59   }
  60 }
  61 ```
  62 ### DisableDeveloperTools
  63 This policy removes access to all developer tools.
  64 ```
  65 {
  66   "policies": {
  67     "DisableDeveloperTools": true
  68   }
  69 }
  70 ```
  71 ### DisableDeveloperTools
  72 This policy removes access to all developer tools.
  73 ```
  74 {
  75   "policies": {
  76     "DisableDeveloperTools": true
  77   }
  78 }
  79 ```
  80 ### DisableFirefoxScreenshots
  81 This policy removes access to Firefox Screenshots
  82 ```
  83 {
  84   "policies": {
  85     "DisableFirefoxScreenshots": true
  86   }
  87 }
  88 ```
  89 ### DisableFirefoxAccounts
  90 This policy disables Sync
  91 ```
  92 {
  93   "policies": {
  94     "DisableFirefoxAccounts": true
  95   }
  96 }
  97 ```
  98 ### DisableFirefoxStudies
  99 This policy disables Firefox studies (Shield)
 100 ```
 101 {
 102   "policies": {
 103     "DisableFirefoxAccounts": true
 104   }
 105 }
 106 ```
 107 ### DisableFormHistory
 108 This policy turns off the browser.formfill.enable preferences
 109 ```
 110 {
 111   "policies": {
 112     "DisableFormHistory": true
 113   }
 114 }
 115 ```
 116 ### DisablePocket
 117 This policy turns off Pocket
 118 ```
 119 {
 120   "policies": {
 121     "DisablePocket": true
 122   }
 123 }
 124 ```
 125 ### DisablePrivateBrowsing
 126 This policy removes access to private browsing
 127 ```
 128 {
 129   "policies": {
 130     "DisablePrivateBrowsing": true
 131   }
 132 }
 133 ```
 134 ### DisplayBookmarksToolbar
 135 This policy turns on the bookmarks toolbar by default. A user can still turn it off and it will stay off.
 136 ```
 137 {
 138   "policies": {
 139     "DisplayBookmarksToolbar": true
 140   }
 141 }
 142 ```
 143 ### DisplayMenuBar
 144 This policy turns on the menubar by default. A user can still turn it off and it will stay off.
 145 ```
 146 {
 147   "policies": {
 148     "DisplayMenuBar": true
 149   }
 150 }
 151 ```
 152 ### DontCheckDefaultBrowser
 153 This policy stops Firefox from checking if it is the default browser at startup.
 154 ```
 155 {
 156   "policies": {
 157     "DontCheckDefaultBrowser": true
 158   }
 159 }
 160 ```
 161 ### RememberPasswords
 162 This policy sets the signon.rememberSignons preference. It can either be enabled or disabled.
 163 ```
 164 {
 165   "policies": {
 166     "RememberPasswords": true
 167   }
 168 }
 169 ```
 170 ### Homepage
 171 This policy sets the default homepage value. It can also be used to lock the homepage and add additional homepages.
 172 ```
 173 {
 174   "policies": {
 175     "Homepage": {
 176       "URL": "http://example.com/",
 177       "Locked": true,
 178       "Additional": ["http://example.org/",
 179                      "http://example.edu/"]
 180     }
 181   }
 182 }
 183 ```
 184 ### Popups
 185 This policy sets domains for which popups are allowed
 186 ```
 187 {
 188   "policies": {
 189     "Popups": {
 190       "Allow": ["http://example.org/",
 191                 "http://example.edu/"]
 192     }
 193   }
 194 }
 195 ```
 196 ### InstallAddons
 197 This policy sets domains that can install extensions
 198 ```
 199 {
 200   "policies": {
 201     "InstallAddons": {
 202       "Allow": ["http://example.org/",
 203                 "http://example.edu/"]
 204     }
 205   }
 206 }
 207 ```
 208 ### Cookies
 209 This policy sets domains that can set or not set cookies.
 210 ```
 211 {
 212   "policies": {
 213     "Cookies": {
 214       "Allow": ["http://example.org/"],
 215       "Block": ["http://example.edu/"]
 216     }
 217   }
 218 }
 219 ```
 220 ### FlashPlugin
 221 This policy sets domains that can use or not use Flash
 222 ```
 223 {
 224   "policies": {
 225     "FlashPlugin": {
 226       "Allow": ["http://example.org/"],
 227       "Block": ["http://example.edu/"]
 228     }
 229   }
 230 }
 231 ```
 232 ### Bookmarks
 233 This policy allows you to specify bookmarks. You can have any number of bookmarks although only ten are specified in the ADMX file.
 234 Placement can be specified as either toolbar or menu. If a folder is specified, it is automatically created and bookmarks with the
 235 same folder name are grouped together.
 236
 237 ```
 238 {
 239   "policies": {
 240     "Bookmarks": [
 241     {"Title": "Example",
 242      "URL": "http://example.org",
 243      "Favicon": "http://example.com/favicon.ico",
 244      "Placement": "toolbar",
 245      "Folder": "Bookmarks"
 246      }
 247     ]
 248   }
 249 }
 250 ```