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

> Команды и их лимиты, общие сервисы (системный ИИ, Nessus, Git-сервис, язык интерфейса), администраторы системы, смена ключей и состояние платформы.

Источник: https://scansuite.ru/documentation/administration/platform-administration
Проверено: 2026-10-19

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

> **Примечание:** Если в установке одна команда, сюда вы будете заходить редко: чтобы добавить команду, поменять лимиты, настроить единый вход, сменить системный ИИ или язык интерфейса по умолчанию.

Первый администратор системы — это учётная запись, которую создают на странице `/setup` сразу после установки, см. [Установка ScanSuite Teams](https://scansuite.ru/documentation/installation/install-scansuite-server). Она администрирует и первую команду, и систему. Храните ключи шифрования установки вместе с резервными копиями базы данных, см. [Резервное копирование и восстановление](https://scansuite.ru/documentation/administration/backup-and-restore).

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

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

> **Внимание:** Перед сохранением любого изменения в настройках системы ScanSuite проверяет, что вы входили не больше 15 минут назад. Если прошло больше, он попросит ввести пароль или заново войти через поставщика; войдите и повторите изменение.

## Вкладки настроек системы

| Вкладка | Что на ней |
|---|---|
| Обзор | Сводка по установке: команды, системный ИИ, единый вход, оставшиеся запуски Nessus и состояние сервисов (база данных и сервис сессий). Ниже — список «Требует внимания»: команды без администратора, запланированные удаления, ненастроенный системный ИИ, закончившиеся запуски Nessus и недоступные сервисы. Каждый пункт ведёт туда, где проблему можно исправить. |
| Команды | Все команды с их статусом, администраторами и лимитами. Здесь команды создают, открывают, переименовывают, приостанавливают и удаляют. |
| Общие сервисы | Системный ИИ и его модели, сканер Nessus и его ресурс, цены LLM, сервис Git, язык интерфейса по умолчанию и лимиты, с которыми создаются новые команды. |
| Вход и доступ | Единый вход для всей установки и список администраторов системы. |
| Безопасность | Журнал активности системы и сохранённые версии секретов установки. |

Кнопка **Команды** в заголовке страницы открывает страницу той команды, в которой вы работаете, см. [Команды и роли](https://scansuite.ru/documentation/administration/teams-and-roles).

![Обзор настроек системы ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/platform-administration/05.png)

*Вкладка «Обзор» в настройках системы*

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

1. **Откройте «Настройки системы → Команды» и нажмите «Новая команда»**

   Откроется окно «Новая команда».
2. **Заполните поля**

   См. таблицу ниже. Обязательны поля «Название команды», «Короткое имя в адресах» и «Администратор команды».
3. **Нажмите «Создать команду»**

   Команда появится в списке вместе с администратором. Если вы ввели имя новой учётной записи, ScanSuite покажет одноразовую ссылку: передайте её владельцу учётной записи, и он задаст по ней пароль.

| Поле | Что делает | По умолчанию | Когда менять |
|---|---|---|---|
| Название команды | Как команду будут видеть люди, например «Платежи». | Пусто | Всегда. Потом команду можно переименовать. |
| Короткое имя в адресах | Строчные латинские буквы, цифры и дефисы. Используется в адресах вида ?team=payments, в адресе единого входа и в значении SCANSUITE_TEAM для конвейеров. | Заполняется по названию | Только до создания команды: потом его не изменить. |
| Администратор команды | Существующая учётная запись или новое имя: тогда ScanSuite создаст учётную запись и покажет одноразовую ссылку для задания пароля. Если в установке обязателен единый вход, подойдёт только существующая учётная запись. | Пусто | Всегда. |
| Сканирований одновременно | Сколько сканирований команда может одновременно держать в очереди и в работе. От 1 до 1000. | 2 | Для большой команды или команды, которая запускает много сканирований из конвейеров. |
| Хранить данные (дней) | Сколько хранятся завершённые сканирования. От 1 до 3650. | 365 | Если у вас своя политика хранения. |
| Токенов ИИ в месяц | Месячный лимит токенов ИИ для команды. | Без лимита | Чтобы ограничить расходы команды на ИИ. |

![Форма новой команды в ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/platform-administration/01.png)

*Создание команды: название, администратор и лимиты*

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

Новая команда пока не может сканировать веб-приложения и узлы: список разрешённых целей у неё пуст. Поэтому первое, что делает администратор команды, — добавляет цели, см. [Команды и роли](https://scansuite.ru/documentation/administration/teams-and-roles).

## Поиск команды и управление ею

На вкладке **Команды** перечислены все команды:

| Элемент | Что делает |
|---|---|
| Найти команду | Оставляет в списке команды, в названии или коротком имени которых есть введённый текст. |
| Показать | «Все команды» или «Требующие внимания»: команды без активного администратора или с назначенным удалением. |
| Команда, Статус, Администраторы, Лимиты | Столбцы списка. «Администраторы» — число активных администраторов команды; в «Лимитах» показаны сканирования одновременно, дни хранения данных и токены ИИ в месяц. |
| Открыть | Открывает панель команды, описанную ниже. |
| Назначить администратора | Появляется вместо «Открыть» в строке команды без активного администратора и открывает ту же панель. |

В панели команды три раздела:

| Раздел | Что можно сделать |
|---|---|
| Сведения и лимиты | «Название команды» (переименование; короткое имя остаётся прежним), «Статус», «Сканирований одновременно», «Хранить данные (дней)» и «Токенов ИИ в месяц». Нажмите «Сохранить». |
| Участники | Участники команды и их роли. «Добавить человека»: имя учётной записи и роль (здесь по умолчанию выбран «Администратор команды»), затем «Добавить». Существующая учётная запись добавляется сразу; для нового имени создаётся учётная запись и показывается одноразовая ссылка. Участников можно приостановить, возобновить или удалить. Если у команды нет активного администратора, панель предупредит об этом. |
| Опасная зона | «Удалить команду» или, пока удаление назначено, «Отменить удаление». |

Что разрешено каждой роли, описано в разделе [Команды и роли](https://scansuite.ru/documentation/administration/teams-and-roles).

### Статус

| Статус | Что означает |
|---|---|
| Активно | Команда работает как обычно. |
| Приостановлена | Данные сохраняются, но войти в команду и запускать сканирования нельзя. Сканирования, которые уже шли, останавливаются. |

### Лимиты

| Лимит | Что ограничивает |
|---|---|
| Сканирований одновременно | Сколько сканирований команда может одновременно держать в очереди и в работе. Если лимит исчерпан, новое сканирование отклоняется с объяснением, а запуск по расписанию пропускается и записывается в журнал. От 1 до 1000. |
| Хранить данные (дней) | Каждую ночь ScanSuite удаляет завершённые сканирования старше этого срока вместе с отчётами и файлами. Для каждого сочетания «продукт, тип сканирования, цель» последнее сканирование остаётся всегда: с ним сравниваются следующие сканирования. Уязвимости, активы и учётные данные не удаляются. От 1 до 3650 дней; если оставить поле пустым, данные хранятся бессрочно. |
| Токенов ИИ в месяц | Сколько токенов ИИ команда может потратить за месяц, в том числе через собственные модели. Если бюджет задала и сама команда, действует меньший. |

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

### Удаление

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

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

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

### Системный ИИ

В карточке **Системный ИИ** и в карточках под ней (**Маршрутизация задач**, **AI-подключения**, **AI-модели** и **Расход AI по задачам**) задаются модели, которыми пользуются все команды, если не настроили свои. Команды видят только названия этих моделей, но не подключения за ними. Кнопка **Проверить подключение** отправляет запрос первой модели маршрута по умолчанию; каждую модель можно проверить отдельно в карточке **AI-модели**. Все поля и то, как направить каждую задачу ИИ на нужную модель, описаны в разделе [Поставщики ИИ и стоимость](https://scansuite.ru/documentation/usage/ai-providers).

![Системный ИИ в настройках системы ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/platform-administration/02.png)

*Системный ИИ: маршрутизация задач, подключения и модели*

### Nessus, цены, сервис Git, язык

| Карточка | Что в ней | По умолчанию | Когда менять |
|---|---|---|---|
| Сканер Nessus | «Адрес», «Учётная запись» и «Пароль» сервера Nessus, на котором выполняются сканирования Nessus всех команд. Команды не видят ни адреса, ни учётной записи. Пароль отправляется только на тот адрес, с которым был сохранён, поэтому при смене адреса его нужно ввести заново; чтобы оставить сохранённый, не заполняйте поле. «Проверить подключение» проверяет сохранённые значения. | Не задан | Когда команде нужны сканирования Nessus. |
| Ресурс Nessus | «Осталось запусков»: сколько запусков Nessus осталось у всех команд вместе; каждое завершённое сканирование Nessus расходует один. При нуле сканирования Nessus отклоняются, пока вы не добавите запуски. | Пусто (без ограничений) | Если лицензия Nessus ограничивает число сканирований. |
| Цены LLM | «Таблица цен (JSON)»: цена в долларах США за миллион токенов для каждой модели. Когда у модели есть цена, стоимость вызовов ИИ видна в сканированиях, в истории и на панелях. Под полем перечислены модели, которые уже использовали команды. | Пусто (стоимость не показывается) | Если нужно видеть расходы на ИИ. |
| Сервис Git | Где находятся репозитории всех команд: «Сервис» (GitLab, Bitbucket или GitHub); для Bitbucket также «Адрес Bitbucket» и «Шаблон адреса клонирования по SSH». github.com, gitlab.com и bitbucket.org распознаются по адресу независимо от этой настройки. | GitLab | Если ваш собственный Git-сервер — Bitbucket или GitHub. |
| Язык интерфейса | «Язык по умолчанию»: язык, который видят люди, пока не выберут свой на странице «Моя учётная запись», в том числе на странице входа. English или Русский. | English | Если большинству пользователей нужен русский. |
| Новые команды получают | Справка: лимиты новой команды (два сканирования одновременно, хранение 365 дней, без лимита токенов ИИ) и срок хранения данных удалённой команды (30 дней). Заданы для установки. | — | Не меняется. |

Как сервис Git и ключи SSH дают сканированиям доступ к закрытым репозиториям, описано в разделе [Аутентификация в Git-репозитории](https://scansuite.ru/documentation/usage/static-code-analysis/git-repository-authentication).

Язык, который человек выбрал на странице своей учётной записи, хранится в его браузере, и язык по умолчанию его не меняет. См. [Участники и учётные записи](https://scansuite.ru/documentation/administration/user-administration).

![Сканер Nessus и его ресурс в ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/platform-administration/03.png)

*Сканер Nessus и оставшиеся запуски*

Цены задаются таблицей в формате JSON, где ключ — точное название модели. Модель системного ИИ указывается под тем названием, которое видят команды, например `Strong (system)`; собственная модель команды — под названием модели:

```json
{
  "Strong (system)": {"prompt": 3, "completion": 15},
  "qwen3-coder-30b": {"prompt": 0.2, "completion": 0.6}
}
```

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

![ScanSuite Общие сервисы](https://scansuite.ru/static/assets/img/docs/administration/platform-administration/07.png)

*Общие сервисы: цены LLM, Git-сервис и язык интерфейса*

## Вход и доступ

В карточке **Единый вход (SSO)** подключают поставщика удостоверений установки; все поля описаны в разделе [Единый вход](https://scansuite.ru/documentation/administration/single-sign-on).

В карточке **Администраторы системы** перечислены учётные записи, которые могут открывать настройки системы, со столбцами **Учётная запись** и **Состояние учётной записи**. Чтобы добавить администратора, введите имя существующей учётной записи в разделе **Добавить администратора** и нажмите **Добавить**. Учётная запись должна уже существовать. Хотя бы один администратор системы остаётся всегда: последнего снять нельзя.

## Секреты

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

![Сохранённые секреты ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/platform-administration/04.png)

*Сохранённые секреты: версии, их назначение и состояние*

### Смена ключей шифрования

Сохранённые пароли и ключи (интеграции и учётные данные для сканирования команд, системный ИИ, Nessus и единый вход, а также личные ключи репозиториев) шифруются ключами из файла `/opt/scansuite/key/scansuite-secrets.env`. `SCANSUITE_WRAPPING_KEYS` в нём — это JSON-объект из имён ключей и 256-битных ключей в base64; `SCANSUITE_ACTIVE_WRAPPING_KEY` — имя ключа, которым шифруются новые секреты.

> **Внимание:** Сначала сделайте резервную копию секретов (./scansuite --backup-secrets) и не удаляйте старый ключ из файла, пока не пройдёт проверка ниже. Если удалить ключ, которым ещё зашифрованы секреты, их будет невозможно прочитать.

1. **Сгенерируйте новый ключ**

   Команда выводит случайный 256-битный ключ в base64.

   ```bash
   openssl rand -base64 32
   ```
2. **Добавьте его в key/scansuite-secrets.env**

   Отредактируйте файл от имени root: добавьте новый ключ в JSON-объект SCANSUITE_WRAPPING_KEYS под новым именем, например "k2", сохранив старый, и укажите это имя в SCANSUITE_ACTIVE_WRAPPING_KEY.
3. **Перезапустите ScanSuite, чтобы новые значения попали в .env**

   ```bash
   cd /opt/scansuite && ./scansuite restart
   ```
4. **Перешифруйте сохранённые секреты**

   Для каждой области команда выводит, сколько секретов перешифровано. Параметр --scope team, platform или user ограничивает её одним видом; по умолчанию all.

   ```bash
   cd /opt/scansuite && docker compose run --rm migrate python -m configuration.rewrap
   ```
5. **Проверьте, что на старом ключе ничего не осталось**

   Ожидаемый результат: для team, platform и user выводится "secrets on old keys: none", и команда завершается с кодом 0. Пока старые ключи используются, она завершается с кодом 1.

   ```bash
   cd /opt/scansuite && docker compose run --rm migrate python -m configuration.rewrap --check
   ```
6. **Удалите старый ключ**

   Только после успешной проверки: удалите старую запись из SCANSUITE_WRAPPING_KEYS, выполните ./scansuite restart и сделайте новую резервную копию секретов.

> **Внимание:** Не пропускайте перезапуск: команда rewrap читает ключи из окружения. Без перезапуска она увидит прежний активный ключ и сообщит, что перешифровывать нечего.

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

Плитка **Состояние сервисов** на вкладке **Обзор** показывает, работают ли база данных и сервис сессий. Полную проверку сервера выполняет `./scansuite doctor`, см. [Параметры настройки и сервисы](https://scansuite.ru/documentation/administration/setup-parameters-and-services).

Для скрипта мониторинга на сервере запустите встроенную проверку состояния установки. Она выводит отчёт в формате JSON и завершается строкой `MONITOR: OK` (код выхода 0) или `MONITOR: ALERT` (код выхода 1) со списком предупреждений — например, о команде без активного администратора или о сканированиях, которые идут дольше 48 часов:

```bash
cd /opt/scansuite && docker compose exec -T web python -m database.deploy monitor
```

Адрес `/admin/health` отвечает только вошедшему администратору системы (остальные получают «Not found» или страницу входа), поэтому для внешнего мониторинга он не подходит. Он возвращает `status` и `teams_without_admin` — короткие имена активных команд без активного администратора, а если база данных или сервис сессий недоступны, отвечает кодом 503.

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

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

```bash
cd /opt/scansuite && docker compose exec web python -m authentication.recover --grant-installation-admin <USER_NAME>
```

`<USER_NAME>` — имя учётной записи, как оно показано на странице «Моя учётная запись». Ожидаемый вывод: `<USER_NAME> administers the installation. The grant is in the audit log.` Назначение записывается в журнал активности системы.
