Быстрый старт
От чистого сервера до отчёта первого сканирования: установка, вход, подключение ИИ, создание продукта, сканирование.
От чистого 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>.lic | ls *.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, введите там токен реестра.
Для этого AI-агент запускает установщик в терминале, в котором вы можете печатать; если установщик запущен без такого терминала, он останавливается с ошибкой «Registry sign-in failed», и его просто запускают снова в терминале.
Проверка: вывод заканчивается строками [+] 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. Подключение модели ИИ
В формах сканирования по умолчанию выбраны ИИ-сканеры, и им нужна модель. Как администратор установки откройте меню пользователя (справа вверху) → Настройки системы → Общие сервисы:
- AI-подключения → Добавить подключение: название, тип (OpenAI-compatible или Vertex AI (Claude)), URL API и API-ключ → Сохранить.
- AI-модели → Добавить модель: название, подключение, идентификатор модели → Сохранить. Первая модель отвечает на все задачи ИИ.
Введите API-ключ (или JSON сервисного аккаунта Vertex) в форму сами. Перед сохранением настроек ИИ ScanSuite может попросить войти ещё раз.
Проверка: у модели статус Доступна, а Системный ИИ → Проверить подключение сообщает, что системный ИИ ответил. Все команды пользуются системным ИИ, если не зададут свой. Подробности, распределение задач по моделям и работа без передачи кода за пределы вашей сети: Поставщики ИИ и стоимость.
4. Создание продукта
Продукт объединяет всё, что сканируется для одного приложения. В боковом меню откройте Продукты → Новый продукт, введите Название продукта (уникальное в команде) и, если нужно, URL репозитория → Создать продукт.
Проверка: появляется сообщение Продукт создан или обновлён, а продукт — в списке. Подробнее, в том числе о создании продуктов через API: Продукты.
5. Первое сканирование
В боковом меню откройте Анализ кода → Git-репозиторий:
- Репозитории: URL для клонирования, например
https://github.com/<org>/<repo>. (Или Загрузить ZIP — для архива с кодом.) - Привязка к продукту: продукт из шага 4.
- Остальное оставьте по умолчанию: полное сканирование, все поддерживаемые языки и ИИ-сканеры (AI Native SAST, секреты с проверкой ИИ, проверка зависимостей с анализом достижимости).
- Нажмите Запустить анализ.
Проверка: появляется сообщение Сканирование создано, открывается страница сканирования и показывает ход работы. Для закрытого репозитория сначала нужен 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