Установка в Microsoft Azure
Развёртывание ScanSuite Teams в собственной подписке Azure на Container Apps с помощью Terraform, с примерами установки.
ScanSuite Teams можно развернуть не на сервере, а в собственной подписке Azure. Конфигурация Terraform из папки azure репозитория установки создаёт всё одной командой и удаляет другой. Приложение работает в Azure Container Apps вместе с управляемыми сервисами, так что обслуживать виртуальную машину не нужно. Первое развёртывание занимает 30–40 минут.
В Container Apps нет демона Docker, поэтому сканеры, которые запускаются отдельными контейнерами, — динамическое сканирование веб-приложений (DAST), сканирование инфраструктуры и AI-пентест — здесь не работают. Анализ кода (SAST), зависимостей (SCA), инфраструктуры как кода, поиск секретов и AI-анализ кода работают полностью. Для остальных видов сканирования установите ScanSuite на сервер: Установка ScanSuite Teams.
Что создаётся
Всё размещается в одной группе ресурсов, которую создаёт развёртывание. Секреты генерируются при первом развёртывании и хранятся в Key Vault. База данных доступна только изнутри виртуальной сети, а хранилище артефактов — только из подсети Container Apps, без ключей хранилища.
| Часть | Как работает |
|---|---|
| Веб-интерфейс и API | Приложение-контейнер с управляемым TLS; входящий трафик пропускается только с ваших диапазонов адресов. |
| Фоновые воркеры | Приложения-контейнеры: обслуживание и восстановление прерванных сканирований, планировщик, Redis для очереди задач и песочница для AI-проверок proof-of-concept, которая запускается по требованию. |
| Сканирования | Отдельный запуск задания Container Apps на каждое сканирование, 4 vCPU и 8 ГиБ; после сканирования он завершается. |
| Миграция базы данных | Задание Container Apps, которое запускает deploy.sh. |
| База данных | Azure Database for PostgreSQL 16 (Flexible Server), внутренняя; резервные копии за 7 дней, а с environment = "prod" — за 14 дней и зонально-избыточная резервная реплика. |
| Артефакты сканирований | Blob Storage, доступ через управляемое удостоверение; прежние версии хранятся 30 дней. |
| Образы | Собственный Azure Container Registry: во время работы установка ничего не загружает из интернета. |
| Журналы и оповещения | Log Analytics, по умолчанию не больше 1 ГБ в день. Оповещения об ошибках, неудачных сканированиях и нагрузке на базу данных создаются, только если задан alert_email. |
1. Перед началом
| Условие | Проверка | Ожидаемый результат |
|---|---|---|
| Azure CLI 2.60 или новее | az version --query '"azure-cli"' -o tsv | 2.60.0 или новее |
| Terraform 1.6 или новее | terraform version | Terraform v1.6.0 или новее |
| git и bash (Linux, macOS или Windows с WSL или Git Bash) | git --version; bash --version | head -1 | по строке с версией для каждого |
| Роль Owner в подписке или Contributor вместе с Role Based Access Control Administrator (развёртывание создаёт управляемые удостоверения, собственную роль и назначения ролей); проверяется после шага 3 | az role assignment list --assignee <YOUR_ACCOUNT> --scope /subscriptions/<SUBSCRIPTION_ID> --include-inherited --query "[].roleDefinitionName" -o tsv | Owner или обе роли: Contributor и Role Based Access Control Administrator |
| Файл лицензии, имя пользователя и токен доступа к реестру из заказа | — | См. шаг 2 |
| Ваш публичный IPv4-адрес или диапазоны, с которых разрешено открывать веб-интерфейс | curl -4 -s https://ifconfig.me | IPv4-адрес; запрашивайте именно IPv4, иначе многие подключения покажут IPv6 |
По инструкции https://scansuite.ru/documentation/installation/install-on-azure проверь мои предварительные требования, напиши terraform.tfvars для <пробной|производственной> установки в подписке <SUBSCRIPTION_ID> с моим IPv4-адресом в web_allowed_cidrs, выполни terraform init и terraform plan и покажи мне оба результата. Не запускай ./deploy.sh и ./destroy.sh, пока я не скажу. az login и экспорт DOCKERHUB_USERNAME и DOCKERHUB_TOKEN я выполню сам; никогда не спрашивай у меня токен.Вставьте его в Claude Code или другой ИИ-агент для разработки. Подробнее — в разделе Работа с ИИ-агентами.
Обозначения на этой странице:
| Обозначение | Откуда взять |
|---|---|
| <SUBSCRIPTION_ID> | Подписка, в которую выполняется развёртывание: az account list -o table, столбец SubscriptionId. |
| <YOUR_ACCOUNT> | Ваше имя для входа в Azure: az account show --query user.name -o tsv. |
| <LICENCE_CODE> | Шесть символов после последнего подчёркивания в имени файла лицензии, <имя>_<LICENCE_CODE>.lic. Это же и тег образов. |
| <REGISTRY_USER> | Имя пользователя реестра, присланное с заказом. |
| <YOUR_IPV4> | Вывод curl -4 -s https://ifconfig.me или диапазоны вашего офиса и VPN. |
| <RESOURCE_GROUP> | Значение resource_group_name, заданное в terraform.tfvars. |
| <RESOURCE> | Для Azure OpenAI: имя вашего ресурса Azure OpenAI. |
2. Загрузите файлы установки
git clone https://github.com/cepxeo/scansuite.git
cp /path/to/<имя>_<LICENCE_CODE>.lic scansuite/key/
cd scansuite/azure
ls ../key/*.licОжидаемый результат: в списке ровно один файл .lic. Если их несколько, задайте pyarmor_license_file.
3. Войдите в Azure
Войдите в открывшемся браузере и выберите подписку:
az login
az account set --subscription <SUBSCRIPTION_ID>Проверьте:
az account show --query "{subscription:id, user:user.name}" -o tsvОжидаемый результат: ID подписки и ваше имя для входа. Затем выполните проверку ролей из шага 1.
4. Задайте настройки
Скопируйте пример настроек и отредактируйте копию. Готовые примеры — в разделе 7, все параметры перечислены в справочнике параметров.
cp terraform.tfvars.example terraform.tfvars| Параметр | Что указать | По умолчанию |
|---|---|---|
| subscription_id | ID подписки. | обязательно |
| location | Регион, например germanywestcentral, swedencentral или northeurope. | germanywestcentral |
| resource_group_name | Имя новой группы ресурсов. Её создаёт развёртывание, поэтому такой группы ещё не должно быть. | rg-scansuite-dev |
| environment | dev или prod (см. справочник параметров). | dev |
| image_tag | Код вашей лицензии. | обязательно |
| web_allowed_cidrs | Диапазоны адресов, с которых открывается интерфейс, например ["203.0.113.10/32"]. Задайте до первого развёртывания: страница начальной настройки достаётся тому, кто первым её откроет. | открыто для всего интернета |
| timezone | Часовой пояс, по которому запускаются запланированные сканирования. | Europe/Berlin |
| alert_email | Адрес для оповещений. Без него оповещения не создаются. | нет |
Предварительный просмотр, который ничего не меняет (необязательно):
terraform init && terraform planОжидаемый результат: Plan: N to add, 0 to change, 0 to destroy.
5. Разверните
./deploy.sh создаёт и изменяет ресурсы без дополнительных вопросов: запуск скрипта и есть согласие. Передайте учётные данные реестра в оболочку сами — они нужны только для копирования образов в ваш реестр и нигде не сохраняются:
export DOCKERHUB_USERNAME='<REGISTRY_USER>'
read -rsp 'Registry access token: ' DOCKERHUB_TOKEN; echo; export DOCKERHUB_TOKEN
./deploy.shДо того как что-либо создавать, скрипт проверяет инструменты, вход в Azure, лицензию и то, может ли ваша подписка создать PostgreSQL в выбранном регионе. Затем он создаёт сеть, базу данных, Key Vault, хранилище, реестр, среду Container Apps и Redis (это занимает больше всего времени); копирует образы ScanSuite в ваш реестр; запускает веб-интерфейс и воркеры и выполняет миграцию базы данных. Повторный запуск безопасен на любом этапе.
Если в Docker на этой же машине уже есть образы для кода вашей лицензии, например от установки на сервер, deploy.sh загрузит эти локальные копии вместо копирования из реестра; удалите их заранее, если они могли устареть.
Ожидаемый результат: вывод заканчивается строкой ==> Done, значениями выводов и списком Next. Проверьте, что страница начальной настройки отвечает:
terraform output url
curl -sk -o /dev/null -w '%{http_code}\n' "$(terraform output -raw url)/setup"Ожидаемый результат: адрес, затем 200.
6. Войдите и подключите AI
Сразу откройте адрес из вывода url и создайте первую учётную запись на странице начальной настройки, придумав пароль сами, — так же, как на сервере, см. шаг «Создайте первую учётную запись» в разделе об установке ScanSuite Teams на сервер. Учётная запись достаётся тому, кто первым откроет страницу.
Поля и проверки те же, что на сервере: Установка ScanSuite Teams, шаг 5. Затем подключите AI-провайдера — без контейнеров сканеров анализ выполняет модель, так что этот шаг обязателен. В меню пользователя (справа вверху) откройте Настройки системы → Общие сервисы:
- AI-подключения → Добавить подключение. Для Azure OpenAI: Тип OpenAI-compatible, URL API
https://<RESOURCE>.openai.azure.com/openai/v1, API-ключ — ключ ресурса. Подойдёт и любой другой поддерживаемый провайдер. Нажмите Сохранить. - AI-модели → Добавить модель: Название, Подключение, а в поле ID модели — имя развёртывания Azure OpenAI. Нажмите Сохранить.
- Маршрутизация задач → Изменение в строке По умолчанию → Первая модель → Сохранить.
- Системный ИИ → Проверить подключение. Ожидаемый результат: Ответ за N с: …
Введите ключ Azure OpenAI в поле API-ключ сами и никогда не вставляйте его в чат.
Если ваш AI-провайдер принимает запросы только с адресов из списка, добавьте постоянный исходящий адрес (пример C). Все поля и маршрутизация по задачам описаны в разделе Поставщики ИИ и стоимость. Затем переходите к разделу Быстрый старт.
7. Примеры установки
Примеры A и B — готовые файлы terraform.tfvars; C–E — строки, которые добавляются к одному из них. Учётные данные реестра всегда передаются через оболочку, как в шаге 5.
A. Пробная установка
Небольшие размеры dev, интерфейс открыт для одного адреса:
subscription_id = "00000000-0000-0000-0000-000000000000"
location = "swedencentral"
resource_group_name = "rg-scansuite-trial"
environment = "dev"
image_tag = "a1b2c3"
web_allowed_cidrs = ["203.0.113.10/32"]
timezone = "Europe/Moscow"
# Холодный старт вместо постоянно прогретого интерфейса: первый вход после
# перерыва ждёт около минуты.
web_min_replicas = 0Когда пробный период закончится, ./destroy.sh удалит всю группу ресурсов.
B. Производственная установка
Зонально-избыточная база данных с резервной репликой, зонально-избыточное хранилище, реестр Premium, защита Key Vault от окончательного удаления и выделенный профиль вычислений для сканирований, а также постоянный исходящий адрес и журналы без ограничения объёма:
subscription_id = "00000000-0000-0000-0000-000000000000"
location = "germanywestcentral"
resource_group_name = "rg-scansuite"
environment = "prod"
image_tag = "a1b2c3"
web_allowed_cidrs = ["198.51.100.0/24", "203.0.113.10/32"] # офис и VPN
timezone = "Europe/Moscow"
alert_email = "secops@acme.example"
postgres_sku = "GP_Standard_D2ds_v5"
enable_nat_gateway = true
log_daily_quota_gb = -1Это на несколько сотен долларов в месяц дороже, чем dev. Прежде чем развёртыванием займётся кто-то ещё, перенесите состояние Terraform в Azure Storage, как описано в backend.tf.example.
C. Постоянный исходящий адрес
Иначе исходящий трафик уходит с адреса среды, который может меняться. Если git-сервер или AI-провайдер принимает только адреса из списка, добавьте NAT-шлюз (около 35 долларов в месяц плюс трафик); адрес, который нужно разрешить, будет в выводе egress_ip:
enable_nat_gateway = trueD. Вторая установка в той же подписке
Например, тестовая рядом с производственной. Разворачивайте её из отдельной копии папки, чтобы у неё было своё состояние Terraform (cp -r scansuite/azure scansuite/azure-test), в собственную группу ресурсов. Глобально уникальные имена получают случайный суффикс, так что больше ничего менять не нужно:
resource_group_name = "rg-scansuite-test"E. Регион, где PostgreSQL вам недоступен
Некоторые типы подписок, в том числе Visual Studio, не могут создать PostgreSQL в любом регионе; deploy.sh сообщает об этом, ещё ничего не создав. Выберите другой регион:
location = "swedencentral" # или northeurope, francecentral8. Справочник параметров
Все параметры terraform.tfvars. Чтобы изменить параметр, отредактируйте файл и снова запустите ./deploy.sh.
Размещение
| Параметр | Что делает | По умолчанию | Когда менять |
|---|---|---|---|
| subscription_id | Подписка, в которую выполняется развёртывание. | обязательно | — |
| location | Регион. | germanywestcentral | Ваш регион; другой, если PostgreSQL недоступен (пример E). |
| resource_group_name | Группа ресурсов, которую развёртывание создаёт для всего. | rg-scansuite-dev | Всегда: задайте собственное имя. |
| name_prefix | Префикс имён всех ресурсов: от 3 до 12 строчных латинских букв и цифр, начинается с буквы. | scansuite | Редко; глобально уникальные имена и так получают случайный суффикс. |
| environment | dev или prod: зонально-избыточный PostgreSQL с резервной репликой и резервными копиями за 14 дней, реестр Premium, зонально-избыточное хранилище, защита Key Vault от окончательного удаления и выделенный профиль вычислений для сканирований. | dev | prod для производственной установки. |
| tags | Теги, добавляемые ко всем ресурсам, например { owner = "secops" }. | нет | Ваша политика тегов. |
| timezone | Часовой пояс контейнеров; по нему запускаются запланированные сканирования. | Europe/Berlin | Ваш часовой пояс. |
| alert_email | Куда отправляются оповещения. Если пусто, оповещения не создаются вовсе. | нет | Производственная установка. |
Сеть и доступ
| Параметр | Что делает | По умолчанию | Когда менять |
|---|---|---|---|
| web_allowed_cidrs | Диапазоны, которые пропускает входной шлюз интерфейса. | пусто: весь интернет | Всегда, до первого развёртывания. |
| enable_nat_gateway | Постоянный исходящий адрес, вывод egress_ip (около 35 долларов в месяц плюс трафик). | false | Ваш git-сервер или AI-провайдер принимает только адреса из списка. |
| vnet_cidr | Виртуальная сеть. | 10.40.0.0/16 | Она пересекается с сетью, с которой вы будете устанавливать пиринг. |
| aca_subnet_cidr | Подсеть Container Apps; /23 оставляет запас для роста. | 10.40.0.0/23 | Вместе с vnet_cidr. |
| postgres_subnet_cidr | Подсеть базы данных. | 10.40.2.0/28 | Вместе с vnet_cidr. |
Образы и лицензия
| Параметр | Что делает | По умолчанию | Когда менять |
|---|---|---|---|
| image_tag | Код вашей лицензии: тег трёх образов. | обязательно | Каждый новый релиз. |
| image_registry | Откуда deploy.sh копирует образы. | docker.io/appsec4u | Не меняйте. |
| image_digests | Записывает deploy.sh в images.auto.tfvars.json. | — | Никогда вручную. |
| key_dir | Папка с файлом лицензии. | ../key | Лицензия лежит в другом месте. |
| pyarmor_license_file | Имя файла лицензии в key_dir. | единственный .lic там | В key_dir их несколько. |
| deploy_workloads | false создаёт только платформу (сеть, данные, удостоверения, реестр, среду), для которой не нужны ни лицензия, ни образы. | true | Подготовить платформу до получения лицензии. |
| worker_poc_installation_secrets | Передать песочнице proof-of-concept ключи установки. | false | Только по просьбе поддержки, для образов старше этого релиза. |
Ресурсы и данные
| Параметр | Что делает | По умолчанию | Когда менять |
|---|---|---|---|
| scan_cpu | vCPU на сканирование, не больше 4. | 4 | Редко. |
| scan_memory | Память на сканирование; Container Apps допускает 2 ГиБ на vCPU. | 8Gi | Вместе с scan_cpu. |
| scan_timeout_seconds | Максимальная длительность сканирования. | 172800 (48 часов) | Редко. |
| web_min_replicas | Постоянно прогретые реплики веб-интерфейса. | 1 | 0 экономит деньги; первый вход после перерыва ждёт около минуты. |
| web_max_replicas | Максимум реплик веб-интерфейса. | 2 | Много одновременных пользователей. |
| postgres_sku | Размер базы данных. B_Standard_B1ms допускает около 50 подключений, B_Standard_B2s — около 430. | B_Standard_B1ms | B_Standard_B2s или GP_Standard_D2ds_v5 для производственной установки. |
| postgres_storage_mb | Хранилище базы данных в МБ. | 32768 | Много сканирований, которые долго хранятся. |
| artifact_retention_days | Сколько дней хранятся прежние версии сохранённых артефактов. | 30 | Ваша политика хранения. |
| log_daily_quota_gb | Дневной лимит Log Analytics в ГБ; -1 снимает его. | 1 | -1 для производственной установки. |
| enable_static_scans | Статический анализ. | True | Не трогайте. |
| enable_dynamic_scans | Динамические и инфраструктурные сканирования, которым нужен демон Docker, а в этом развёртывании его нет. | False | Не трогайте. |
Переменные окружения и параметры скриптов
| Переменная или параметр | Где используется | Что делает |
|---|---|---|
| DOCKERHUB_USERNAME, DOCKERHUB_TOKEN | deploy.sh | Учётные данные реестра, с которыми копируются образы. Вводит человек, нигде не хранятся. |
| TF_VAR_subscription_id | deploy.sh | Подписка — вместо subscription_id в terraform.tfvars. |
| MIGRATE=1 | deploy.sh | Выполнить миграцию базы данных, даже если образы не изменились. Она отменяет идущие сканирования. |
| дополнительные аргументы | deploy.sh, destroy.sh | Передаются terraform apply или destroy. |
| -y | destroy.sh | Не спрашивать имя группы ресурсов. Указывается первым: ./destroy.sh -y. |
Выводы
| Вывод | Что это |
|---|---|
| url | Адрес ScanSuite. |
| resource_group | Группа ресурсов, в которой находится всё. |
| egress_ip | Постоянный исходящий адрес, при enable_nat_gateway. |
| environment_static_ip | Входящий адрес среды Container Apps. |
| registry | Реестр контейнеров, в который копируются образы. |
| key_vault | Key Vault со сгенерированными секретами. |
| postgres_fqdn | Имя сервера базы данных, доступное только изнутри сети. |
| log_analytics_workspace_id | Рабочая область Log Analytics, для az monitor log-analytics query. |
| migrate_job_name, sast_job_name | Задание миграции и задание сканирования. |
9. Повседневная работа
- Изменить настройку: отредактируйте
terraform.tfvarsи снова запустите./deploy.sh. Пока образы не меняются, идущие сканирования продолжаются. - Новый релиз: положите новый
.licв../key/и удалите старый, задайте вimage_tagновый код, выполнитеgit pull, а затем./deploy.sh. Миграция отменяет незавершённые сканирования, поэтому обновляйтесь, когда сканирований нет. - Прерванные сканирования восстанавливаются сами: сканирование, контейнер которого остановил Azure, 90 минут не показывает прогресса, а затем запускается заново.
- Журналы: откройте рабочую область Log Analytics в группе ресурсов, выберите Logs и запросите
ContainerAppConsoleLogs_CLпоContainerAppName_s(например,scansuite-web) илиContainerJobName_s(scansuite-sastдля сканирований). - Экономия, когда установкой не пользуются:
web_min_replicas = 0, а базу данных можно остановить командойaz postgres flexible-server stop; через семь дней Azure запустит её сам. - Берегите состояние Terraform: в
terraform.tfstateхранятся сгенерированные пароли и ваша лицензия. Держите файл в закрытом месте, делайте резервную копию после каждого развёртывания и перенесите его в Azure Storage, прежде чем развёртывать будет второй человек или конвейер.
Ориентировочная стоимость в месяц для настроек dev по умолчанию, в долларах США; цены для своего региона уточните в калькуляторе Azure:
| Статья | Ориентировочно |
|---|---|
| Постоянно работающие контейнеры (веб, воркеры, планировщик, Redis) | 120–160 |
| PostgreSQL B_Standard_B1ms, 32 ГБ | 20 |
| Log Analytics, не больше 1 ГБ в день | 0–70 |
| Реестр, Key Vault, хранилище | около 10 |
| Сканирования, по 4 vCPU и 8 ГиБ | около 0,45 за час сканирования |
| NAT-шлюз, если включён | 35 плюс трафик |
10. Удаление
Удаление стирает базу данных со всеми данными сканирований. Решение запустить destroy.sh принимает человек, и он же вводит имя группы ресурсов, когда скрипт его спросит.
./destroy.shСкрипт примерно за 15 минут удаляет всё, что создало развёртывание. Проверьте:
az group show -n <RESOURCE_GROUP>Ожидаемый результат: Resource group '<RESOURCE_GROUP>' could not be found. Если скрипт остановился с сообщением polling support for the Content-Type "" was not implemented, Azure уже удалил то, что в нём названо: запустите скрипт снова, при необходимости два-три раза. С environment = "prod" Key Vault можно восстановить в течение срока его хранения.
PostgreSQL Flexible Server 16 is not available to this subscription: пример E. ManagedEnvironmentCapacityHeavyUsageError: в регионе сейчас нет места для новой среды; удалите неудавшуюся (az containerapp env delete) и повторите позже или в другом регионе. no licence for image tag: положите .lic в ../key/ и приведите image_tag в соответствие с его кодом. could not import docker.io/appsec4u/...: задайте учётные данные реестра в той же оболочке. Provider produced inconsistent result after apply после повторного создания развёртывания с тем же именем группы ресурсов: возьмите новое имя или подождите 15 минут. Адрес открывает страницу входа, а не страницу начальной настройки: первую учётную запись создал кто-то другой — выполните ./destroy.sh и разверните заново с более узким web_allowed_cidrs. Миграция завершается ошибкой: в сообщении назван запуск задания; его журнал — в Log Analytics, в ContainerAppConsoleLogs_CL, где ContainerGroupName_s начинается с этого имени (журнал появляется через несколько минут). Устраните причину и снова запустите ./deploy.sh.
Проверено: 2026-10-19