ExtensionSettings

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

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

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

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

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

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

Windows

Linux

macOS

Android

Значение

Описание

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"
  }
}

Значение

Описание

Нет

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

<key>ExtensionSettings</key>
<dict>
  <key>*</key>
  <dict>
    <key>installation_mode</key>
    <string>blocked</string>
    <key>blocked_install_message</key>
    <string>Custom error message.</string>
  </dict>
  <key>extension_id1, extension_id2</key>
  <dict>
    <key>installation_mode</key>
    <string>allowed</string>
    <key>minimum_version_required</key>
    <string>version</string>
  </dict>
</dict>

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

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

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

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

<?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>
        <!-- Политика ExtensionSettings -->
        <key>ExtensionSettings</key>
        <dict>
          <key>*</key>
          <dict>
            <key>installation_mode</key>
            <string>blocked</string>
            <key>blocked_install_message</key>
            <string>Custom error message.</string>
          </dict>
          <key>bcdefghijklmnopabcdefghijklmnopa</key>
          <dict>
            <key>installation_mode</key>
            <string>force_installed</string>
            <key>update_url</key>
            <string>https://example.com/update_url</string>
            <key>allowed_permissions</key>
            <array>
              <string>downloads</string>
            </array>
            <key>runtime_blocked_hosts</key>
            <array>
              <string>*://*.example.com</string>
            </array>
            <key>runtime_allowed_hosts</key>
            <array>
              <string>*://good.example.com</string>
            </array>
          </dict>
          <key>defghijklmnopabcdefghijklmnopabc,efghijklmnopabcdefghijklmnopabcd</key>
          <dict>
            <key>installation_mode</key>
            <string>blocked</string>
            <key>blocked_install_message</key>
            <string> Custom error message.string>
          </dict>
          <key>update_url:https://www.example.com/update.xml</key>
          <dict>
            <key>blocked_permissions</key>
            <array>
              <string>wallpaper</string>
            </array>
            <key>allowed_permissions</key>
            <array>
              <string>downloads</string>
            </array>
            <key>installation_mode</key>
            <string>allowed</string>
          </dict>
          <key>ghijklmnopabcdefghijklmnopabcdef</key>
          <dict>
            <key>installation_mode</key>
            <string>force_installed</string>
            <key>update_url</key>
            <string>https://example.com/update_url</string>
            <key>override_update_url</key>
            <true/>
          </dict>
          <key>ldnnhddmnhbkjipkidpdiheffobcpfmf</key>
          <dict>
            <key>installation_mode</key>
            <string>force_installed</string>
            <key>update_url</key>
            <string>file://example/update.xml</string>
          </dict>
        </dict>
        <!-- Общая информация для 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>

Значение

Описание

Not Configured

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

{
  "*": {
    "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 из манифеста расширения.

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

{
  "*": {
    "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 сайтов. Записи сверх этого лимита игнорируются. Можно использовать ключевое слово `internal_urls`, чтобы обозначить все однодоменные сайты. Например, тогда `https://example` попадет под правило, а `https://example.com` — нет. Формат шаблона домена похож на шаблоны соответствия, однако в этом случае нельзя задать путь. Пример: `://.example.com`
`runtime_blocked_hosts`	Запрещает расширениям взаимодействовать с указанными сайтами или изменять их, в том числе вставлять скрипты, получать доступ к файлам cookie и изменять веб-запросы. Можно указать до 100 сайтов. Записи сверх этого лимита игнорируются. Можно использовать ключевое слово `internal_urls`, чтобы обозначить все однодоменные сайты. Например, тогда `https://example` попадет под правило, а `https://example.com` — нет. Формат шаблона домена похож на шаблоны соответствия, однако в этом случае нельзя задать путь. Пример: `://.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` на компьютер в закрытом контуре.