1. Главная
  2. Хаб
  3. Сценарии
  4. Вход на прод только с аппаратным ключом: FIDO2 SSH-ключ с PIN

Сценарий 14

Вход на прод только с аппаратным ключом: FIDO2 SSH-ключ с PIN

Приватный ключ, который нельзя скопировать с ноутбука: он живёт в YubiKey или другом FIDO2-токене, а каждый вход требует касания и PIN. Добавляем такой ключ в h3llo.cloud и пускаем на боевые машины только его.

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

Содержание
  1. 01Создайте ключ на токене
  2. 02Добавьте ключ в профиль с требованием PIN
  3. 03Пустите на боевую машину только аппаратные ключи
  4. 04Проверьте вход
  5. 05Подготовьте запасной токен
  6. Проверка результата
  7. Как удалить ресурсы
  8. Типичные ошибки

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

На боевых машинах в authorized_keys записаны только аппаратные ключи sk-ssh-ed25519 с опцией verify-required: без токена, касания и PIN войти нельзя, даже если ноутбук украли вместе с файлами из ~/.ssh.

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

  • FIDO2-токен с поддержкой PIN (YubiKey 5, Solo, Nitrokey 3 и подобные).
  • OpenSSH 8.4 или новее на вашем компьютере (ssh -V). В macOS используйте OpenSSH из Homebrew (brew install openssh): встроенная сборка может не поддерживать FIDO-ключи.
  • Машина на образе с OpenSSH 8.4+: Ubuntu 22.04 и новее, Debian 12 и новее. Нужен qemu-guest-agent — он есть в образах каталога.
  1. Шаг 1. Создайте ключ на токене

    Ключ типа ed25519-sk: приватная часть остаётся в токене, на диске — только «ручка» к ней. С -O verify-required токен при каждом входе спросит PIN, с -O resident ключ можно будет восстановить на новом компьютере командой ssh-keygen -K.

    На вашем компьютере, токен вставлен
    ssh-keygen -t ed25519-sk -O resident -O verify-required -C "me@prod-yubikey" -f ~/.ssh/id_ed25519_sk
    cat ~/.ssh/id_ed25519_sk.pub

    Проверка

    Токен попросил PIN и касание, а файл .pub начинается с sk-ssh-ed25519@openssh.com.

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

    • Key enrollment failed: invalid format или unknown key type ed25519-sk — клиент OpenSSH старше 8.2 или собран без FIDO. Обновите OpenSSH.
    • Токен без PIN — задайте его заранее (ykman fido access change-pin для YubiKey), иначе verify-required не сработает.
  2. Шаг 2. Добавьте ключ в профиль с требованием PIN

    Консоль

    1. Значок ключа «API и SSH ключи» внизу левой панели → Добавить ключ → Добавить SSH-ключ.
    2. Имя ключа prod-yubikey, в поле Ключ — строка из id_ed25519_sk.pub.
    3. Под полем появится флажок «Требовать PIN токена» («При входе токен спросит PIN или отпечаток (verify-required). Нужен OpenSSH 8.4 в ВМ»). Включите его и нажмите Добавить.

    Проверка

    Ключ prod-yubikey есть на вкладке SSH-ключи. В окне выдачи доступа он помечен «Аппаратный ключ (FIDO)» и «PIN».

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

    • «Опции verify-required и no-touch-required действуют только для аппаратных sk-ключей» — вы вставили обычный ключ ssh-ed25519, а не .pub от ed25519-sk.
  3. Шаг 3. Пустите на боевую машину только аппаратные ключи

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

    Консоль

    1. Инстансы → боевая машина → секция «Доступ по SSH». У своей строки нажмите Изменить (или Выдать доступ и выберите участника).
    2. Выключите «Синхронизировать ключи пользователя», в поле Ключи оставьте только prod-yubikey. Нажмите Сохранить.
    3. Повторите для каждого участника с доступом — у всех должны остаться только ключи с пометкой «Аппаратный ключ (FIDO)».

    CLI

    Терминал
    h3 vm ssh-access grant <vm-id> <ID участника> --mode selected --key-ids <ID его FIDO-ключа>
    h3 vm ssh-access get <vm-id>

    Terraform

    Terraform
    resource "h3_vm_ssh_access" "me_prod" {
      vm_id   = h3_vm.prod.id
      user_id = var.my_user_id
      mode    = "selected"
      key_ids = [var.my_yubikey_id]
    }

    Проверка

    Статус «Применено» примерно через 2 минуты. Если в образе старый OpenSSH, консоль предупредит: «Образ не поддерживает аппаратные FIDO-ключи (нужен OpenSSH 8.2)» или «… verify-required (нужен OpenSSH 8.4)».

  4. Шаг 4. Проверьте вход

    На вашем компьютере
    ssh -i ~/.ssh/id_ed25519_sk -o IdentitiesOnly=yes user@<IP машины>
    # обычным ключом войти больше нельзя:
    ssh -i ~/.ssh/id_ed25519 -o IdentitiesOnly=yes user@<IP машины>

    Проверка

    Первая команда просит PIN токена и касание, затем открывает сессию. Вторая получает Permission denied (publickey).

    Терминал
    # на машине: в authorized_keys только sk-ключи с verify-required
    grep -c '^verify-required sk-' ~/.ssh/authorized_keys; grep -vc 'sk-' ~/.ssh/authorized_keys
  5. Шаг 5. Подготовьте запасной токен

    Токен можно потерять, поэтому заведите второй, создайте на нём ключ тем же способом, добавьте в профиль как prod-yubikey-backup и отметьте оба ключа в доступе к машине. Запасной токен храните отдельно от основного.

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

Проверка результата

В карточке машины, «Доступ по SSH»: у каждого участника только ключи с пометкой «Аппаратный ключ (FIDO)» и «PIN», статус «Применено». В блоке «Журнал доступа» видно, кто и когда менял ключи.

Терминал
h3 vm ssh-access get <vm-id> -o json

Как удалить ресурсы

Сценарий не создаёт платных ресурсов. Чтобы вернуть обычный вход, откройте доступ участника → Изменить → включите «Синхронизировать ключи пользователя» или отметьте обычный ключ → Сохранить.

  1. Ненужный FIDO-ключ удалите на вкладке SSH-ключи → Удалить — из машин он уйдёт сам.
  2. Resident-ключ стирается с токена средствами производителя (ykman fido credentials delete … для YubiKey).

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

Можно ли так же защитить CI?

В CI некому коснуться токена. Для CI держите отдельный обычный ключ и пускайте его только на машины, которые он настраивает. Подробнее — в сценарии про Ansible и CI в разделе «Сценарии».

Что за опция no-touch-required?

Токен подписывает без касания. Это удобно для автоматизации с токеном, но ослабляет защиту, поэтому для прода её не используйте.

Подойдёт ли ecdsa-sk?

Да, принимается и `sk-ecdsa-sha2-nistp256@openssh.com`. Ed25519 короче и рекомендуется по умолчанию.

Работает ли проброс агента и ProxyJump через бастион?

Да, это обычный SSH: подпись делает токен на вашем компьютере, бастион ключ не видит.

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

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

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