Разделы документации

Требования КБ

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

Что это

Требования к разработке хранятся в каталогах. В каждой организации есть каталог Требования КБ: требования кибербезопасности к разработке и эксплуатации ПО с кодами вида КБ-AUTZ-024. Рядом с ним администратор заводит свои каталоги: внутренний стандарт, требования регулятора, выдержку из OWASP ASVS. Все каталоги устроены одинаково.

У каждого требования есть код, название, текст, критичность (Critical, High, Medium, Low) и исполнение: Обязательно, Желательно или Усиливающая мера. Остальные поля задаёт шаблон каталога. У «Требований КБ» это раздел, угроза, риск, требования к реализации, параметры, аудит, проверка выполнения, как закрыть, стандарты и метки.

Каталог целиком к системе не применяется. Из него собирают профиль — набор требований для определённого типа систем, например «Базовый веб». Профиль привязывают к продуктам, компонентам и репозиториям, и его требования появляются в карточке объекта.

Всё это собрано в Compliance Studio. Она открывается из меню Рабочая область в боковой панели, группа Студии.

Каталоги

Слева в Compliance Studio — навигатор. В блоке Каталоги у каждого каталога раскрываются разделы: значения первого поля шаблона с выбором из списка. У «Требований КБ» это поле Раздел: «Авторизация», «Валидация» и другие. Нажмите на раздел, чтобы оставить в списке только его требования.

Отметьте требования чекбоксами и нажмите Добавить в профиль, чтобы включить их в существующий профиль. Кнопка Открыть каталог ведёт на страницу каталога с вкладками Требования, Шаблон и Настройки. Там требования ищут, фильтруют по полям с выбором (например, по стандарту или метке), выгружают и загружают из файла.

Требование открывается справа. Под названием указаны код, критичность, каталог, статус и версия, ниже — исполнение и владелец требования. У требования четыре вкладки:

ВкладкаЧто в ней
СодержаниеТекст требования и поля шаблона: короткие парами «поле — значение», многострочные отдельными блоками
ОбсуждениеВопросы и предложения владельцам каталога, ответы, файлы
ИсторияВерсии требования: кто и когда изменил текст, зачем и что именно поменялось
ПрименениеПрофили с этим требованием и объекты этих профилей со статусом проверки

В каталоге описано само правило, отметок «выполнено» здесь нет. Выполнение отмечают у конкретного продукта, компонента или репозитория (см. ниже).

Обсуждение

В обсуждении задают вопрос по формулировке или предлагают изменение. Если ввести @, можно упомянуть человека из своей организации. К сообщению можно приложить до пяти файлов. На вопрос отвечают в его ветке. Когда вопрос закрыт, автор или администратор отмечает его кнопкой Вопрос решён.

Каждый вопрос помнит версию текста, к которой его задали: «Обсуждается версия 2». Если требование потом изменили, рядом видна текущая версия.

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

Версии

Администратор меняет требование кнопкой Редактировать и коротко пишет, что изменилось и зачем. После сохранения выходит новая версия. На вкладке История у каждой версии есть автор, дата, причина и список изменённых полей, а по кнопке Посмотреть изменения видно, что было и что стало.

Новая версия не попадает в профили сама. Как её принять, описано в разделе про профили.

Поле, которое уже заполнено у требований, нельзя удалить, его отправляют в архив. Требование тоже отправляют в архив, а не удаляют: оно остаётся в профилях и на объектах. Это касается и «Требований КБ»: их шаблон и требования администратор правит так же, как в любом другом каталоге.

Новый каталог

Создаёт каталог администратор: кнопка + у блока Каталоги в навигаторе.

  1. Укажите название и префикс кода, например ВН. Требования получат коды ВН-1, ВН-2 и дальше по порядку. Префикс уникален в организации: КБ уже у «Требований КБ». Менять префикс можно, пока в каталоге нет ни одного требования.
  2. На вкладке Шаблон добавьте поля, которые есть в стандарте: уровень, глава, CWE, ссылка на первоисточник. Вид поля выбирают при создании: строка, многострочный текст, число, дата, да/нет, ссылка или выбор из списка. Варианты выбора вводят по одному, кнопкой Добавить вариант. Поле с выбором работает как классификатор: по нему фильтруют требования и в каталоге, и в профиле, а первое такое поле делит каталог на разделы в навигаторе.
  3. На вкладке Требования добавьте требования вручную или загрузите из файла.

Импорт и выгрузка

Кнопка Экспорт выгружает список каталога в Excel, CSV, PDF или Word. Выгрузка в Excel или CSV подходит как шаблон для импорта: поправьте файл и загрузите обратно.

  1. Нажмите Импорт и выберите файл .xlsx или .csv. Первая строка файла — заголовки колонок, строк не больше 2000.
  2. Проверьте, куда пойдёт каждая колонка. Колонки с подписями из выгрузки и с названиями полей шаблона сопоставляются сами. Колонку, которая не нужна, отметьте Не импортировать.
  3. Выберите режим. В режиме Обновить по коду строка с кодом каталога обновляет требование и создаёт его новую версию, а строка без кода добавляет новое требование. В режиме Добавить новые каждая строка становится новым требованием, коды из файла не учитываются.
  4. Нажмите Проверить. В предпросмотре видно, что будет с каждой строкой: новое, обновится, без изменений или ошибка с причиной.
  5. Нажмите Импортировать. Аркепелаг пропустит строки с ошибками и применит остальные за один раз.

Пустая ячейка в сопоставленной колонке очищает поле требования. Критичность понимается кодом (high) и словом («Высокий»), исполнение — подписью («Обязательно»), дата — в виде ГГГГ-ММ-ДД или ДД.ММ.ГГГГ.

Профили

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

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

Чтобы создать профиль:

  1. Нажмите Новый профиль.
  2. В шапке укажите название и, если нужно, описание.
  3. На вкладке Требования выберите требования в каталоге слева. Клик по строке открывает требование справа, а чекбокс включает его в профиль. Чекбокс раздела выбирает весь раздел. Если в разделе выбрана только часть, это видно по чекбоксу. Переключатель Все / Выбранные показывает только то, что уже в профиле. Над списком выберите каталог и, если нужно, отфильтруйте требования по его полям: разделу, стандарту, метке.
  4. На вкладке Область применения нажмите Добавить и выберите объекты на вкладках Репозитории, Продукты и Компоненты.
  5. Нажмите Создать профиль.

В нижней панели видно, сколько требований выбрано. Пока изменения не сохранены, в шапке горит Не сохранено. На вкладке История профиля собраны изменения названия, состава, принятых версий и области применения.

Профиль хранит версию каждого требования, которая была при добавлении. Если вышла новая версия, у требования в списке появляется отметка новая версия, а над текстом сообщение Доступна версия N с кнопкой Сравнить изменения. После кнопки Принять обновление профиль переходит на новую версию. Если оставить отметку Нужна повторная проверка, объекты, проверенные по старой версии, получат пометку проверить заново на вкладке Требования. Сами статусы проверки при этом не сбрасываются и помнят, по какой версии их ставили.

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

Вкладка «Требования»

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

КолонкаЧто показывает
КодКод требования с префиксом каталога: КБ-AUTZ-024, ВН-12
ТребованиеКраткое название
КаталогНазвание каталога, например «Требования КБ»
SeverityКритичность
ОснованиеПрофиль, анкета или «Вручную»
СтатусСтатус проверки на этом объекте
ПодтвержденияСколько записей и файлов приложено

Поиск работает по коду, названию, каталогу и основанию. Если требования пришли из нескольких каталогов, рядом с поиском появится фильтр Каталог. По клику на строку открывается полный текст требования. В правой панели Сводка показано число профилей и требований с разбивкой по severity и разделы, где требований больше всего.

Если у объекта нет ни одного требования, на вкладке будет пустое состояние Профиль не назначен с кнопкой Открыть профили. Профиль привязывают в Compliance Studio, на вкладке объекта это сделать нельзя.

Кто что может

ДействиеКто может
Смотреть профили в Compliance StudioУчастники организации, которой принадлежит профиль; администратор видит все
Смотреть вкладку ТребованияВсе, кто может открыть сам продукт, компонент или репозиторий
Создавать и менять профили, привязывать их к объектам, принимать новые версии требованийАдминистратор и пользователи с правом Изменение продуктов или Изменение объектов продукта
Задавать вопросы и отвечать в обсуждении требованияВсе пользователи
Редактировать требование, назначать владельцаАдминистратор
Отмечать вопрос решённымАвтор вопроса и администратор