ExtensionSettings

Управлять настройками расширений

Описание политики

Политика управляет настройками расширений в Яндекс Браузере.

Заменяет любые другие политики по настройке расширений.

Значок	Описание
	Относится к базовому уровню безопасности.
	Доступна в мобильной версии Браузера для организаций.

Значения политики

Windows

Linux

Значение

Описание

Not Configured
Disabled

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

Enabled

Настройки расширений задает администратор с помощью кода, указанного в параметрах политики.

Идентификатор расширения или URL обновления привязывается только к одной конкретной настройке.
Подстановочный знак * действует на все расширения, для которых в политике не задана отдельная конфигурация.
Если указан URL обновления, заданная конфигурация применяется ко всем расширениям, в манифесте которых приведен этот URL.
Если для параметра override_update_url задано значение True, расширение будет установлено и обновлено с помощью URL'а обновления, указанного в политике ExtensionInstallForcelist или в поле update_url политики ExtensionSettings. Если задано значение False, то для обновления будет использоваться URL из манифеста расширения.

Примечание

В редакторе локальной групповой политики и редакторе реестра можно задавать только однострочные значения.

Чтобы переводить многострочные значения в одну строку, используйте JSON Beautifier. Слева на странице вставьте значение и нажмите Minify.

Пример значения:

{
 "abcdefghijklmnopabcdefghijklmnop": {
   "installation_mode": "allowed",
   "blocked_permissions": [
     "history"
   ],
   "minimum_version_required": "1.0.1",
   "toolbar_pin": "force_pinned"
 },
 "bcdefghijklmnopabcdefghijklmnopa": {
   "installation_mode": "force_installed",
   "update_url": "https://example.com/update_url",
   "allowed_permissions": [
     "downloads"
   ],
   "runtime_blocked_hosts": [
     "*://*.example.com"
   ],
   "runtime_allowed_hosts": [
     "*://good.example.com"
   ]
 },
 "cdefghijklmnopabcdefghijklmnopab": {
   "installation_mode": "blocked",
   "blocked_install_message": "Custom error message."
 },
 "defghijklmnopabcdefghijklmnopabc,efghijklmnopabcdefghijklmnopabcd": {
   "installation_mode": "blocked",
   "blocked_install_message": "Custom error message."
 },
 "update_url:https://www.example.com/update.xml": {
   "blocked_permissions": [
     "wallpaper"
   ],
   "allowed_permissions": [
     "downloads"
   ],
   "installation_mode": "allowed"
 },
 "fghijklmnopabcdefghijklmnopabcde": {
   "installation_mode": "removed",
   "blocked_install_message": "Custom removal message."
 },
 "ghijklmnopabcdefghijklmnopabcdef": {
   "installation_mode": "force_installed",
   "update_url": "https://example.com/update_url",
   "override_update_url": true
 },
 "ldnnhddmnhbkjipkidpdiheffobcpfmf": {
   "installation_mode": "force_installed",
   "update_url": "file://example/update.xml"
 },
 "*": {
   "installation_mode": "blocked",
   "blocked_permissions": [
     "downloads",
     "bookmarks"
   ],
   "install_sources": [
     "https://company-intranet/addons.opera.com"
   ],
   "allowed_types": [
     "hosted_app"
   ],
   "runtime_blocked_hosts": [
     "*://*.example.com"
   ],
   "runtime_allowed_hosts": [
     "*://good.example.com"
   ],
   "blocked_install_message": "Custom error message."
 }
}

Внимание

По умолчанию установлено значение Not Configured.

Значение

Описание

Нет

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

"ExtensionSettings": {
 "*": {
  "installation_mode": "blocked",
  "blocked_install_message": "Custom error message."
 },
 "extension_id1, extension_id2": {
  "installation_mode": "allowed",
 "minimum_version_required": "version"
 }
}

Настройки расширений задает администратор с помощью кода, указанного в параметрах политики.

Идентификатор расширения или URL обновления привязывается только к одной конкретной настройке.
Подстановочный знак * действует на все расширения, для которых в политике не задана отдельная конфигурация.
Если указан URL обновления, заданная конфигурация применяется ко всем расширениям, в манифесте которых приведен этот URL.
Если для параметра override_update_url задано значение True, расширение будет установлено и обновлено с помощью URL'а обновления, указанного в политике ExtensionInstallForcelist или в поле update_url политики ExtensionSettings. Если задано значение False, то для обновления будет использоваться URL из манифеста расширения.

Пример значения:

"ExtensionSettings": {
 "*": {
  "installation_mode": "blocked",
  "blocked_install_message": "Custom error message."
 },
 "bcdefghijklmnopabcdefghijklmnopa": {
  "installation_mode": "force_installed",
  "update_url": "https://example.com/update_url",
  "allowed_permissions": [
   "downloads"
  ],
  "runtime_blocked_hosts": [
   "*://*.example.com"
  ],
  "runtime_allowed_hosts": [
   "*://good.example.com"
  ]
 },
 "defghijklmnopabcdefghijklmnopabc,efghijklmnopabcdefghijklmnopabcd": {
  "installation_mode": "blocked",
  "blocked_install_message": "Custom error message."
 },
 "update_url:https://www.example.com/update.xml": {
  "blocked_permissions": [
   "wallpaper"
  ],
  "allowed_permissions": [
   "downloads"
  ],
  "installation_mode": "allowed"
 },
 "ghijklmnopabcdefghijklmnopabcdef": {
  "installation_mode": "force_installed",
  "update_url": "https://example.com/update_url",
  "override_update_url": true
 },
 "ldnnhddmnhbkjipkidpdiheffobcpfmf": {
   "installation_mode": "force_installed",
   "update_url": "file://example/update.xml"
 }
}

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

Поле	Описание
`allowed_types`	Примечание Используется только для настройки конфигурации по умолчанию со значением `*`. Задает типы приложений и расширений, которые пользователям разрешено устанавливать в Браузере: `extension` `hosted_app` `legacy_packaged_app` `platform_app` `theme` `user_script`
`blocked_install_message`	Создает специальное уведомление, которое будет появляться на устройствах пользователей при попытке установить запрещенные вами расширения. Администратор может добавить текст к типовому сообщению об ошибке, которое пользователи будут видеть в интернет-магазине Chrome. Например, можно указать, как связаться с администратором, или назвать причину, по которой установка запрещена. Длина сообщения не может превышать 1000 символов.
`blocked_permissions`	Запрещает пользователям устанавливать и запускать расширения, требующие разрешений API, которые не допускаются в вашей организации. Например, администратор может заблокировать расширения, которые осуществляют доступ к файлам cookie. Если расширению требуется разрешение, которое заблокировал администратор, пользователь не сможет его установить. Если пользователь установил это расширение ранее, оно больше не будет загружаться. Если расширение содержит заблокированное разрешение в качестве необязательного требования, оно будет установлено обычным образом. При запуске такого расширения заблокированные разрешения автоматически отклоняются. Список доступных разрешений указан в манифесте расширения.
`installation_mode`	Указывает, разрешено ли добавлять заданные вами расширения в Браузер и каким образом. Доступны следующие режимы: `allowed` — пользователи могут установить это расширение. Если не задан другой режим, этот вариант применяется по умолчанию. `blocked` — пользователи не могут установить это расширение. `removed` – пользователи не могут установить это расширение. Если пользователи установили это расширение ранее, оно будет удалено. `force_installed` — расширение устанавливается в браузеры пользователей автоматически. Пользователи не могут его удалить. В этом режиме необходимо указать ссылку для скачивания расширения (параметр `update_url`). `normal_installed` — расширение устанавливается в браузеры пользователей автоматически. Пользователи могут его отключить. В этом режиме необходимо указать ссылку для скачивания расширения (параметр `update_url`). Примечание В режимах `force_installed` и `normal_installed` нельзя использовать `*`, чтобы задать конфигурацию по умолчанию, так как Браузер не сможет определить, какое из расширений нужно установить автоматически.
`install_sources`	Примечание Используется только для настройки конфигурации по умолчанию со значением `*`. Содержит URL'ы страниц, с которых разрешено загружать и устанавливать расширения. Необходимо разрешить URL'ы расположения CRX-файла и страницы, с которой начинается скачивание (то есть URL перехода). Можно использовать шаблоны URL'ов.
`minimum_version_required`	Отключает расширения (в том числе установленные принудительно) более ранних версий, чем определено этим параметром. Формат строки версии аналогичен формату, который используется в манифесте расширения.
`override_update_url`	Указывает, что для всех последующих обновлений расширения будет использоваться URL из поля `update_url` или `update` в политике ExtensionInstallForcelist. Если это политика не настроена или отключена, будет использоваться URL из манифеста расширения.
`runtime_allowed_hosts`	Разрешает взаимодействие расширений с указанными сайтами, даже если они указаны в поле `runtime_blocked_hosts`. Можно указать до 100 сайтов. Записи сверх этого лимита игнорируются. Формат шаблона домена похож на шаблоны соответствия, однако в этом случае нельзя задать путь. Пример: `://.example.com`
`runtime_blocked_hosts`	Запрещает расширениям взаимодействовать с указанными сайтами или изменять их, в том числе вставлять скрипты, получать доступ к файлам cookie и изменять веб-запросы. Можно указать до 100 сайтов. Записи сверх этого лимита игнорируются. Формат шаблона домена похож на шаблоны соответствия, однако в этом случае нельзя задать путь. Пример: `://.example.com`
`toolbar_pin`	Определяет, закреплен ли значок расширения на панели инструментов. Доступны следующие режимы: `force_pinned` — значок расширения отображается на панели инструментов. Пользователи не могут скрыть его через меню расширений. `default_unpinned` — значок расширения скрыт. Пользователи могут закрепить его на панели инструментов через меню расширений. По умолчанию установлено значение `default_unpinned`.
`update_url`	Примечание Применяется только вместе с параметрами force_installed и normal_installed. Определяет, откуда скачивается расширение. Можно указать URL интернет-магазина Chrome, Opera или использовать XML-файл. Поддерживаются локальные и сетевые пути. Если расширение размещено в интернет-магазине Chrome, введите `https://clients2.google.com/service/update2/crx`. Если расширение размещено в интернет-магазине Opera, введите `https://extension-updates.opera.com/api/omaha/update/`. Браузер использует указанный URL, чтобы выполнить первичную установку расширения. Для всех последующих обновлений расширения будет использоваться URL, заданный в манифесте расширения.
`verified_contents_url`	Примечание Используется, если нет доступа в интернет. Указывает путь до файла `extension.verified_contents`. С его помощью расширение проверяется на доверие. Где взять verified_contents.json для компьютеров в закрытом контуре Установите любое расширение из магазина Opera на компьютере с доступом в интернет. В папке с расширениями (по умолчанию `%USERPROFILE%\AppData\Local\Yandex\YandexBrowser\User Data\Default\Extensions`) найдите папку расширения по идентификатору. В папке расширения скопируйте из папки `_metadata` файл `verified_contents.json` на компьютер в закрытом контуре.