Настройки системы

Установкой целиком управляют в разделе Настройки системы: здесь заводят команды и задают им лимиты, настраивают общие для всех команд сервисы, вход через поставщика удостоверений и список администраторов системы. Раздел встроен в ScanSuite и находится по адресу /admin. Открыть его можно из меню пользователя или из раздела Администратор на боковой панели. Раздел видят только администраторы системы; для остальных учётных записей адрес /admin не существует.

Первый запуск

В новой установке ещё нет ни одной учётной записи, поэтому первым делом ScanSuite предлагает её создать. Когда установщик закончит работу, он выведет адрес страницы https://<хост>/setup:

1. 01
   Установите ScanSuite

   Выполните установщик в каталоге /opt/scansuite, указав код из имени файла лицензии.

   ТерминалКопировать

   cd /opt/scansuite && ./scansuite install <код>

2. 02
   Откройте страницу /setup

   Пока учётных записей нет, на неё перенаправляет любой адрес ScanSuite.

3. 03
   Создайте первую учётную запись

   Укажите название команды, имя пользователя и дважды пароль, затем нажмите «Создать первую учётную запись». После этого откроется страница входа, а /setup перестанет открываться.

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

При первом запуске ScanSuite генерирует ключи, которыми шифрует сохранённые пароли и ключи API: SECRET_KEY, SCANSUITE_WRAPPING_KEYS и SCANSUITE_ACTIVE_WRAPPING_KEY. Они записываются в файл /opt/scansuite/key/scansuite-secrets.env, доступный только root, и при каждом запуске копируются в .env.

Что делает администратор системы

Отдельного входа для администрирования нет: администратор системы работает под своей обычной учётной записью. В настройках системы он:

Права администратора системы не дают доступа к работе команд. Чтобы увидеть продукты, сканирования, уязвимости, активы или учётные данные команды, нужно стать её участником. Администратор системы может добавить себя в любую команду, но это не останется незамеченным: такое действие записывается в журнал изменений установки.

Разделы настроек системы

zoom_inУвеличить

Как завести команду

На вкладке Команды нажмите Новая команда и заполните форму:

zoom_inУвеличить

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

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

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

Кнопка Открыть в строке команды открывает её панель. Там можно:

• в разделе Сведения и лимиты поменять статус и лимиты команды;
• в разделе Участники добавить человека с любой ролью, приостановить, возобновить или удалить участника. Если у команды не осталось активного администратора, панель предупредит об этом, а в строке команды появится кнопка Назначить администратора;
• в разделе Опасная зона удалить команду.

Статус

Лимиты

В форме новой команды уже подставлены значения по умолчанию: два сканирования одновременно и хранение 365 дней. Лимиты задаются вместе: чтобы снять их, очистите все три поля, а лимит токенов ИИ можно задать, только если заданы и два других.

Удаление

Кнопка Удалить команду приостанавливает команду и назначает удаление её данных через 30 дней. Этот срок дан на случай, если вы передумаете. Кнопка Отменить удаление отменяет его, но команда остаётся приостановленной — чтобы вернуть её в работу, переведите её в статус Активно. Можно сразу перевести команду в статус «Активно»: удаление тогда тоже отменится. Когда срок истечёт, сканирования, уязвимости и файлы команды будут удалены безвозвратно. Название команды останется в старых записях журналов, чтобы их можно было прочитать.

Общие сервисы

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

zoom_inУвеличить

zoom_inУвеличить

Цены задаются таблицей в формате JSON, где ключ — точное имя модели:

{
  "qwen3-coder-30b": {"prompt": 0.2, "completion": 0.6}
}

Цены применяются и к прошлым расходам: ScanSuite хранит число токенов, а стоимость считает по текущей таблице.

Вход и доступ

На вкладке Вход и доступ подключают поставщика единого входа для всей установки (см. Единый вход) и управляют списком администраторов системы. Чтобы добавить администратора, введите имя уже существующей учётной записи и нажмите Добавить. Хотя бы один администратор системы остаётся всегда: последнего снять нельзя.

Секреты

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

zoom_inУвеличить

Ключи шифрования меняют на сервере. Добавьте новый ключ в SCANSUITE_WRAPPING_KEYS в файле key/scansuite-secrets.env, укажите его в SCANSUITE_ACTIVE_WRAPPING_KEY и перезапустите ScanSuite, чтобы новые значения попали в .env. Затем перешифруйте сохранённые секреты и проверьте, что на старом ключе ничего не осталось:

cd /opt/scansuite && ./scansuite restart
docker compose run --rm migrate python -m configuration.rewrap
docker compose run --rm migrate python -m configuration.rewrap --check

Пока старые ключи ещё используются, --check завершается с ошибкой. Удаляйте старый ключ из файла только после того, как проверка пройдёт.

Проверка состояния

Работают ли база данных и сервис сессий, видно на вкладке Обзор. Для мониторинга есть адрес /admin/health: он возвращает в формате JSON общий статус и число команд без администратора, а если база данных или сервис сессий недоступны, отвечает кодом 503. Полную проверку сервера выполняет ./scansuite doctor, см. Параметры настройки и сервисы.

Если в систему некому войти

Снять последнего администратора системы ScanSuite не даст. Администраторы системы могут войти по паролю, даже когда единый вход обязателен. Поэтому такая ситуация возможна, только если ни у одного администратора системы нет пароля или все они потеряли доступ. Тогда выдайте права администратора системы существующей активной учётной записи прямо на сервере:

cd /opt/scansuite && docker compose exec web python -m authentication.recover --grant-installation-admin <имя пользователя>

Такое назначение записывается в журнал изменений установки.