Что получится
Подрядчик входит по SSH на одну машину своим ключом и только со своего адреса; у остальных машин проекта его ключа нет. Доступ, правило файрвола и ключ API отзываются в один заход, а в журнале доступа видно, кто и когда его выдал.
Что понадобится
- Проект с работающей машиной на Linux, у которой включено «Управление ключами через агента» (по умолчанию так у образов из каталога) — например, из сценария «Сайт на облачном сервере».
- Email подрядчика, его публичный IPv4-адрес (например,
203.0.113.10) и открытый SSH-ключ. - Роль «Администратор проекта» или выше: она нужна, чтобы приглашать в проект.
-
Шаг 1. Пригласите подрядчика в проект
SSH-доступ платформа выдаёт только участникам проекта: ключи берутся из их профиля. Поэтому подрядчик сначала становится участником, причём одного проекта, а не всего рабочего пространства.
Консоль
- Внизу левой панели откройте настройки и выберите Команда. Нажмите Пригласить.
- В окне «Пригласить в команду»: Email — адрес подрядчика, Куда — нужный проект (не «Всё рабочее пространство»), Роль — «Участник проекта».
- В бизнес-пространстве выберите роль «Подрядчик проекта» и в поле До поставьте дату окончания работ: «После этой даты роль закончится сама».
- Нажмите Пригласить. Подрядчик увидит приглашение в разделе «Входящие приглашения» и нажмёт Принять.
Проверка
В разделе Отправленные приглашения статус сменился на «Принято», а в Доступ к проектам подрядчик появился в списке «Участники» нужного проекта.
Если не получилось
- Роль «Наблюдатель» не подойдёт: «Наблюдателю проекта нельзя выдать доступ по SSH».
- В личном рабочем пространстве ролей «Подрядчик проекта» и «Наблюдатель» нет, и срок у приглашения не задаётся — доступ придётся забрать вручную (последний шаг).
-
Шаг 2. Подрядчик добавляет свой SSH-ключ
Ключ подрядчика живёт в его профиле, а не в вашем. Так никто не передаёт приватные ключи из рук в руки, и при отзыве доступа удаляется только его ключ.
Консоль
- Подрядчик в своей консоли нажимает значок ключа «API и SSH ключи» внизу левой панели → Добавить ключ → Добавить SSH-ключ.
- В окне «Новый SSH ключ» — Имя ключа, например
contractor-laptop, в поле Ключ — строка из его файла.pub. Нажимает Добавить.
CLI
Терминал# на компьютере подрядчика, с его собственным API-ключом h3 config set user_id <его ID пользователя> h3 ssh create --name contractor-laptop --key-file ~/.ssh/id_ed25519.pub h3 ssh listПроверка
Ключ появился на вкладке SSH-ключи у подрядчика. Вам его текст не виден, только имя и тип — этого достаточно, чтобы выдать доступ.
-
Шаг 3. Выдайте SSH-доступ только к одной машине и только этим ключом
Режим «выбранные ключи» записывает в машину только перечисленные ключи. Если подрядчик позже добавит в профиль ещё один ключ, на машину он сам не попадёт.
Консоль
- Инстансы → нужная машина → секция «Доступ по SSH» → Выдать доступ.
- В окне «Выдать доступ по SSH» в поле Участники проекта выберите подрядчика.
- Выключите «Синхронизировать ключи пользователя» и в поле Ключи отметьте
contractor-laptop. Нажмите Сохранить.
CLI
Терминал# ID подрядчика — в списке участников проекта h3 api GET /api/vms/v1/ssh-access/members -f projectId=$H3_PROJECT_ID \ | jq '.items[] | {email, id: (.userId // .user_id), keys: [.keys[] | {name, id: (.keyId // .key_id)}]}' h3 vm ssh-access grant <vm-id> <ID подрядчика> --mode selected --key-ids <ID ключа> h3 vm ssh-access get <vm-id>Проверка
В секции «Доступ по SSH» подрядчик есть в списке «Участники с доступом», статус сначала «Применяется» («Ключи доедут до ВМ примерно за 2 минуты»), затем «Применено». В «Журнал доступа» — запись «выдал доступ» с вашим именем.
Если не получилось
- «Управление выключено» или ошибка «Управление ключами через агента выключено: сначала включите его» — у машины выключено управление ключами. Включение перезагружает работающую машину, поэтому делайте это в окно обслуживания.
- «Агент не отвечает» — в машине не работает qemu-guest-agent:
sudo apt install qemu-guest-agent && sudo systemctl enable --now qemu-guest-agent.
-
Шаг 4. Откройте 22-й порт только с адреса подрядчика
Правило в группе безопасности машины пропускает SSH только с одного адреса
/32. В описании правила оставьте, чьё оно и до какого числа, — через месяц это сэкономит расследование.Консоль
- Группы безопасности → группа, назначенная машине (видна в секции «Группы безопасности» карточки машины).
- В секции «Входящий трафик» нажмите Добавить правило: Входящее, Разрешить, Протокол TCP, Порт с
22, Источник «Адреса (CIDR)», CIDR203.0.113.10/32. - Описание —
contractor ACME до 2026-11-30. Нажмите Добавить.
CLI
Терминалh3 sg vm get <vm-id> # ID группы машины h3 sg rule add <sg-id> --direction ingress --protocol tcp \ --port-from 22 --port-to 22 --remote-cidr 203.0.113.10/32 \ --description "contractor ACME до 2026-11-30" h3 sg get <sg-id>Terraform
Terraformresource "h3_security_group_rule" "contractor_ssh" { security_group_id = var.app_sg_id direction = "ingress" protocol = "tcp" port_from = 22 remote_cidr = "203.0.113.10/32" description = "contractor ACME до 2026-11-30" }Проверка
Группа в статусе «Применена». Подрядчик подключается:
ssh user@<IP машины>— входит; с другого адреса соединение не устанавливается.Если не получилось
- Если в группе уже есть правило «22 с
0.0.0.0/0», адрес подрядчика ничего не ограничивает — удалите широкое правило, а своим администраторам оставьте вход через их/32или через бастион. - Группа
defaultпропускает весь трафик. Если машина в ней, сначала назначьте ей свою группу, иначе правило с/32ничего не закроет.
-
Шаг 5. Если нужен API: отдельный ключ на один проект и на месяц
Например, подрядчик ведёт свою панель мониторинга или скрипт деплоя. Создайте для него отдельный ключ и не отдавайте свой рабочий. Тогда отзыв не заденет ваши скрипты, а в списке ключей видно, когда этим ключом пользовались.
Консоль
- Значок ключа «API и SSH ключи» → вкладка API-ключи → Добавить ключ → Добавить API-ключ.
- В окне «Новый API ключ»: Имя ключа
contractor-acme, Проекты — только этот проект, Описание — кому и зачем, Срок действия — «Месяц». - Нажмите Создать API ключ и передайте подрядчику секрет из окна «Ключ создан» по защищённому каналу. ID ключа — в списке ключей, строка «ID:».
Проверка
В списке ключей у
contractor-acmeвидны строки «Истекает …» и, после первого запроса подрядчика, «Использован …».Если не получилось
- Ключ работает со всеми ресурсами выбранных проектов. Поэтому в поле Проекты — только тот проект, с которым работает подрядчик, а боевые данные держите в другом проекте.
Проверка результата
Пройдитесь по трём местам: в карточке машины «Доступ по SSH» — подрядчик с одним ключом и статусом «Применено»; в группе безопасности — правило 22 с его /32 и описанием; в API-ключи — ключ contractor-acme со сроком. На других машинах проекта ключа подрядчика нет:
for vm in $(h3 vm list -o json | jq -r '.[].id'); do
echo "== $vm"; h3 vm ssh-access get "$vm" -o json | jq -c '.'
done Как удалить ресурсы
Когда работы закончены, отзовите доступ в обратном порядке. Открытые SSH-сессии отзыв не закрывает — попросите подрядчика выйти или перезагрузите машину в окно обслуживания.
- Карточка машины → «Доступ по SSH» → строка подрядчика → Отозвать → Отозвать (или
h3 vm ssh-access revoke <vm-id> <ID подрядчика>). Ключи удаляются из машины примерно за 2 минуты. - Группы безопасности → группа машины → меню правила
contractor ACME…→ Удалить (илиh3 sg rule delete <sg-id> <rule-id>). - API-ключи →
contractor-acme→ меню «…» → Удалить → Подтвердить. Ключ перестаёт работать сразу. - Доступ к проектам → проект → подрядчик → Удалить → Подтвердить. Если доступ к машине ещё оставался, он станет неактивным с причиной «Не состоит в проекте».
Типичные ошибки
Можно ли дать подрядчику ключ API только на чтение?
Ключ, созданный в консоли, даёт полный доступ к ресурсам выбранных проектов. Ограничьте охват проектом и сроком, а ресурсы, которые подрядчику трогать нельзя, держите в другом проекте.
Подрядчик сменил ноутбук и ключ
Он добавляет новый ключ в профиль, а вы в карточке машины нажимаете «Изменить» у его доступа и отмечаете новый ключ в поле **Ключи**. Старый ключ подрядчик удаляет из профиля — из машины он уйдёт сам.
У подрядчика меняется IP
Правило с `/32` придётся обновлять. Надёжнее схема с бастионом: на машину ходят только через бастион, а на бастион — по SSH-ключу и вашему списку адресов.
Где посмотреть, кто выдавал доступ?
В карточке машины, секция «Доступ по SSH» → «Журнал доступа»: выдача, отзыв, смена ключей и исключение участника из проекта с именем того, кто это сделал.
Связанные продукты и материалы
- Сценарий · 45 минСайт на облачном сервере: публичный IP, домен и HTTPS
- Сценарий · 35 минИнфраструктура как код: сервер в Terraform и state в S3
- Сценарий · 40 минПриложение в Managed Kubernetes из своего реестра образов
- Сценарий · 35 минManaged PostgreSQL для приложения: пользователь, pgvector и восстановление на момент времени
- ПродуктБезопасность
- ПродуктСерверы
- ПродуктСети
Попробовать в h3llo.cloud
Новым пользователям — 4 000 ₽ на 30 дней на любые сервисы: бонуса хватит, чтобы попробовать этот сценарий целиком. Бонус начисляется после подтверждения телефона и привязки карты.