X-Git-Url: https://git.p6c8.net/policy-templates.git/blobdiff_plain/899349bb2c5f3e6905c667b4832c955c6c7c5cb8..3f7ce24b189945144ac9a671a422ce4ceb9468e9:/README-new.md?ds=inline diff --git a/README-new.md b/README-new.md index 7f3adda..b49ef8b 100644 --- a/README-new.md +++ b/README-new.md @@ -644,6 +644,79 @@ This policy blocks websites from being visited. The parameters take an array of ### Search Engines (This policy is only available on the ESR.) This policy allows you to add new search engines, remove or hide search engines, as well as set the default and prevent the install of search engines from web pages. Only Name and URLTemplate is required. ``` +{ + "policies": { + "SearchEngines": { + "Default": "Name of engine", + "PreventInstalls": [true|false], + "Remove": ["Twitter", "Wikipedia (en)"] + } + } +} +``` +### Search Engines + +### Search Engines | Add + +This policy allows you to add up to five new search engines. This policy is only available on the ESR. + +**Compatibility:** Firefox ESR 60\ +**CCK2 Equivalent:** `config.searchplugins`\ +**Preferences Affected:** N/A + +### Keys + +| Key | Type | Default | Description | +| --- | ---- | ------- | ----------- | +| `Name` | String | _required_ | The name of the search engine. | +| `URLTemplate` | String | _required_ | Search URL with {searchTerms} to substitute for the search term. | +| `Method` | String | GET | GET or POST | +| `IconURL` | String | — | URL for the icon to use. | +| `Alias` | String | — | Keyword to use for the engine. | +| `Description` | String | —| Description of the search engine. | +| `SuggestURLTemplate` | String | — | Search suggestions URL with {searchTerms} to substitute for the search term. | + +#### Windows +| Type | Registry Location | +| ---- | ----------------- | +| `Windows:REG_SZ` | `Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Name` | +| `Windows:REG_SZ` | `Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\URLTemplate` | +| `Windows:REG_SZ` | `Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Method` | +| `Windows:REG_SZ` | `Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\IconURL` | +| `Windows:REG_SZ` | `Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Alias` | +| `Windows:REG_SZ` | `Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\Description` | +| `Windows:REG_SZ` | `Software\Policies\Mozilla\Firefox\SearchEngines\Add\1\SuggestURLTemplate` | + +#### macOS +``` + + Search + + Add + + + Name + Example1 + URLTemplate + https://www.example.org + Method + https://www.example.org/favicon.ico + IconURL + toolbar + Alias + Example1Folder + Description + Example1Folder + Alias + SuggestURLTemplate + + + + +``` + +### JSON +``` { "policies": { "SearchEngines": { @@ -657,14 +730,15 @@ This policy allows you to add new search engines, remove or hide search engines, "Description": "Description", "SuggestURLTemplate": "URL for suggestions using {searchTerms}" } - ], - "Default": "Name of engine", - "PreventInstalls": [true|false], - "Remove": ["Twitter", "Wikipedia (en)"] + ] } } } ``` + + + + ### SecurityDevices A dictionary with the names and locations of PKCS #11 modules to be installed.