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

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

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

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

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

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

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

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

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

![Меню пользователя ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/teams-and-roles/01.png)

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

## Роли

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

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

- Роль **Менеджер уязвимостей** подходит аналитику, который разбирает результаты, но не запускает сканирования: он работает с уязвимостями, активами и учётными данными, но не может запускать сканирования и эксплойты и ничего не может удалять.
- Читатель видит, что учётные данные есть и где их нашли, но не видит самих значений.
- Читатель может скачать любой отчёт и любую выгрузку, которые есть на страницах.
- Сервисному аккаунту можно дать роль **Оператор** или **Читатель** (по умолчанию — Читатель), но не роль администратора команды.
- Группы единого входа сопоставляются с теми же четырьмя ролями, см. [Единый вход](https://scansuite.ru/documentation/administration/single-sign-on).

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

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

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

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

![Обзор команды в ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/teams-and-roles/02.png)

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

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

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

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

**Проверка:** выполненные пункты становятся зелёными, а в статусе карточки вместо *Осталось шагов: N* появляется **Готово**. Как добавлять участников, описано в разделе [Участники и учётные записи](https://scansuite.ru/documentation/administration/user-administration).

## ИИ команды

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

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

Кнопка **Проверить подключение** проверяет сохранённый вариант. Поля подключений и моделей и распределение задач описаны в разделе [Поставщики ИИ и стоимость](https://scansuite.ru/documentation/usage/ai-providers).

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

![Настройки ИИ команды в ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/teams-and-roles/03.png)

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

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

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

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

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

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

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

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

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

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

У первой команды, созданной на странице `/setup`, для веб- и инфраструктурных сканирований задано **Любые цели**; ограничьте список, прежде чем открывать доступ к установке другим. У команды, созданной в настройках системы, список пуст и включена проверка во время сканирования, поэтому до первого веб- или инфраструктурного сканирования администратор команды должен добавить цели. Сканирование с неразрешённой целью отклоняется, и в нём указываются цель и причина, см. [Управление выполнением сканирований](https://scansuite.ru/documentation/usage/managing-scan-execution). Правила записи целей в формах сканирования описаны в разделе [Сканирование веб-приложений](https://scansuite.ru/documentation/usage/web-app-scanning).

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

![Разрешённые цели команды в ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/teams-and-roles/04.png)

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

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

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

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

В карточке **Ключ SSH команды** хранится **Закрытый ключ**, которым по SSH клонируются закрытые репозитории для расписаний, сканирований из конвейеров и участников, которые не сохранили свой ключ на странице «Моя учётная запись». Ключ, защищённый парольной фразой, использовать нельзя. После сохранения в карточке виден отпечаток ключа; кнопка **Удалить** удаляет его. Как устроен доступ к репозиториям в целом — Git-сервис в настройках системы и личный ключ каждого участника, — описано в разделе [Аутентификация в Git-репозитории](https://scansuite.ru/documentation/usage/static-code-analysis/git-repository-authentication).

![Ключ SSH команды в ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/teams-and-roles/05.png)

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

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

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

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

Кнопка **Сохранить** сохраняет учётную запись, **Удалить** — удаляет. Учётные данные, найденные сканированием, тоже можно утвердить в качестве учётной записи сервера на странице **Учётные данные**, см. [Учётные данные](https://scansuite.ru/documentation/usage/credentials). Движки сканеров OpenVAS и Acunetix на той же вкладке описаны в разделе [API-ключи для внешних систем](https://scansuite.ru/documentation/administration/configuring-api-keys-for-external-systems).

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

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

В карточке **Сроки устранения** задаётся, сколько дней может оставаться открытой новая уязвимость каждой критичности. По умолчанию это 7 дней для Critical, 30 — для High, 90 — для Medium и 180 — для Low; 0 означает, что срока нет. Как работают сроки и просроченные уязвимости, описано в разделе [Управление уязвимостями](https://scansuite.ru/documentation/usage/vulnerability-management).

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

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

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

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

Как PDF-отчёты и слайды, выгружаемые со страниц **Продукты** и **Уязвимости**, представляют вашу команду (см. [Отчёты и экспорт](https://scansuite.ru/documentation/usage/reports-and-exports)):

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

## Интеграции

Трекеры задач, оповещения и сервисы обогащения на вкладке **Интеграции**, а также движки сканеров на вкладке **Сканирование** описаны в разделе [API-ключи для внешних систем](https://scansuite.ru/documentation/administration/configuring-api-keys-for-external-systems). Менять их могут администраторы команды и операторы.

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

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

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

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

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

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

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

> **Этот шаг выполняет человек:** Перенести токен из окна в хранилище секретов CI-системы должен человек. Токен показывается один раз и больше никогда.
>
> ИИ-агент не должен просить его в чате; он может ссылаться на него как на переменную CI, например SCANSUITE_TOKEN.

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

Токен никогда не может больше, чем разрешает роль его сервисного аккаунта. Он передаётся в заголовке `Authorization: Bearer <token>`; как его используют конвейеры, описано в разделе [CI/CD и автоматизация](https://scansuite.ru/documentation/reference/cicd).

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

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

![Сервисные аккаунты и API-токены в ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/teams-and-roles/06.png)

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

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

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

![Страница «Доступ запрещён» в ScanSuite](https://scansuite.ru/static/assets/img/docs/administration/teams-and-roles/07.png)

*Попытка открыть команду, в которой вы не состоите*
