Обзор

Быстрый старт

От чистого сервера до отчёта первого сканирования: установка, вход, подключение ИИ, создание продукта, сканирование.

Открыть в Markdown

От чистого Linux-сервера до отчёта первого сканирования — за шесть шагов. В каждом шаге сказано, как проверить, что он удался, и дана ссылка на страницу со всеми параметрами.

Хотите поручить это ИИ-агенту?

ИИ-агент с доступом к командной строке сервера может выполнить установку (шаг 1) за вас и остановиться на шагах, которые можете сделать только вы. Дайте ему эту страницу: https://scansuite.ru/documentation/quick-start.md. Шаги 2 и 3 вы выполняете в браузере. Шаги 4–6 агент выполняет через API команды: один раз создайте для него токен, как описано в разделе Подключение ИИ-агента, и он создаст продукт, запустит сканирование и прочитает результаты.

Перед началом

Что нужноПодробностиПроверка
Linux-серверРекомендуется Ubuntu 22.04 или новее, учётная запись без root с правом sudo. Размеры и другие системы — в разделе «Технические требования».. /etc/os-release; echo $ID $VERSION_ID
Файл лицензииВыдаёт ScanSuite: <name>_<LICENCE_CODE>.licls *.lic в папке, из которой ставите
Токен реестраВыдаёт ScanSuite, начинается с dckr_pat_Вы вводите его, когда установщик спросит
Модель ИИOpenAI-совместимый endpoint (облачный или в вашей сети) или Vertex AI (Claude) с API-ключомНужна на шаге 3
Репозиторий для сканированияЛюбой ваш Git-репозиторий; для публичного URL по HTTPS ключ не нужен—

Полные требования: Технические требования.

1. Установка

В папке, где лежит ровно один файл лицензии, выполните:

Терминал
bash -c "$(curl -sSL https://scansuite.ru/install-teams)"

Когда установщик выведет «Signing in to the image registry» и запросит Password, введите там токен реестра.

Проверка: вывод заканчивается строками [+] All services healthy и [+] ScanSuite Teams is installed in /opt/scansuite. Затем выполните:

Терминал
cd /opt/scansuite && ./scansuite doctor

Вывод заканчивается строкой [+] No problems found. Если нет — см. Устранение неполадок. Все параметры установщика описаны в разделе Установка ScanSuite Teams; для Google Cloud или Azure используйте вместо этого Установка в Google Cloud или Установка в Microsoft Azure.

2. Первая учётная запись

Откройте в браузере https://<YOUR_HOST>/setup (один раз примите предупреждение о самоподписанном сертификате или сначала настройте сертификат: Настройка SSL/TLS). Заполните поля Название команды, Имя пользователя, Пароль и Подтвердите пароль и нажмите Создать первую учётную запись. Пароль — не короче 8 символов, с заглавными и строчными буквами, цифрой и спецсимволом.

Сделайте это сразу после установки: учётную запись получает тот, кто первым откроет страницу.

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

3. Подключение модели ИИ

В формах сканирования по умолчанию выбраны ИИ-сканеры, и им нужна модель. Как администратор установки откройте меню пользователя (справа вверху) → Настройки системы → Общие сервисы:

  1. AI-подключения → Добавить подключение: название, тип (OpenAI-compatible или Vertex AI (Claude)), URL API и API-ключ → Сохранить.
  2. AI-модели → Добавить модель: название, подключение, идентификатор модели → Сохранить. Первая модель отвечает на все задачи ИИ.

Введите API-ключ (или JSON сервисного аккаунта Vertex) в форму сами. Перед сохранением настроек ИИ ScanSuite может попросить войти ещё раз.

Проверка: у модели статус Доступна, а Системный ИИ → Проверить подключение сообщает, что системный ИИ ответил. Все команды пользуются системным ИИ, если не зададут свой. Подробности, распределение задач по моделям и работа без передачи кода за пределы вашей сети: Поставщики ИИ и стоимость.

4. Создание продукта

Продукт объединяет всё, что сканируется для одного приложения. В боковом меню откройте Продукты → Новый продукт, введите Название продукта (уникальное в команде) и, если нужно, URL репозитория → Создать продукт.

Проверка: появляется сообщение Продукт создан или обновлён, а продукт — в списке. Подробнее, в том числе о создании продуктов через API: Продукты.

5. Первое сканирование

В боковом меню откройте Анализ кода → Git-репозиторий:

  1. Репозитории: URL для клонирования, например https://github.com/<org>/<repo>. (Или Загрузить ZIP — для архива с кодом.)
  2. Привязка к продукту: продукт из шага 4.
  3. Остальное оставьте по умолчанию: полное сканирование, все поддерживаемые языки и ИИ-сканеры (AI Native SAST, секреты с проверкой ИИ, проверка зависимостей с анализом достижимости).
  4. Нажмите Запустить анализ.

Проверка: появляется сообщение Сканирование создано, открывается страница сканирования и показывает ход работы. Для закрытого репозитория сначала нужен SSH-ключ: Аутентификация в Git-репозитории. Если в журнале сканирования сказано, что AI SAST не может запуститься, шаг 3 не выполнен.

6. Результаты

  • Отчёт: когда сканирование завершится, кнопка Скачать отчёт на странице сканирования (или Отчёт в его строке в Истории сканирований) отдаёт ZIP-архив с HTML, XLSX и JSON.
  • Уязвимости: пункт бокового меню Уязвимости, с выбранным продуктом. У каждой уязвимости есть вердикт проверки и доказательства, на которых он основан: как читать уязвимость.
  • Секреты, найденные в коде: пункт бокового меню Учётные данные.

Что дальше

Сканирование веб-приложений

Сканирование сайтов и веб-API, с входом и без, классическими сканерами, AI DAST или агентом ИИ-пентеста; правила целей для любого сканирования.

Проверки инфраструктуры

Поиск уязвимостей, обнаружение узлов в сети, контроль установки обновлений, OSINT по домену и образы контейнеров; по умолчанию — агент ИИ-пентеста.

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

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

CI/CD и автоматизация

Как запускать SAST, DAST и сканирование инфраструктуры из GitLab, GitHub, Jenkins, Azure DevOps, Bitbucket или скрипта по API-токену команды, проверять токен ключом --check и останавливать сборку, если найдены уязвимости.

Подключение ИИ-агента

Одна строка для Claude Code, Codex, Copilot или Cursor: агент устанавливает навык ScanSuite и подключается к вашему серверу.

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

Сканирование веб-приложений, инфраструктуры и кода по расписанию, управление на странице «Расписания» и запуск по расписанию из CI.

Сканирование веб-приложений и инфраструктуры запускается только против целей, разрешённых команде; их задаёт администратор команды на странице команды (Команды и роли).

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