Перейти к основному содержимому
Версия: 0.3.0

Создание и редактирование пилларов

к сведению

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

В SALT.BOX предусмотрено два источника пилларов:

  1. Глобальные пиллары
    Создаются на общей странице Pillars.
    Сохраняются в окружении pillarenv=base и по умолчанию применяются ко всем клиентам.

  2. Пиллары клиента
    Создаются во вкладке Pillars на странице конкретного клиента.
    Привязаны к pillarenv клиента и имеют более высокий приоритет по сравнению с глобальными пилларами.

ВНИМАНИЕ

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

Создание глобального пиллара со страницы "Pillars"​

Чтобы назначить пиллар, выполните следующие действия:

  1. В главном меню выберите пункт Pillars Рис. 1 .

    Переход на страницу "Pillars"
    Рисунок 1. Переход на страницу "Pillars"


  2. На странице Pillars нажмите кнопку + Создать Pillar Рис. 2.

    Интерфейс страницы "Pillars"
    Рисунок 2. Интерфейс страницы "Pillars"


  3. В диалоговом окне создания нового пиллара заполните поля и выберите параметры Рис. 3:

    • Имя — обязательное поле.
      Имя пиллара (ключ) — уникальное логическое имя пиллара, используемое для обращения к данным в SLS-файлах, шаблонах и при нацеливании Рис. 3 [1].

    • Переключатель Защищённый Рис. 3 [2].
      Значение пиллара хранится в зашифрованном виде на носителях: дисках, SSD, томах виртуальных машин, объектных или блочных хранилищах и автоматически расшифровывается при выполнении задач.
      Основная цель — исключить возможность несанкционированного доступа к данным, даже если злоумышленник получит прямой доступ к устройствам хранения.

    • Значение — обязательное поле.
      Значение пиллара в формате JSON Рис. 3 [3].

      примечание

      В поле Значение данные хранятся в формате JSON, где строки должны быть экранированы кавычками для корректного чтения системой, например: "test pillar" Рис. 3 [3].

    Диалоговое окно создания нового пиллара
    Рисунок 3. Диалоговое окно создания нового пиллара

  4. Нажмите кнопку Создать Рис. 3 [4].

В результате созданный пиллар отобразится на странице Pillars Рис. 4.

Созданный пиллар на странице "Pillars"
Рисунок 4. Созданный пиллар на странице "Pillars"

Назначение пиллара клиенту​

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

  1. В главном меню выберите пункт Клиенты Рис. 5 [1].

    Выбор коллекции клиентов
    Рисунок 5. Выбор коллекции клиентов


  2. На появившейся выдвижной панели выберите коллекцию клиентов Рис. 5 [2].

    Вы перейдёте на страницу выбранной коллекции клиентов Рис. 6, на вкладку Список.

    Список клиентов коллекции
    Рисунок 6. Список клиентов коллекции


  3. На вкладке Список выберите клиента и перейдите в его карточку Рис. 6.
    Чтобы перейти в карточку клиента, на вкладке Список в поле ID клиента нажмите кнопку Открыть в новой вкладке Рис. 6.

  4. На странице карточки клиента нажмите на вкладку Pillars Рис. 7 [1].

    Переход в диалоговое окно создания пиллара
    Рисунок 7. Переход в диалоговое окно создания пиллара

  5. Нажмите кнопку + Создать pillar Рис. 7 [2].

  6. В диалоговом окне создания нового пиллара заполните поля и выберите параметры Рис. 8:

    • Имя — обязательное поле.
      Имя пиллара (ключ) — уникальное логическое имя пиллара, используемое для обращения к данным в SLS-файлах, шаблонах и при нацеливании Рис. 8 [1].

    • Переключатель Защищённый Рис. 8 [3].
      Значение пиллара хранится в зашифрованном виде на носителях: дисках, SSD, томах виртуальных машин, объектных или блочных хранилищах и автоматически расшифровывается при выполнении задач.
      Основная цель — исключить возможность несанкционированного доступа к данным, даже если злоумышленник получит прямой доступ к устройствам хранения.

    • Значение — обязательное поле.
      Значение пиллара в формате JSON Рис. 8 [4].

    Диалоговое окно создания пиллара
    Рисунок 8. Диалоговое окно создания пиллара


  7. Нажмите кнопку Создать Рис. 8 [5].

В результате созданный пиллар отобразится на вкладке Pillars страницы карточки клиента Рис. 9.

Созданный пиллар на вкладке "Pillars"
Рисунок 9. Созданный пиллар на вкладке "Pillars"

Редактирование пилларов​

После добавления пилларов пользователь имеет возможность просматривать и изменять (редактировать) их значения, если они являются обычными (non-secure).

Редактирование пилларов доступно:

  • на общей странице Pillars Рис. 4;
  • на странице карточки клиента в таблице Pillars Рис. 9.
к сведению

Значение Защищённого пиллара (Secure pillar) Рис. 8 [3] и Рис. 3 [2] зашифровано, его просмотр и редактирование невозможны.

Для того чтобы отредактировать пиллар, выполните следующие действия:

  1. Перейдите на общую страницу Pillars Рис. 4 или на страницу клиента на вкладку Pillars Рис. 9.

  2. Выберите нужный пиллар и нажмите на его строку.

  3. В открывшемся окне просмотра пиллара нажмите кнопку Редактировать Рис. 10.

    Переход в режим редактирования пиллара
    Рисунок 10. Переход в режим редактирования пиллара


    к сведению

    Значение пиллара редактируется в формате JSON с поддержкой:

    • вложенных структур;
    • различных типов данных.
  4. В поле Значение выполните редактирование и нажмите кнопку Сохранить Рис. 11.

    Окно просмотра пиллара
    Рисунок 11. Окно просмотра пиллара

После успешного сохранения происходит следующее:

  • новое значение пиллара сохраняется;
  • дата изменения обновляется;
  • пользователь получает уведомление об успешном редактировании Рис. 12;
  • форма окна редактирования возвращается в режим просмотра.
Уведомление об успешном редактировании
Рисунок 12. Уведомление об успешном редактировании