ExtensionSettings

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

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

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

Значок Описание

На Windows и macOS работает только внутри домена.

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

Значение Описание
Not Configured

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

Disabled
Enabled

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

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

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

{
  "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
  },
  "*": {
    "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.

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

Поле Описание
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. С его помощью расширение проверяется на доверие.

Как посмотреть идентификаторы расширений

  1. Откройте в Браузере страницу browser://extensions.
  2. В правом верхнем углу включите опцию Режим разработчика.
  3. Под расширением нажмите Сведения.
  4. Идентификатор указан в одноименном поле.