X-Git-Url: https://git.p6c8.net/policy-templates.git/blobdiff_plain/943c5430edff37a11e7091f4fb2ee7b1f4838948..43a3469845cf1d5fde2a6ea372d8781909a4829b:/README.md diff --git a/README.md b/README.md index 34d0bf5..07e144a 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,5 @@ -Policies can either be specified using the GPO templates or by putting a file called policies.json in the distribution directory. +Policies can either be specified using the Group Policy templates or by creating a file called policies.json. On Windows, create a directory called distribution where the EXE is located and place the file there. On Mac, the file goes into Firefox.app/Content/Resources/distribution. + The content of the JSON file should look like this: ``` { @@ -8,7 +9,19 @@ The content of the JSON file should look like this: } ``` Policies are documented below. - +### Authentication +This policy is for configuring sites that support integrated authentication. See https://developer.mozilla.org/en-US/docs/Mozilla/Integrated_authentication for more information. +``` +{ + "policies": { + "Authentication": { + "SPNEGO": ["mydomain.com", "https://myotherdomain.com"], + "Delegated": ["mydomain.com", "https://myotherdomain.com"], + "NTLM": ["mydomain.com", "https://myotherdomain.com"] + } + } +} +``` ### BlockAboutAddons This policy removes access to about:addons. ``` @@ -27,6 +40,15 @@ This policy removes access to about:config. } } ``` +### BlockAboutProfiles +This policy removes access to about:profiles. +``` +{ + "policies": { + "BlockAboutProfiles": true + } +} +``` ### BlockAboutSupport This policy removes access to about:support. ``` @@ -44,6 +66,17 @@ This policy removes the "Set As Desktop Background..." menuitem when right click } } ``` +### Certificates +This is a Windows only policy that tells Firefox to read certificates from the Windows certificate store. +``` +{ + "policies": { + "Certificates": { + "ImportEnterpriseRoots": [true|false] + } + } +} +``` ### CreateMasterPassword This policy removes the master password functionality. ``` @@ -203,6 +236,13 @@ If Value is set to true, private browsing is enabled by default in both the brow "Value": [true, false], "Locked": [true, false] } +``` +### NoDefaultBookmarks +Don't create the default bookmarks or the Smart Bookmarks (Most Visited, Recent Tags). Note: this policy is only effective if used before the first run of the profile. +``` +{ + "policies": { + "NoDefaultBookmarks": true } } ``` @@ -289,10 +329,31 @@ same folder name are grouped together. {"Title": "Example", "URL": "http://example.org", "Favicon": "http://example.com/favicon.ico", - "Placement": "toolbar", - "Folder": "Bookmarks" + "Placement": ["toolbar", "menu"], + "Folder": "FolderName" } ] } } ``` +### 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 hostnames 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] + "HTTPProxy": "hostname", + "UseHTTPProxyForAllProtocols": [true, false] + "SSLProxy": "hostname", + "FTPProxy": "hostname", + "SOCKSProxy": "hostname", + "SOCKSVersion": [4, 5], + "Passthrough": "List of passthrough addresses/domains", + "AutoConfigURL": "URL_TO_AUTOCONFIG", + "AutoLogin": [true, false], + "UseProxyForDNS": [true, false] + } +} +```