Подробное руководство по настройке расширений с помощью политики ExtensionSettings

Microsoft Edge предлагает несколько способов управления расширениями. Распространенным способом является настройка нескольких политик в одном месте с помощью строки JSON в редакторе групповой политики Windows или в реестре Windows, используя политикуExtensionSettings.

Перед началом работы

Решите, хотите ли вы задать все параметры управления расширениями в политике ExtensionSettings или задать эти элементы управления с помощью других политик.

Политика ExtensionSettings может заменять другие политики, которые были установлены в других частях групповой политики, включая следующие:

• ExtensionAllowedTypes
• ExtensionInstallBlocklist
• ExtensionInstallForcelist
• ExtensionInstallSources
• ExtensionInstallAllowlist

Поля политики ExtensionSettings

Эта политика может управлять такими параметрами, как ОБНОВЛЕНИЕ URL-адреса, из которого загружается расширение для начальной установки, и Заблокированные разрешения. Вы также можете использовать эту политику, чтобы определить, какие разрешения не разрешены для запуска. Доступные поля политик описаны в следующей таблице.

В глобальной области (*) разрешены следующие ключи:

• blocked_permissions
• installation_mode — только "blocked", "allowed"или "removed" являются допустимыми значениями в этой области.
• runtime_blocked_hosts
• blocked_install_message
• allowed_types
• runtime_allowed_hosts
• install_sources

Следующие ключи разрешены в отдельной области расширения:

• blocked_permissions
• minimum_version_required
• blocked_install_message
• installation_mode — "blocked", "allowed", "removed"и "force_installed""normal_installed" — возможные значения.
• runtime_allowed_hosts
• update_url
• override_update_url
• runtime_blocked_hosts
• toolbar_state
• sidebar_auto_open_blocked

В области обновления URL-адреса разрешены следующие ключи:

• blocked_permissions
• installation_mode — только "blocked", "allowed"или "removed" являются допустимыми значениями в этой области.

Настройка строки JSON в редакторе групповой политики Windows

При использовании политики параметров расширения с помощью GPO предполагается, что вы уже импортировали ADM/ADMX для политик Microsoft Edge.

1. Откройте редактор групповой политики и перейдите в раздел Расширения > Microsoft Edge > Настройка политики управления расширениями.
2. Включите политику и введите ее компактные данные нотации объектов JavaScript (JSON) в текстовое поле в виде одной строки без разрывов строк.
3. Чтобы проверить политику и сжать ее до одной строки, используйте средство сжатия JSON.

Правильное форматирование JSON для политики параметров расширения

Необходимо понимать две части этой политики: область по умолчанию и отдельную область. Область по умолчанию охватывает все расширения без их собственных областей. Индивидуальная область применяется только к данному расширению.

Область по умолчанию отмечена звездочкой (*). В следующем примере определяется область по умолчанию и индивидуальная область расширения.

{ 
   "*": {}, 
   "nckgahadagoaajjgafhacjanaoiihapd": {} 
} 

Расширение получит параметры только одной из областей. Если для этого расширения есть отдельная область расширения, это будут параметры, которые применяются к нему. Если не существует отдельной области расширения, то расширение будет использовать область по умолчанию.

Следующий образец JSON запрещает любому расширению запуск .example.com, а также блокирует любое расширение, требующее разрешения "USB".

{ 
  "*": { 
    "runtime_blocked_hosts": ["*://*.example.com"], 
    "blocked_permissions": ["usb"] 
  } 
} 

Сжатая JSON

{"*":{"runtime_blocked_hosts":["*://*.example.com"],"blocked_permissions":["usb"]}} 

Еще несколько примеров JSON для параметров расширения

Использование свойства installation_mode для разрешения и блокировки расширений

• Пользователь может установить все расширения — параметр по умолчанию

  { "*": {"installation_mode": "allowed" }}

• Пользователь не может установить расширения.

  { "*": {"installation_mode": "blocked" }}

• Укажите пользовательское сообщение, которое будет отображаться при блокировке установки.

  {"*": {"blocked_install_message": ["Call IT(408 - 555 - 1234) for an exception"]}}

Использование свойства installation_mode для принудительной установки расширений

При использовании свойства installation_mode как "force_installed" расширение автоматически устанавливается без взаимодействия с пользователем. Пользователь не может отключить или удалить расширение. Если расширение установлено как "normal" или "force", поле update_ur тоже должно быть заполнено. Это поле указывает, откуда можно установить расширение. Используйте следующие расположения для поля update_url:

• Если скачиваемое расширение размещено в хранилище надстроек Microsoft Edge, используйте расположение в следующем примере JSON:

  {"nckgahadaanghapdoaajjgafhacjaoii": {"installation_mode": "force_installed","update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"}}

• Если скачиваемое расширение размещено в Веб-магазине Chrome, используйте расположение в следующем примере JSON:

  {"nckgiihapdoaajjgafhacjgahadaanao": {"installation_mode": "force_installed","update_url": "https://clients2.google.com/service/update2/crx"}}

• Если вы размещаете расширение на собственном сервере, используйте URL-адрес, по которому Microsoft Edge может скачать упакованную версию расширения (.crx файл). Пример JSON

  {"nckgahadagoaajjgafhacjanaoiihapd": {"installation_mode": "force_installed","update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"}}

В предыдущем примере, если вместо "force_installed" вы используете "normal_installed", расширение автоматически устанавливается без участия пользователя, но оно может отключить его.

Настройка с помощью реестра Windows

Политика ExtensionSettings должна быть записана в этот раздел реестра:

HKLM\Software\Policies\Microsoft\Edge\

Для Microsoft Edge все параметры будут запускаться в этом разделе:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\

Следующий ключ, который вы создадите, — это идентификатор расширения для отдельной области или звездочка (*) для области по умолчанию. Например, вы используете следующее расположение в реестре для параметров, которые применяются к Google Hangouts:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\nckgahadagoaajjgafhacjanaoiihapd

Для параметров, которые применяются к области по умолчанию (звездочка), используйте следующее расположение в реестре:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Edge\ExtensionSettings\*

Для разных параметров требуются разные форматы в зависимости от того, является ли они строкой или массивом строк. Значения массива требуют формата [＂значение＂]. Строки могут быть введены без изменений. В следующем списке показано, какие параметры являются массивами или строками:

• nstallation_mode = Строка
• update_url = Строка
• blocked_permissions = Массив строк
• allowed_permissions = Массив строк
• minimum_version_required = Строка
• runtime_blocked_hosts = Массив строк
• runtime_allowed_hosts = Массив строк
• blocked_install_message = Строка

См. также

• Управление расширениями Microsoft Edge на предприятии
• Использование групповых политик для управления расширениями Microsoft Edge
• Вопросы и ответы по расширениям Microsoft Edge
• Целевая страница Microsoft Edge Enterprise