Создание задачи Удаленное выполнение скриптов

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

Инсталляционный пакет содержит ZIP-архив с набором скриптов для выполнения на клиентских устройствах, а также файл manifest.json. Подробнее о создании этого типа инсталляционного пакета см. статью.

Эту задачу нужно запускать только на устройствах с Агентом администрирования для Linux.

Чтобы запустить задачу Удаленное выполнение скриптов:

1. Перейдите в Мастер создания задачи и выберите тип задачи Удаленное выполнение скриптов.
2. Введите название задачи и выберите устройства, которым будет назначена задача. Нажмите на кнопку Далее.
3. Выберите инсталляционный пакет на основе ZIP-архива с файлом manifest.json для удаленного выполнения.

   Если вы не хотите повторно запускать задачу на устройствах, на которых она уже была выполнена, включите параметр Не запускать эту задачу на устройствах, на которых она уже была выполнена.

4. Выберите учетную запись для запуска задачи.

   Если вы выберете учетную запись по умолчанию, то задачу будет выполнять Агент администрирования (учетная запись root).

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

5. Если вы включите параметр Открыть окно свойств задачи после ее создания на странице Завершение создания задачи, вы сможете изменить установленные по умолчанию значения параметров задачи. Если вы не включите этот параметр, задача будет создана с установленными по умолчанию значениями параметров. Установленные по умолчанию значения параметров можно изменить позже в любое время.
6. Нажмите на кнопку Готово.

   Задача Удаленное выполнение скриптов создана и отображается в списке задач.

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

Создание инсталляционного пакета на основе манифест-файла

Чтобы создать инсталляционный пакета на основе манифест-файла:

1. Выполните одно из следующих действий:
   • В главном окне приложения перейдите в раздел Обнаружение устройств и развертывание → Развертывание и назначение → Инсталляционные пакеты.
   • В главном окне приложения перейдите в раздел Операции → Хранилища → Инсталляционные пакеты.

   Отобразится список инсталляционных пакетов доступных на Сервере администрирования.

2. Нажмите на кнопку Добавить.

   Запустится мастер создания инсталляционного пакета. Для продолжения работы мастера нажмите на кнопку Далее.

3. Выберите параметр Создать инсталляционный пакет для задачи "Удаленное выполнение скриптов" на основе архива ZIP с файлом manifest.json.
4. Укажите имя инсталляционного пакета и нажмите на кнопку Обзор.

   В открывшемся окне выберите файл для создания инсталляционного пакета.

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

   Файл начнет загружаться на Сервер администрирования Kaspersky Security Center Linux.

   Начнется процесс создания инсталляционного пакета.

   В окне мастера отобразится информация о завершении процесса.

   Если инсталляционный пакет не создан, отобразится соответствующее сообщение.

6. Нажмите на кнопку Готово, чтобы закрыть окно мастера.

Созданный инсталляционный пакет загружается во вложенную папку Packages общей папки Сервера администрирования. После загрузки инсталляционный пакет появится в списке инсталляционных пакетов.

В списке инсталляционных пакетов доступных на Сервере администрирования, нажав на имя инсталляционного пакета, вы можете:

• Просмотреть следующие свойства инсталляционного пакета:
  • Имя. Название инсталляционного пакета.
  • Источник. Имя поставщика приложения.
  • Версия. Версия приложения.
  • Создано. Дата создания инсталляционного пакета.
  • Изменено. Дата изменения инсталляционного пакета.
  • Путь. Путь к пользовательскому инсталляционному пакету на Сервере администрирования.
• Изменить имя пакета и параметры командной строки. Эта функция доступна только для пакетов, которые не созданы на основе приложений "Лаборатории Касперского".

Подготовка архива для задачи Удаленное выполнение скриптов

Развернуть все | Свернуть все

Архив для задачи Удаленное выполнение скриптов на основе файла manifest.json должен соответствовать следующим требованиям:

• Формат архива: ZIP.
• Общий размер: не более 1 ГБ.
• Количество файлов и папок в архиве не ограничено.
• Манифест-файл архива должен соответствовать приведенной ниже схеме и называться manifest.json. Схема проверяется только во время выполнения задачи на устройстве.

  Схема JSON манифест-файла и описание массивов

  Схема JSON

  {

  "$schema": "http://json-schema.org/draft-07/schema#",

  "title": "Schema for execute scripts task",

  "type": "object",

  "properties": {

  "version": {

  "type": "integer",

  "enum": [1]

  },

  "actions":{

  "type": "array",

  "items": {

  "type": "object",

  "properties": {

  "type": {

  "type": "string",

  "enum": ["execute"]

  },

  "path": {

  "type": "string"

  },

  "args": {

  "type": "string"

  },

  "results":{

  "type": "array",

  "items": {

  "type": "object",

  "properties": {

  "code": {

  "type": "integer",

  "minimum": -255,

  "maximum": 255

  },

  "next":{

  "type": "string",

  "enum": ["break", "continue"]

  }

  },

  "required": [

  "code",

  "next"

  ]

  }

  },

  "default_next":{

  "type": "string",

  "enum": ["break", "continue"]

  }

  },

  "required": [

  "type",

  "path",

  "default_next"

  ]

  }

  }

  },

  "required": [

  "version",

  "actions"

  ]

  }

  Пример манифест-файла

  {

  "version": 1,

  "actions": [

  {

  "type": "execute",

  "path": "scripts/run1.cmd",

  "args": "testArg",

  "results": [

  {

  "code": 0,

  "next": "continue"

  }

  ],

  "default_next": "break"

  },

  {

  "type": "execute",

  "path": "scripts/run2.cmd",

  "results": [

  {

  "code": 0,

  "next": "continue"

  }

  ],

  "default_next": "break"

  },

  {

  "type": "execute",

  "path": "scripts/run3.cmd",

  "results": [

  {

  "code": 0,

  "next": "continue"

  }

  ],

  "default_next": "break"

  }

  ]

  }

• Архив должен иметь следующую структуру:

  manifest.json

  <файл1>

  <файл2>

  <папка1>/<файл3>

  <папка2>/<папка3>/<файл4>

  ...

  <файлX>

  manifest.json – это манифест-файл задачи.

  <файл1>, ...., <файлX> – это набор файлов со скриптами, которые нужно выполнить.

Удаленная установка приложений на устройства с помощью задачи Удаленное выполнение скриптов

Развернуть все | Свернуть все

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

О том, как подготовить архив для этой задачи, см. статью.

Чтобы создать инсталляционный пакет для удаленной установки приложения на клиентское устройство, в архив, который вы хотите загрузить для этой задачи, должны быть включены следующие файлы:

• <название_пакета>.deb
• install.sh

  sudo dpkg -I <package_name>.deb

• manifest.json

  Схема JSON для удаленной установки приложения

  {

  "version": 1,

  "actions": [

  {

  "type": "execute",

  "path": "install.sh",

  "args": "<введите аргументы, если необходимо>",

  "results": [

  {

  "code": 0,

  "next": "continue"

  }

  ],

  "default_next": "break"

  }

  ]

  }

  Описание массивов

  1. version – версия файла манифеста и задачи.

     В настоящее время единственное допустимое значение – 1.

  2. Элементы массива actions определяют состав и порядок выполнения скриптов в задаче.

     Порядок выполнения скрипта соответствует индексу (положению) элемента в массиве.

  3. Для каждого элемента массива actions определены следующие элементы.
     1. type – тип исполняемой команды из скриптов. В настоящее время значение всегда execute.
     2. path – путь к файлу скрипта в архиве.
     3. args – аргументы, которые передаются скрипту как часть исполняемой команды.
     4. results – массив, определяющий дальнейшие действия в зависимости от результата выполнения задачи.
        1. code – значение, возвращающее скрипт.
        2. next – действие, которое будет выполнено следующим. Действие continue переходит к выполнению следующего скрипта (элемента в массиве actions). Действие break останавливает задачу.
     5. default_next – действие, если скрипт возвращает значение, которого нет в results.

При запуске задачи Удаленное выполнение скриптов Агент администрирования загрузит инсталляционный пакет с приложением на клиентское устройство. Когда клиентское устройство получает инсталляционный пакет, Агент администрирования на этом устройстве анализирует файл manifest.json и определяет порядок выполнения скриптов и действий в зависимости от результата, а затем начинает выполнение.

После завершения задачи Удаленное выполнение скриптов приложение будет установлено на клиентском устройстве.

Настройка уведомлений и мониторинга для задачи Удаленное выполнение скриптов

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

Чтобы просмотреть статус задачи Удаленное выполнение скриптов:

1. В главном окне приложения перейдите в раздел Устройства → Задачи.

   Отобразится список задач.

2. Выберите задачу и нажмите на История устройства.

   Отображается ход выполнения задачи.

Чтобы настроить поведение при сохранении событий:

1. В списке задач нажмите на название задачи и перейдите на вкладку Параметры.
2. В разделе Уведомления нажмите на кнопку Параметры.
3. Выберите один из следующих вариантов поведения приложения после выполнения задачи:
   • Сохранять все события.
   • Сохранять события, связанные с ходом выполнения задачи.
   • Сохранять только результат выполнения задачи.

     События сохраняются в разделе История устройства и Хранилище событий.

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

     Если вы выберете Сохранять все события, сохраняются только результаты выполнения задачи.

4. Если вы хотите сохранить события в базе данных Сервера администрирования, в журнале событий на Сервере администрирования или на устройстве, включите соответствующий параметр.

Подробнее о настройке уведомлений см. в этой статье.