YandexPolicyInFileConfig

Задать частоту перечитывания конфигурационных файлов со значениями политик

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

Политика задает частоту перечитывания конфигурационных файлов со значениями политик. Можно указать, как часто перечитывать файлы при удачной и неудачной попытке.

Формат значений:

• для объектов (DICT) — нужно указывать путь как поле: "_FILE_": {"name": "путь_к_файлу"}
• для объектов типа массив (LIST) — нужно указывать путь как объект: [ {"_FILE_": {"name": "путь_к_файлу"} } ]

Файлы со значениями политик могут быть доступны:

• локально (например, C:/folder/file.txt);
• через сетевую папку (например, //computer/file.txt);
• по URL'у (например, http://192.168.0.1/file.txt).

Примеры значений политик:

• Для объекта: пусть политика имеет строковое значение в редакторе политик (в реестре) в виде { "extension": { "id": "12345" , … }, … }. Чтобы заменить значение файлом, нужно в редакторе политик (или реестре) заменить это значение на { "_FILE_": { "name": "путь_к_файлу" } }. Сам файл должен существовать по указанному пути и содержать значение { "extension": { "id": "12345" , … }, … }.
• Для объекта типа массив: пусть политика URLBlocklist имеет значение в редакторе политик (реестре) в виде ["example.com"]. Чтобы заменить значение конфигурационным файлом, нужно создать файл, например C:\broconfigs\policy.txt и записать в него значение ["example.com"]. Тогда в самой политике можно указать путь к файлу в виде [{"_FILE_": {"name":"C:\\broconfigs\\policy.txt"}}].

В файле можно использовать пробелы, табуляцию, переводы строк для лучшей читаемости, но вложенных файлов быть не должно.

Правила указания путей к файлам:

• на Linux и macOS в пути нужно использовать unix-слеш, например "/home/user/broconfigs/test.json";
• на Windows можно использовать любой слеш, но обратный слеш в windows-пути должен быть экранирован, например, можно указать "c:\\broconfigs\\test.json" или "c:/broconfigs/test.json".

В расширенной версии Браузера для организаций при успешном или неуспешном чтении файлов отправляется событие безопасности FileInPolicy, которое содержит md5-хеш файла и путь к файлу.

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

{
  "refresh": 120,
  "retry": 2
}

"YandexPolicyInFileConfig": {
  "refresh": time,
  "retry": time
}

"YandexPolicyInFileConfig": {
  "refresh": 120,
  "retry": 2
}

<key>YandexPolicyInFileConfig</key>
<dict>
  <key>refresh</key>
  <integer>time</integer>
  <key>retry</key>
  <integer>time</integer>
</dict>

<?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>
        <!-- Политика YandexPolicyInFileConfig -->
        <key>YandexPolicyInFileConfig</key>
        <dict>
          <key>refresh</key>
          <integer>120</integer>
          <key>retry</key>
          <integer>2</integer>
        </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>

Полезные ссылки

Промостраница Яндекс Браузера для организаций