Развёртывание

Команды и роли

Что может каждая из четырёх ролей и как администратор команды её настраивает: цели, ИИ, учётные данные для сканирования, отчёты и API-токены.

Открыть в Markdown

В ScanSuite вся работа разделена по командам. Продукты, сканирования, уязвимости, активы, учётные данные, отчёты, расписания и интеграции принадлежат ровно одной команде. Пользователь видит и меняет только данные своих команд, и в каждой команде — только то, что разрешает его роль. На этой странице описано, что разрешено каждой роли и как администратор команды настраивает её на странице Команды.

Как команды разделяют данные

  • На каждой странице видно, в какой команде вы работаете. Списки, поиск и отчёты охватывают только её.
  • Сканирования, расписания и отчёты принадлежат команде, в которой их запустили. Если команду приостановить, её текущие сканирования остановятся.
  • Посторонний не откроет уязвимости, отчёты и файлы команды. Даже администратор системы увидит их, только став участником команды.

В двух вкладках браузера можно работать в разных командах одновременно: каждая страница остаётся в той команде, в которой её открыли.

Работа в нескольких командах

Ваша роль в текущей команде указана под именем пользователя в правом верхнем углу. Если вы состоите в нескольких командах, переключаться между ними можно в том же меню, в разделе Сменить команду. Ссылка с параметром ?team=<TEAM_SHORT_NAME> открывает страницу сразу в нужной команде.

Меню пользователя ScanSuite
Меню пользователя: роль в текущей команде под именем. Раздел «Сменить команду» появляется, если вы состоите в нескольких командах

Роли

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

ДействиеАдминистратор командыОператорМенеджер уязвимостейЧитатель
Просмотр продуктов, сканирований, уязвимостей, активов, отчётов и настроек командыДаДаДаДа
Раскрытие и выгрузка значений сохранённых учётных данныхДаДаДа—
Изменение и разбор уязвимостей, активов и найденных учётных данных; создание PoC-эксплойтовДаДаДа—
Удаление уязвимостей, активов и найденных учётных данныхДаДа——
Запуск PoC-эксплойтов; запуск, остановка и удаление сканирований; импорт отчётов; создание и изменение продуктов; расписания и правилаДаДа——
Интеграции, ключ SSH команды, учётная запись сервера, движки сканеров, сроки устранения, уязвимости сканеров, отчёты для руководства, «Как ИИ обрабатывает уязвимости»ДаДа——
Разрешённые цели, ИИ команды и его бюджет токеновДа———
Участники, группы единого входа, сервисные аккаунты и API-токены, журнал активностиДа———
  • Роль Менеджер уязвимостей подходит аналитику, который разбирает результаты, но не запускает сканирования: он работает с уязвимостями, активами и учётными данными, но не может запускать сканирования и эксплойты и ничего не может удалять.
  • Читатель видит, что учётные данные есть и где их нашли, но не видит самих значений.
  • Читатель может скачать любой отчёт и любую выгрузку, которые есть на страницах.
  • Сервисному аккаунту можно дать роль Оператор или Читатель (по умолчанию — Читатель), но не роль администратора команды.
  • Группы единого входа сопоставляются с теми же четырьмя ролями, см. Единый вход.

Страница команды

Всё, что относится к команде в целом, собрано на странице Команды. Она открывается из меню пользователя или из раздела Администрирование на боковой панели и разбита на вкладки:

ВкладкаЧто на ней
ОбзорУчастники, разрешённые цели, расход ИИ за месяц и подключённые сервисы. Список «Подготовка команды» показывает, что ещё нужно настроить; каждый шаг ведёт туда, где это делается.
ЛюдиУчастники, «Автоматизация и API-токены», «Группы единого входа». Вкладку видят только администраторы команды.
СканированиеВеб-цели, инфраструктурные цели, ключ SSH команды, учётная запись сервера, движки сканеров, сроки устранения, уязвимости сканеров на странице «Уязвимости», отчёты для руководства.
ИИПоставщик ИИ, карточки распределения задач по собственным моделям команды, бюджет токенов на месяц, «Как ИИ обрабатывает уязвимости».
ИнтеграцииТрекеры задач (DefectDojo, Securitm), оповещения (почта, Telegram), сервисы обогащения (Snyk, Shodan, Dehashed).
АктивностьЖурнал активности команды. Вкладку видят только администраторы команды.

Участники, чья роль не позволяет вносить изменения, видят настройки только для чтения; на каждой карточке написано, кто может её менять. У каждой карточки своя кнопка Сохранить. Настройки команды меняются только в браузере: для участников, разрешённых целей, ИИ команды и сервисных аккаунтов нет ни команд в командной строке, ни доступа через API-токены.

Обзор команды в ScanSuite
Вкладка «Обзор» со списком «Подготовка команды»

Подготовка новой команды

Администратор команды проходит по списку Обзор → Подготовка команды. У каждого пункта есть кнопка, которая открывает карточку, где это делается:

ПунктЧто сделать
Разрешите цели сканированияДобавьте веб- и инфраструктурные цели на вкладке «Сканирование». Веб- и инфраструктурные сканирования работают только с разрешёнными целями. См. «Разрешённые цели» ниже.
Назначьте второго администратораДобавьте человека с ролью «Администратор команды» на вкладке «Люди», чтобы командой можно было управлять, когда один из администраторов отсутствует. См. «Участники и учётные записи».
Задайте ключ SSH командыСохраните закрытый ключ в карточке «Ключ SSH команды» на вкладке «Сканирование», чтобы расписания и сканирования из конвейеров могли клонировать закрытые репозитории.
ИИ доступенВыберите ИИ на вкладке «ИИ». Он нужен для ИИ-сканирований, проверки исправлений и создания PoC-эксплойтов.
Настройте оповещенияЗаполните почту или Telegram в карточке «Оповещения» на вкладке «Интеграции».
Экспортируйте уязвимости в трекер задач (необязательно)Подключите DefectDojo или Securitm на вкладке «Интеграции».

Проверка: выполненные пункты становятся зелёными, а в статусе карточки вместо Осталось шагов: N появляется Готово. Как добавлять участников, описано в разделе Участники и учётные записи.

ИИ команды

На вкладке ИИ в карточке Поставщик ИИ администратор команды выбирает, что Использовать, и нажимает Сохранить:

ВариантЧто делаетКогда выбирать
Системный ИИ, настроенный администратором системыОбщие модели установки; показываются только их названия.По умолчанию для новой команды.
Собственные модели командыКоманда добавляет свои подключения к ИИ и модели в карточках ниже и направляет каждую задачу ИИ на одну из них.Когда команда должна пользоваться своей учётной записью у поставщика ИИ или своей моделью.
Без ИИ: отключить функции ИИ для командыИИ-сканирования и все функции ИИ для команды выключены.Когда команде нельзя передавать код или уязвимости никакому ИИ.

Кнопка Проверить подключение проверяет сохранённый вариант. Поля подключений и моделей и распределение задач описаны в разделе Поставщики ИИ и стоимость.

Карточка Бюджет токенов на месяц показывает, сколько токенов израсходовано в этом месяце, и ограничивает расход: поле Токенов в месяц; если оставить его пустым, у команды не будет своего лимита. При достижении лимита функции ИИ приостанавливаются до следующего месяца. Если лимит задал и администратор системы, действует меньший.

Настройки ИИ команды в ScanSuite
Поставщик ИИ команды, распределение задач и бюджет токенов

Как ИИ обрабатывает уязвимости

Эту карточку на вкладке ИИ могут менять администраторы команды и операторы:

ПолеЧто делаетПо умолчаниюКогда менять
Закрывать уязвимости, исправление которых подтвержденоЕсли сканирование охватывает файл, но больше не находит в нём уязвимость, ИИ читает текущий код и закрывает уязвимость, только если с указанием файла и строки может подтвердить, что проблемы больше нет. Уязвимости со статусом «Риск принят» или «Ложное срабатывание» не затрагиваются.ВключеноВыключите, если каждую уязвимость должен закрывать человек.
Язык текстов, которые пишет ИИЯзык описаний уязвимостей и заметок к PoC-эксплойтам, которые пишет ИИ: английский или русский.АнглийскийЕсли команда читает по-русски.

Разрешённые цели

Сканировать веб-приложения и инфраструктуру можно только в пределах целей, которые разрешил администратор команды. В карточках Веб-цели и Инфраструктурные цели на вкладке Сканирование в поле Разрешить выбирается режим:

РежимЧто делает
Только цели из списка нижеСканировать можно только цели из списка. Проверка выполняется при запуске сканирования.
Только цели из списка ниже, с проверкой во время сканированияТо же, но ScanSuite следит за сканированием до конца: проверяет перенаправления на другие сайты и адреса, в которые разрешается имя узла. Этот режим поддерживает только сканер AI DAST; остальные сканеры, в том числе все инфраструктурные, в нём отклоняются.
Любые целиБез ограничений. Выбирайте этот режим, только если сознательно разрешаете сканировать что угодно.

Для каждой записи нажмите Добавить цель, затем Сохранить:

СтолбецЧто указатьГде
Совпадение«Только этот узел»; «Его поддомены» (любой узел внутри домена, но не сам домен); «Сеть (CIDR)» для диапазонов IPv4 и IPv6.Обе карточки
Узел или сетьИмя узла, домен или диапазон, например app.example.com или 10.0.0.0/24.Обе карточки
Схемаany, https или http.Только веб-цели
ПортОт 1 до 65535; если оставить пустым, разрешён любой порт.Только веб-цели

Проверка: откройте раздел Проверить, разрешены ли цели, введите адреса, которые собираетесь сканировать, в поле Цели, по одной в строке и нажмите Проверить. Для каждой строки будет написано Разрешено: <цель> или Запрещено: <цель>. Ничего при этом не меняется.

У первой команды, созданной на странице /setup, для веб- и инфраструктурных сканирований задано Любые цели; ограничьте список, прежде чем открывать доступ к установке другим. У команды, созданной в настройках системы, список пуст и включена проверка во время сканирования, поэтому до первого веб- или инфраструктурного сканирования администратор команды должен добавить цели. Сканирование с неразрешённой целью отклоняется, и в нём указываются цель и причина, см. Управление выполнением сканирований. Правила записи целей в формах сканирования описаны в разделе Сканирование веб-приложений.

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

Разрешённые цели команды в ScanSuite
Разрешённые веб-цели и проверка адресов

Учётные данные для сканирования

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

Ключ SSH команды

В карточке Ключ SSH команды хранится Закрытый ключ, которым по SSH клонируются закрытые репозитории для расписаний, сканирований из конвейеров и участников, которые не сохранили свой ключ на странице «Моя учётная запись». Ключ, защищённый парольной фразой, использовать нельзя. После сохранения в карточке виден отпечаток ключа; кнопка Удалить удаляет его. Как устроен доступ к репозиториям в целом — Git-сервис в настройках системы и личный ключ каждого участника, — описано в разделе Аутентификация в Git-репозитории.

Ключ SSH команды в ScanSuite
Карточка «Ключ SSH команды» на вкладке «Сканирование»

Учётная запись сервера

Учётная запись, с которой инфраструктурные сканирования с аутентификацией входят на узлы:

ПолеЧто указать
Имя пользователяОбязательно. Учётная запись на сканируемых узлах.
Закрытый ключ SSH (необязательно)Закрытый ключ этой учётной записи.
Пароль или парольная фраза ключа (необязательно)Пароль учётной записи или парольная фраза ключа, указанного выше.

Кнопка Сохранить сохраняет учётную запись, Удалить — удаляет. Учётные данные, найденные сканированием, тоже можно утвердить в качестве учётной записи сервера на странице Учётные данные, см. Учётные данные. Движки сканеров OpenVAS и Acunetix на той же вкладке описаны в разделе API-ключи для внешних систем.

Уязвимости и отчёты

Сроки устранения

В карточке Сроки устранения задаётся, сколько дней может оставаться открытой новая уязвимость каждой критичности. По умолчанию это 7 дней для Critical, 30 — для High, 90 — для Medium и 180 — для Low; 0 означает, что срока нет. Как работают сроки и просроченные уязвимости, описано в разделе Управление уязвимостями.

Уязвимости сканеров на странице «Уязвимости»

Сохранять ли уязвимости классических сканеров (Semgrep, KICS, Trivy, Nuclei, ZAP, Wapiti, Acunetix, OpenVAS и других) на странице Уязвимости, помимо их отчётов и DefectDojo. Пороги качества в CI/CD учитывают только сохранённые уязвимости.

ПолеЧто делаетПо умолчаниюКогда менять
Сохранять уязвимости сканеровСохраняет уязвимости классических сканеров на странице «Уязвимости».ВключеноВыключите, если работаете с этими результатами только в DefectDojo или в отчётах.
Минимальная критичность для сохраненияУязвимости ниже этого уровня остаются только в отчётах сканирований. Уязвимости Nessus сохраняются всегда, и этот порог действует и на них.Средние«Низкие» или «Информационные», чтобы сохранять всё; «Высокие», чтобы список был коротким.
Закрывать уязвимости, которые повторное сканирование больше не находитSemgrep: уязвимость Semgrep закрывается как исправленная, когда Semgrep повторно сканирует файл теми же правилами и больше её не находит. «Все сканеры»: то же для веб- и инфраструктурных сканеров — после того как два завершённых подряд сканирования с одним профилем по доступной цели больше её не находят и ни один другой сканер её ещё не находит. «Выключено»: автоматически не закрывается никогда. Уязвимости со статусом «Риск принят» и «Ложное срабатывание» не затрагиваются; закрытая уязвимость, которая появилась снова, открывается заново.Semgrep«Все сканеры» при регулярных повторных веб- и инфраструктурных сканированиях; «Выключено», если закрывать только вручную.

Отчёты для руководства

Как PDF-отчёты и слайды, выгружаемые со страниц Продукты и Уязвимости, представляют вашу команду (см. Отчёты и экспорт):

ПолеЧто делаетПо умолчаниюКогда менять
Название компанииПечатается вверху каждой страницы.Пусто (только логотип)Чтобы указать название вашей компании.
Гриф«Конфиденциально», «Только для внутреннего использования», «Ограниченный доступ» или «Без грифа».КонфиденциальноЧтобы соответствовать принятой у вас классификации документов.
Формат бумагиA4 или Letter.A4Letter — в Северной Америке.
Логотип«Загрузить логотип»: PNG или JPEG, не больше 512 КБ. Печатается высотой около 20 пунктов, поэтому лучше всего подходит широкий логотип. Кнопка «Удалить» удаляет его.НетЧтобы оформить отчёты в фирменном стиле.

Интеграции

Трекеры задач, оповещения и сервисы обогащения на вкладке Интеграции, а также движки сканеров на вкладке Сканирование описаны в разделе API-ключи для внешних систем. Менять их могут администраторы команды и операторы.

Сервисные аккаунты и API-токены

Конвейеры и скрипты работают с командой через токен сервисного аккаунта, а не через пароль сотрудника. В карточке Автоматизация и API-токены на вкладке Люди также показано Имя этой команды в конвейерах и адресах API (SCANSUITE_TEAM).

  1. 01
    Создайте сервисный аккаунт

    В разделе «Новый сервисный аккаунт» введите имя, например gitlab-ci, выберите роль («Читатель» по умолчанию или «Оператор», чтобы запускать сканирования) и нажмите «Создать». Появится сообщение: Сервисный аккаунт <имя> создан.

  2. 02
    Нажмите «Новый токен» в строке аккаунта

    Введите имя токена и срок действия в днях (от 1 до 90, по умолчанию 30), выберите, что он может делать (таблица ниже), и нажмите «Создать токен».

  3. 03
    Скопируйте токен из окна «Ваш новый токен»

    В окне один раз показываются токен, имя команды (SCANSUITE_TEAM) в отдельной строке и две готовые команды для проверки.

  4. 04
    Проверьте токен

    Вставьте в терминал любую команду из раздела «Проверьте подключение». В ответ она покажет, что разрешено токену, или объяснит, почему сервер его отклоняет. Если сертификат самоподписанный, добавьте к curl ключ -k.

Перенести токен из окна в хранилище секретов CI-системы должен человек. Токен показывается один раз и больше никогда.

Что он может?ПраваКогда использовать
Конвейер CIПросмотр и создание продуктов; запуск, остановка и просмотр сканирований; просмотр уязвимостей, найденных учётных данных и отчётов.Для конвейера, который запускает сканирования. Сервисному аккаунту нужна роль «Оператор».
ОтчётностьПросмотр продуктов, сканирований, уязвимостей, активов и отчётов.Для дашбордов и выгрузок. Достаточно роли «Читатель».
Пользовательский наборПрава выбираются по одному и сгруппированы так: продукты, сканирования, уязвимости, активы, отчёты, учётные данные, настройки и доступ.Для всего остального, например для скрипта, который разбирает уязвимости (право на изменение уязвимостей).

Токен никогда не может больше, чем разрешает роль его сервисного аккаунта. Он передаётся в заголовке Authorization: Bearer <token>; как его используют конвейеры, описано в разделе CI/CD и автоматизация.

В списке у каждого сервисного аккаунта показаны его токены с пометкой истекает <дата>. Кнопка Отозвать сразу прекращает действие одного токена. Кнопка Отключить останавливает все токены аккаунта, пока вы снова не нажмёте Включить.

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

Сервисные аккаунты и API-токены в ScanSuite
Выпуск API-токена для сервисного аккаунта

Если доступа нет

Если страница недоступна, ScanSuite показывает страницу «Доступ запрещён». Участникам и бывшим участникам команды он объясняет причину: членство приостановлено или отозвано, команда приостановлена, в установке обязателен единый вход или роль не разрешает это действие. С этим может помочь администратор команды. Остальные видят только сообщение, что доступа нет.

Страница «Доступ запрещён» в ScanSuite
Попытка открыть команду, в которой вы не состоите

Проверено: 2026-10-19