1. Главная
  2. Хаб
  3. Сценарии
  4. Доступ подрядчику на время: SSH к одной машине, порт только с его адреса и отдельный API-ключ

Сценарий 18

Доступ подрядчику на время: SSH к одной машине, порт только с его адреса и отдельный API-ключ

Подрядчику нужен сервер на пару недель. Даём ему вход по SSH только к нужной машине и только его ключом, открываем 22-й порт только с его IP, при необходимости — отдельный API-ключ на один проект со сроком в месяц. В конце — как забрать всё обратно за пять минут.

20 минНовичок5 шагов Безопасность, Серверы, Сети обновлено

Содержание
  1. 01Пригласите подрядчика в проект
  2. 02Подрядчик добавляет свой SSH-ключ
  3. 03Выдайте SSH-доступ только к одной машине и только этим ключом
  4. 04Откройте 22-й порт только с адреса подрядчика
  5. 05Если нужен API: отдельный ключ на один проект и на месяц
  6. Проверка результата
  7. Как удалить ресурсы
  8. Типичные ошибки

Что получится

Подрядчик входит по SSH на одну машину своим ключом и только со своего адреса; у остальных машин проекта его ключа нет. Доступ, правило файрвола и ключ API отзываются в один заход, а в журнале доступа видно, кто и когда его выдал.

Что понадобится

  • Проект с работающей машиной на Linux, у которой включено «Управление ключами через агента» (по умолчанию так у образов из каталога) — например, из сценария «Сайт на облачном сервере».
  • Email подрядчика, его публичный IPv4-адрес (например, 203.0.113.10) и открытый SSH-ключ.
  • Роль «Администратор проекта» или выше: она нужна, чтобы приглашать в проект.
  1. Шаг 1. Пригласите подрядчика в проект

    SSH-доступ платформа выдаёт только участникам проекта: ключи берутся из их профиля. Поэтому подрядчик сначала становится участником, причём одного проекта, а не всего рабочего пространства.

    Консоль

    1. Внизу левой панели откройте настройки и выберите Команда. Нажмите Пригласить.
    2. В окне «Пригласить в команду»: Email — адрес подрядчика, Куда — нужный проект (не «Всё рабочее пространство»), Роль — «Участник проекта».
    3. В бизнес-пространстве выберите роль «Подрядчик проекта» и в поле До поставьте дату окончания работ: «После этой даты роль закончится сама».
    4. Нажмите Пригласить. Подрядчик увидит приглашение в разделе «Входящие приглашения» и нажмёт Принять.

    Проверка

    В разделе Отправленные приглашения статус сменился на «Принято», а в Доступ к проектам подрядчик появился в списке «Участники» нужного проекта.

    Если не получилось

    • Роль «Наблюдатель» не подойдёт: «Наблюдателю проекта нельзя выдать доступ по SSH».
    • В личном рабочем пространстве ролей «Подрядчик проекта» и «Наблюдатель» нет, и срок у приглашения не задаётся — доступ придётся забрать вручную (последний шаг).
  2. Шаг 2. Подрядчик добавляет свой SSH-ключ

    Ключ подрядчика живёт в его профиле, а не в вашем. Так никто не передаёт приватные ключи из рук в руки, и при отзыве доступа удаляется только его ключ.

    Консоль

    1. Подрядчик в своей консоли нажимает значок ключа «API и SSH ключи» внизу левой панели → Добавить ключ → Добавить SSH-ключ.
    2. В окне «Новый 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. Шаг 3. Выдайте SSH-доступ только к одной машине и только этим ключом

    Режим «выбранные ключи» записывает в машину только перечисленные ключи. Если подрядчик позже добавит в профиль ещё один ключ, на машину он сам не попадёт.

    Консоль

    1. Инстансы → нужная машина → секция «Доступ по SSH» → Выдать доступ.
    2. В окне «Выдать доступ по SSH» в поле Участники проекта выберите подрядчика.
    3. Выключите «Синхронизировать ключи пользователя» и в поле Ключи отметьте 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. Шаг 4. Откройте 22-й порт только с адреса подрядчика

    Правило в группе безопасности машины пропускает SSH только с одного адреса /32. В описании правила оставьте, чьё оно и до какого числа, — через месяц это сэкономит расследование.

    Консоль

    1. Группы безопасности → группа, назначенная машине (видна в секции «Группы безопасности» карточки машины).
    2. В секции «Входящий трафик» нажмите Добавить правило: Входящее, Разрешить, Протокол TCP, Порт с 22, Источник «Адреса (CIDR)», CIDR 203.0.113.10/32.
    3. Описание — 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

    Terraform
    resource "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. Шаг 5. Если нужен API: отдельный ключ на один проект и на месяц

    Например, подрядчик ведёт свою панель мониторинга или скрипт деплоя. Создайте для него отдельный ключ и не отдавайте свой рабочий. Тогда отзыв не заденет ваши скрипты, а в списке ключей видно, когда этим ключом пользовались.

    Консоль

    1. Значок ключа «API и SSH ключи» → вкладка API-ключи → Добавить ключ → Добавить API-ключ.
    2. В окне «Новый API ключ»: Имя ключа contractor-acme, Проекты — только этот проект, Описание — кому и зачем, Срок действия — «Месяц».
    3. Нажмите Создать 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-сессии отзыв не закрывает — попросите подрядчика выйти или перезагрузите машину в окно обслуживания.

  1. Карточка машины → «Доступ по SSH» → строка подрядчика → Отозвать → Отозвать (или h3 vm ssh-access revoke <vm-id> <ID подрядчика>). Ключи удаляются из машины примерно за 2 минуты.
  2. Группы безопасности → группа машины → меню правила contractor ACME… → Удалить (или h3 sg rule delete <sg-id> <rule-id>).
  3. API-ключи → contractor-acme → меню «…» → Удалить → Подтвердить. Ключ перестаёт работать сразу.
  4. Доступ к проектам → проект → подрядчик → Удалить → Подтвердить. Если доступ к машине ещё оставался, он станет неактивным с причиной «Не состоит в проекте».

Типичные ошибки

Можно ли дать подрядчику ключ API только на чтение?

Ключ, созданный в консоли, даёт полный доступ к ресурсам выбранных проектов. Ограничьте охват проектом и сроком, а ресурсы, которые подрядчику трогать нельзя, держите в другом проекте.

Подрядчик сменил ноутбук и ключ

Он добавляет новый ключ в профиль, а вы в карточке машины нажимаете «Изменить» у его доступа и отмечаете новый ключ в поле **Ключи**. Старый ключ подрядчик удаляет из профиля — из машины он уйдёт сам.

У подрядчика меняется IP

Правило с `/32` придётся обновлять. Надёжнее схема с бастионом: на машину ходят только через бастион, а на бастион — по SSH-ключу и вашему списку адресов.

Где посмотреть, кто выдавал доступ?

В карточке машины, секция «Доступ по SSH» → «Журнал доступа»: выдача, отзыв, смена ключей и исключение участника из проекта с именем того, кто это сделал.

Связанные продукты и материалы

Попробовать в h3llo.cloud

Новым пользователям — 4 000 ₽ на 30 дней на любые сервисы: бонуса хватит, чтобы попробовать этот сценарий целиком. Бонус начисляется после подтверждения телефона и привязки карты.