ExtensionInstallForcelist

Задать список расширений, устанавливаемых принудительно

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

Политика задает список расширений, которые устанавливаются принудительно без участия пользователей.

Пользователи не могут удалить или отключить принудительно установленные расширения. Также расширение можно установить в закрытом контуре по инструкции.

Значок	Описание
	На Windows и macOS работает, только если задана внутри домена или через Консоль управления.

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

Политика не действует в режиме Инкогнито. Чтобы отключить режим Инкогнито, используйте политику IncognitoModeAvailability.
После включения политики предоставляются разрешения для API расширений enterprise.deviceAttributes и enterprise.platformKeys. Эти API недоступны для расширений, которые не установлены принудительно.
Политика имеет приоритет над политикой ExtensionInstallBlocklist. Если убрать принудительно установленное расширение из списка политики ExtensionInstallForcelist, Яндекс Браузер автоматически удалит его, если оно есть в списке политики ExtensionInstallBlocklist.
Если политика DeveloperToolsAvailability разрешает использовать инструменты разработчика, то пользователи могут менять код принудительно установленных расширений. Это может привести к сбоям работы Браузера.
Расширения устанавливаются по заданному в политике URL'у.
- Если URL не задан, по умолчанию используется URL интернет-магазина Chrome https://clients2.google.com/service/update2/crx.
- Если расширение размещено в интернет-магазине Opera, укажите https://extension-updates.opera.com/api/omaha/update/.
- Можно использовать XML-файл. Поддерживаются локальные и сетевые пути.
Для всех последующих обновлений расширения будет использоваться URL, заданный в манифесте расширения.
В каждой строке, задаваемой в политике, указывается идентификатор расширения и может содержаться URL для установки расширения (может быть указан путь до .crx файла), отделенный точкой с запятой. Пример: extension_id1; update_url.

Атрибут	Описание
extension_id1	Идентификатор расширения
update_url	URL обновления

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

Windows

Linux

macOS

Значение	Описание
Not Configured	Расширения не устанавливаются автоматически. Пользователи могут удалять любые расширения.
Disabled	Расширения не устанавливаются автоматически. Пользователи могут удалять любые расширения.
Enabled	Администратор задает список принудительно устанавливаемых расширений. Пользователи не могут удалить или отключить их. Можно настроить через файл. Пример значения: `mbniclmhobmnbdlbpiphghaielnnpgdp;https://example.com/update_url bfbmjmiodbnnpllbbbfblcplfjjepjdn`

Внимание

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

Значение

Описание

Нет

Расширения не устанавливаются автоматически.
Пользователи могут удалять любые расширения.

"ExtensionInstallForcelist": [
  "extension_id1;update_url",
  "extension_id2"
]

Администратор задает список принудительно устанавливаемых расширений.
Пользователи не могут удалить или отключить их.

Можно настроить через файл.

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

"ExtensionInstallForcelist": [
  "mbniclmhobmnbdlbpiphghaielnnpgdp;https://example.com/update_url",
  "bfbmjmiodbnnpllbbbfblcplfjjepjdn"
]

Значение

Описание

Нет

Расширения не устанавливаются автоматически.
Пользователи могут удалять любые расширения.

<key>ExtensionInstallForcelist</key>
<array>
  <string>extension_id1;update_url</string>
  <string>extension_id2</string>
</array>

Администратор задает список принудительно устанавливаемых расширений.
Пользователи не могут удалить или отключить их.

Можно настроить через файл.

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

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>PayloadContent</key>
    <array>
      <dict>
        <!-- Политика ExtensionInstallForcelist -->
        <key>ExtensionInstallForcelist</key>
        <array>
          <string>mbniclmhobmnbdlbpiphghaielnnpgdp;https://example.com/update_url</string>
          <string>bfbmjmiodbnnpllbbbfblcplfjjepjdn</string>
        </array>
        <!-- Общая информация для Yandex Browser -->
        <key>PayloadDisplayName</key>
        <string>Yandex Browser</string>
        <key>PayloadIdentifier</key>
        <string>ru.yandex.desktop.yandex-browser.3F648CA7-3F3B-468A-BB93-C3EF6D99EBB8</string>
        <key>PayloadType</key>
        <string>ru.yandex.desktop.yandex-browser</string>
        <key>PayloadUUID</key>
        <string>3F648CA7-3F3B-468A-BB93-C3EF6D99EBB8</string>
        <key>PayloadVersion</key>
        <integer>1</integer>
      </dict>
    </array>
    <key>PayloadDescription</key>
    <string>Test policy for Yandex Browser</string>
    <key>PayloadDisplayName</key>
    <string>Yandex.Browser</string>
    <key>PayloadIdentifier</key>
    <string>test.yandex.browser</string>
    <key>PayloadScope</key>
    <string>User</string>
    <key>PayloadType</key>
    <string>Configuration</string>
    <key>PayloadUUID</key>
    <string>D3E1F0C5-4231-4D18-BB40-9DC7134CD6EB</string>
    <key>PayloadVersion</key>
    <integer>1</integer>
    <key>TargetDeviceType</key>
    <integer>5</integer>
  </dict>
</plist>