Что получится
Репозиторий, в котором описаны группа безопасности с правилами, ваш SSH-ключ, машина с этой группой и SSH-доступ коллеги «только выбранными ключами». terraform plan показывает каждое изменение доступа до того, как оно применится, а отзыв доступа — это удаление блока в коде.
Что понадобится
- Готовый проект Terraform с провайдером и state в S3 — из сценария «Инфраструктура как код».
- Провайдер h3llo-cloud/h3 версии 0.3 и CLI
h3той же версии. - Коллега, которая уже участник проекта (не «Наблюдатель») и добавила свой SSH-ключ в профиль.
-
Шаг 1. Закрепите провайдер 0.3 и узнайте ID пользователей
SSH-ключи принадлежат пользователю, поэтому
h3_ssh_keyиh3_vm_ssh_accessпринимают ID пользователя. Список участников проекта с их ID и ключами возвращает API машин.Terraform
versions.tfterraform { required_providers { h3 = { source = "h3llo-cloud/h3" version = "~> 0.3.0" } } } # H3_KEY_ID, H3_SECRET_KEY и H3_PROJECT_ID — из окружения provider "h3" {}CLI
Терминалh3 api GET /api/vms/v1/ssh-access/members -f projectId=$H3_PROJECT_ID \ | jq '.items[] | {email, role, id: (.userId // .user_id), keys: [.keys[] | {name, type, id: (.keyId // .key_id)}]}'terraform.tfvarsmy_user_id = "<ваш ID из списка выше>" alice_user_id = "<ID коллеги>" alice_ssh_key_id = "<ID её ключа>"Проверка
terraform init -upgradeскачал провайдерh3llo-cloud/h3 v0.3.x. В выводеh3 apiвы видите себя и коллегу; у участника с ролью наблюдателяeligible: false— ему доступ не выдать. -
Шаг 2. Опишите группу безопасности и её правила
Группа с блоками
ruleвладеет всем набором правил: правило, добавленное вручную в консоли, следующийapplyудалит. Это и есть смысл файрвола как кода. Если правила нужно добавлять из разных модулей, оставьте группу безruleи описывайте их ресурсамиh3_security_group_rule— но не смешивайте оба способа на одной группе.Terraform
firewall.tfvariable "office_cidr" { type = string default = "198.51.100.0/24" } resource "h3_security_group" "app" { name = "app" description = "managed by terraform" rule { direction = "ingress" protocol = "tcp" port_from = 22 remote_cidr = var.office_cidr description = "SSH только из офиса" } rule { direction = "ingress" protocol = "tcp" port_from = 443 remote_cidr = "0.0.0.0/0" description = "HTTPS" } rule { direction = "egress" remote_cidr = "0.0.0.0/0" } }CLI
ТерминалSG=$(h3 sg create --name app --description "managed by script" -o json | jq -r '.id') h3 sg rule add "$SG" --direction ingress --protocol tcp --port-from 22 --port-to 22 \ --remote-cidr 198.51.100.0/24 --description "SSH только из офиса" h3 sg rule add "$SG" --direction ingress --protocol tcp --port-from 443 --port-to 443 \ --remote-cidr 0.0.0.0/0 --description "HTTPS" h3 sg get "$SG"Проверка
terraform planпоказываетh3_security_group.app will be createdс тремя правилами. Послеapplyв консоли, раздел Группы безопасности, группаappв статусе «Применена».Если не получилось
- Правило «22 с
0.0.0.0/0» консоль помечает предупреждением «Порт откроется всему интернету» — в коде такого предупреждения нет, поэтому смотрите наremote_cidrв ревью.
- Правило «22 с
-
Шаг 3. Опишите свой ключ и машину с этой группой
ssh_key_ids— это ваш собственный доступ к машине в режиме «выбранные ключи». В 0.3 он меняется на месте, без пересоздания машины и без перезагрузки, когда включено управление ключами через агента (ssh_access_managed, по умолчанию у образов с qemu-guest-agent).Terraform
vm.tfvariable "my_user_id" { type = string } resource "h3_ssh_key" "me" { user_id = var.my_user_id # владелец API-ключа name = "me-laptop" public_key = file("~/.ssh/id_ed25519.pub") } resource "h3_vm" "app" { name = "app-1" cpu = 2 memory = "4Gi" image = "ubuntu:24.04" disk_size = "25Gi" white_ip = true ssh_key_ids = [h3_ssh_key.me.id] lifecycle { prevent_destroy = true } } # группы машины целиком: перечисленные заменяют всё, что было resource "h3_vm_security_groups" "app" { vm_id = h3_vm.app.id security_group_ids = [h3_security_group.app.id] }CLI
Терминалh3 config set user_id <ваш ID> KEY=$(h3 ssh create --name me-laptop --key-file ~/.ssh/id_ed25519.pub -o json | jq -r '.id') h3 vm create --name app-1 --image ubuntu:24.04 --cpu 2 --memory 4Gi --ssh-key-ids "$KEY" --white-ip h3 sg vm set <vm-id> --groups "$SG"Проверка
После
applyвход работает:ssh user@$(terraform output -raw app_ip)(добавьтеoutput "app_ip" { value = h3_vm.app.endpoint }). В карточке машины в секции «Группы безопасности» — толькоapp.Если не получилось
- Без
h3_vm_security_groupsмашина остаётся в группеdefault, которая пропускает весь трафик. - Ключи, вписанные в
/home/user/.ssh/authorized_keysруками, агент удаляет. Свои ключи вне платформы держите в~/.ssh/authorized_keys2.
- Без
-
Шаг 4. Выдайте доступ коллеге кодом
mode = "selected"пускает только перечисленные ключи коллеги;mode = "all"— все её текущие и будущие ключи из профиля. Для прода беритеselected: новый ключ на ноутбуке коллеги не должен сам попадать на боевые машины.Terraform
access.tfvariable "alice_user_id" { type = string } variable "alice_ssh_key_id" { type = string } resource "h3_vm_ssh_access" "alice" { vm_id = h3_vm.app.id user_id = var.alice_user_id mode = "selected" key_ids = [var.alice_ssh_key_id] }CLI
Терминалh3 vm ssh-access grant <vm-id> <ID коллеги> --mode selected --key-ids <ID её ключа> h3 vm ssh-access get <vm-id>Проверка
terraform planпоказывает одну записьh3_vm_ssh_access.alice will be created. Послеapplyв карточке машины коллега в списке «Участники с доступом», статус «Применено» примерно через 2 минуты, а в «Журнал доступа» — «выдал доступ».Если не получилось
SSH_GRANTEE_VIEWER— у коллеги роль «Наблюдатель», ей SSH не выдаётся.SSH_KEY_NOT_OWNED— ID ключа принадлежит другому человеку.
-
Шаг 5. Меняйте доступ через merge request
Теперь доступ — обычный код. Отозвать доступ — удалить блок
h3_vm_ssh_access; открыть порт — добавитьrule. Ревьюер видит изменение в diff, аterraform planв MR показывает, что именно поменяется.Отзыв доступа коллеги# удалите resource "h3_vm_ssh_access" "alice" из access.tf terraform plan # h3_vm_ssh_access.alice will be destroyed terraform applyПрава, выданные мимо Terraform (в консоли),
planпокажет как расхождение для правил группы с блокамиrule. Гранты других участников, которых нет в коде, Terraform не трогает — их видно вh3 vm ssh-access get.Проверка
Коллеги больше нет в списке «Участники с доступом», в «Журнал доступа» — «отозвал доступ». Её ключ удалён из машины примерно за 2 минуты; уже открытые SSH-сессии не закрываются.
Проверка результата
Код и облако совпадают: plan пустой. Проверьте снаружи, что SSH пускает только из office_cidr, а HTTPS открыт всем.
terraform plan -detailed-exitcode; echo "exit=$?" # 0 — изменений нет
h3 sg get "$(terraform console <<< 'h3_security_group.app.id' | tr -d '"')"
h3 vm ssh-access get "$(terraform console <<< 'h3_vm.app.id' | tr -d '"')" Как удалить ресурсы
terraform destroy удаляет всё, что описано. У машины стоит prevent_destroy — сначала уберите этот блок.
- Удалите
lifecycle { prevent_destroy = true }изvm.tf. terraform destroy— удалит доступ коллеги, привязку групп, машину, группуappи ключme-laptop. Публичный IP машины останется в проекте свободным и платным — удалите его в IP адреса или задайтеrelease_eip_on_destroy = trueдоdestroy.
Типичные ошибки
Где взять свой ID пользователя?
В выводе `h3 api GET /api/vms/v1/ssh-access/members -f projectId=…` найдите строку со своим email. Его же ждёт `h3 config set user_id` для команд `h3 ssh`.
Можно ли импортировать уже выданный в консоли доступ?
Да: `terraform import h3_vm_ssh_access.alice <vm_id>/<user_id>`, группу — `terraform import h3_security_group.app <id>`, правило — `terraform import h3_security_group_rule.x <sg_id>/<rule_id>`.
Меняю `ssh_key_ids` — машина пересоздастся?
В 0.3 нет: ключи меняются на месте и без перезагрузки. Машину пересоздаёт смена `image`, `disk_size` и `subnet_name` — `plan` пишет это как `must be replaced`.
Работает ли это в OpenTofu?
Да, провайдер тот же — `h3llo-cloud/h3`.
Связанные продукты и материалы
- Сценарий · 35 минИнфраструктура как код: сервер в Terraform и state в S3
- Сценарий · 45 минСайт на облачном сервере: публичный IP, домен и HTTPS
- Сценарий · 40 минПриложение в Managed Kubernetes из своего реестра образов
- Сценарий · 35 минManaged PostgreSQL для приложения: пользователь, pgvector и восстановление на момент времени
- ПродуктБезопасность
- ПродуктСерверы
Попробовать в h3llo.cloud
Новым пользователям — 4 000 ₽ на 30 дней на любые сервисы: бонуса хватит, чтобы попробовать этот сценарий целиком. Бонус начисляется после подтверждения телефона и привязки карты.