Политики

Политика — это настраиваемое правило автоматизации DevSecOps-процессов, работающее по событийно-ориентированной (event-driven) модели. Оно позволяет системе реагировать на внутренние события или срабатывать по расписанию, выполняя указанные действия над сущностями системы.

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

1. Триггер — событие, при наступлении которого срабатывает политика. Таким событием может быть изменение сущности (создание проекта, обновление проблемы безопасности, завершение сканирования и др.) или наступление времени по cron-расписанию.
2. Условия — логический фильтр, определяющий применимость правила.
3. Действие — операция, выполняемая при истинности условий. Включает CRUD-операции над сущностями (проекты, слои, уязвимости), управление сканированиями, отправку уведомлений и создание задач в трекерах задач.

к сведению

Условия политики описываются на языке CEL (Common Expression Language) — поэтому поддерживаются сложные операторы, агрегации над массивами и временные интервалы. Подробнее о синтаксисе CEL см. в документации к репозиторию CEL

Добавление новой политики

Добавление стандартной политики

Чтобы добавить новую политику, выполните следующие шаги:

1. Перейдите в раздел Политики.

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

3. В открывшемся окне укажите следующие данные:

   • название политики;
   • описание политики;
   • область действия (вся система или один проект).
   к сведению

   Политики для проектов можно также добавлять из проектов. Для этого перейдите в раздел Проекты → Название проекта → Политики, нажмите кнопку Добавить политику и выполните шаги, описанные ниже.

4. Выберите условие, при наступлении которого должна выполняться политика, из раскрывающегося списка Триггер в блоке Если.

5. Укажите действие, которое должно выполняться при срабатывании триггера, в блоке Тогда.

   Подсказка

   Введите свои условия на языке CEL или воспользуйтесь системными пресетами. Чтобы выбрать пресет, нажмите кнопку Применить пресет () и выберите необходимый пресет из списка.

   

   Рисунок 1 — Выбор пресетов

6. Проверьте корректность введенной конфигурации, нажав кнопку Проверить синтаксис. При корректном вводе появится уведомление Синтаксис конфигурации корректен. Ошибок не найдено..

7. Нажмите кнопку Создать.

Рисунок 2 — Добавление новой политики

После этого созданная политика будет отображаться в списке в разделе Политики и срабатывать при заданных условиях.

Добавление cron-политики

Чтобы добавить политику, которая будет выполняться по настроенному расписанию, выполните следующие шаги:

1. Выполните шаги 1-3 из предыдущей инструкции.

2. Выберите вариант По расписанию из списка Триггер.

3. Установите один из следующих вариантов расписания:

   • разовое срабатывание: укажите дату выполнения в формате ДД/ММ/ГГГГ ЧЧ:ММ;
   • повторение по расписанию: активируйте переключатель Повторять и введите cron-выражение для срабатывания политики.
   Внимание

   Обработка времени зависит от типа расписания:

   • расписание по cron-выражению работает по системному времени. Если пользователь указал cron-выражение для срабатывания каждый день в 10:00, то политика будет выполняться в 10:00 по системному времени, независимо от часового пояса пользователя;
   • расписание по конкретному времени и дате работает по пользовательскому времени, которое преобразуется в системное время с учетом часового пояса пользователя. Например, если пользователь настроил срабатывание политики завтра в 10:00, то политика выполнится завтра в 10:00 по времени пользователя.

   Подробнее о cron-выражениях см. раздел Настройка cron-выражений политик

   Подсказка

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

   

   Рисунок 3 — Выбор пресетов

4. Выберите триггер, который должен срабатывать по расписанию.

5. Укажите действие, которое должно выполняться при срабатывании триггера, в блоке Тогда.

6. Нажмите кнопку Создать.

Рисунок 4 — Добавление политики для выполнения по расписанию

После этого созданная политика будет отображаться в списке в разделе Политики и срабатывать при заданных условиях.

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

Чтобы отредактировать политику, выполните следующие шаги:

1. Перейдите в раздел Политики.
2. Нажмите кнопку дополнительных действий () в строке политики.
3. Выберите вариант Редактировать.
4. В открывшемся окне измените необходимые данные.
5. Нажмите кнопку Сохранить.

После этого измененные данные будут применены к политике.

Настройка порядка выполнения политик

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

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

1. Перейдите в раздел Политики.
2. Нажмите кнопку Изменить порядок выполнения.
3. В открывшемся окне выберите параметры группы политик:
   • область действия — вся система или один проект;
   • триггер — при выборе триггера будут отображаться действия, выполняемые при срабатывании триггера.
4. Переместите политики с помощью кнопки переноса () — она появится при наведении курсора на политику.
5. Нажмите кнопку Сохранить изменения.

Внимание

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

Рисунок 5 — Изменение порядка выполнения политик

После этого измененные данные будут применены к группе политик.

Удаление политик

Чтобы удалить одну политику, выполните следующие шаги:

1. Перейдите в раздел Политики.
2. Нажмите кнопку дополнительных действий () в строке политики.
3. Выберите вариант Удалить.
4. Подтвердите удаление политики в открывшемся модальном окне.

Рисунок 6 — Подтверждение удаления политики

Чтобы удалить несколько политик, выполните следующие шаги:

1. Выберите необходимые политики с помощью флажков ().
2. Нажмите кнопку удаления () над таблицей политик.
3. Подтвердите удаление политик в открывшемся модальном окне.

Рисунок 7 — Подтверждение удаления политик