Работа с переменными

Данный раздел описывает процесс работы с переменными в системе. Работа осуществляется в разделе Ресурсы → Переменные веб-интерфейса системы.

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

О переменных

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

Секрет — разновидность переменных, которая обеспечивает безопасное хранение чувствительных данных. Секреты позволяют ссылаться на эти данные и использовать их без явного указания в различных объектах системы. Значения секрета, в отличие от переменных, невозможно посмотреть. Они могут быть только перезаписаны. Доступ к секретам является событием аудита и регистрируется системой.

Использование переменных в скрипте

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

Поддерживаются следующие типы переменных:

учетные данные;
токен;
строка подключения;
сертификат;
контейнер PKCS;
контейнер PKCS#12.

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

Событие доступа к секретам идентифицируется как отдельное событие аудита. Затем оно регистрируется и сохраняется в системное хранилище аудита.

Интерфейс раздела

Панель инструментов включает в себя следующие компоненты:

Кнопка Создать () позволяет создать новую переменную.
Поле Поиск предназначено для быстрого поиска переменных по названию в отображаемом списке.
Кнопка Фильтр позволяет настроить следующие критерии фильтрации переменных: по Статусу, наличию признака Секрет и Типу искомых элементов.

В рабочей области отображается таблица имеющихся переменных. При выборе конкретной переменной на экране открывается карточка с детальной информацией о ней.

Колонки таблицы представлены следующим образом:

Название — название переменной.
Описание — описание переменной.
Секрет — индикатор, указывающий, является ли переменная секретом.
Тип — тип переменной.
Статус — статус переменной (Включен, Выключен).
Дата создания — дата создания переменной.
Дата изменения — дата и время изменения переменной.

При работе с таблицей переменных доступны следующие операции:

Поиск переменных по полю Название.
Фильтрация переменных по полям Статус, Секрет, Тип. Статус, индикатор секрета и тип переменной выбираются из выпадающих списков.
Сортировка переменных по полям Название, Секрет, Дата создания и Дата изменения.

Работа с переменной

Доступные операции над переменной:

создание переменной;
просмотр переменной;
изменение переменной;
удаление переменной.

Создание переменной

Чтобы создать переменную:

Перейдите в раздел Ресурсы → Переменные.
Нажмите на кнопку Создать (). Отобразится окно создания переменной.
Введите уникальный идентификатор переменной. Рекомендуется использовать человекочитаемое значение.
Введите название переменной.
При необходимости введите описание переменной.
Выберите из выпадающего списка тип переменной. Отобразятся необходимые поля для ввода значения переменной.
Если переменная является секретом, переведите переключатель Секрет в активное положение.
Введите значение переменной.

При выборе типов переменных, приведенных ниже, переключатель Секрет устанавливается в активное положение по умолчанию. Укажите требуемые данные в полях, отображаемых системой:
- Учетные данные. Введите имя пользователя и пароль.
- Токен. Введите токен.
- Строка подключения. Введите строку подключения.
- Сертификат. Загрузите файл сертификата. Допустимые форматы: DER, PEM (X.509).
- Контейнер PKCS.
  - Загрузите файл сертификата. Допустимые форматы: DER, PEM (X.509).
  - Загрузите файл приватного ключа. Допустимые форматы: DER, PEM (PKCS#8).
  - При необходимости укажите пароль для приватного ключа.
- Контейнер PKCS#12. Загрузите файл сертификата. Допустимый формат: PKCS#12.
  - При необходимости укажите пароль для приватного ключа.
Нажмите на кнопку Создать. Переменная будет создана и добавлена в список в разделе Ресурсы → Переменные. Система отобразит соответствующее уведомление.

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

Просмотр переменной

Чтобы просмотреть переменную:

Перейдите в раздел Ресурсы → Переменные. Система отобразит сведения об имеющихся переменных.
Нажмите на строку переменной в списке. Система отобразит страницу с карточкой этой переменной с подробной информацией о нем.

Название переменной отображается в верхней части карточки.

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

Панель инструментов карточки включает в себя следующие компоненты:

Выпадающее меню Действия () с опциями:
- Изменить — изменение параметров переменной.
- Удалить — удаление переменной.

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

Карточка содержит вкладку Информация, которая включает в себя следующие поля:

Название — название переменной.
ID — идентификатор переменной.
Статус — статус переменной (Включен, Выключен).
Описание — описание переменной.
Секрет — индикатор, указывающий, является ли переменная секретом.
Тип — тип переменной.
Дата создания — дата и время создания переменной.
Создал — пользователь, создавший переменную.
Дата изменения — дата и время изменения переменной.
Изменил — пользователь, изменивший переменную.

Панель Значение в нижней части карточки отображает значение переменной. Если переменная является секретом, панель не отображается.

Изменение переменной

Чтобы изменить переменную:

Перейдите в раздел Ресурсы → Переменные. Система отобразит сведения об имеющихся переменных.
Нажмите на строку переменной в списке. Система отобразит страницу с карточкой этой переменной с подробной информацией о ней.
Из выпадающего меню Действия () выберите опцию Изменить. Отобразится окно изменения переменной.
Внесите изменения в требуемые поля переменной.
Нажмите на кнопку Сохранить. Измененные данные переменной будут сохранены. Система отобразит соответствующее уведомление.

Изменить название и описание переменной можно и непосредственно из ее карточки:

Перейдите в раздел Ресурсы → Переменные. Система отобразит сведения об имеющихся переменных.
Нажмите на строку переменной в списке. Система отобразит в правой части экрана карточку этой переменной с подробной информацией о ней.
Нажмите на кнопку Изменить () рядом с текущим названием или описанием переменной в его карточке. Система отобразит поле ввода значения.
Введите новое значение поля.
Нажмите Сохранить. Измененные данные переменной будут сохранены. Система отобразит соответствующее уведомление.

Удаление переменной

Чтобы удалить переменную:

Перейдите в раздел Ресурсы → Переменные. Система отобразит сведения об имеющихся переменных.
Нажмите на строку переменной в списке. Система отобразит страницу с карточкой этой переменной с подробной информацией.
Из выпадающего меню Действия () выберите опцию Удалить. Отобразится окно подтверждения удаления переменной.
Нажмите на кнопку Удалить. Переменная исчезнет из списка переменных. Система отобразит уведомление об удалении выбранной переменной.