Что получится
На боевых машинах в 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. Создайте ключ на токене
Ключ типа
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. Добавьте ключ в профиль с требованием PIN
Консоль
- Значок ключа «API и SSH ключи» внизу левой панели → Добавить ключ → Добавить SSH-ключ.
- Имя ключа
prod-yubikey, в поле Ключ — строка изid_ed25519_sk.pub. - Под полем появится флажок «Требовать PIN токена» («При входе токен спросит PIN или отпечаток (verify-required). Нужен OpenSSH 8.4 в ВМ»). Включите его и нажмите Добавить.
Проверка
Ключ
prod-yubikeyесть на вкладке SSH-ключи. В окне выдачи доступа он помечен «Аппаратный ключ (FIDO)» и «PIN».Если не получилось
- «Опции verify-required и no-touch-required действуют только для аппаратных sk-ключей» — вы вставили обычный ключ
ssh-ed25519, а не.pubотed25519-sk.
-
Шаг 3. Пустите на боевую машину только аппаратные ключи
Режим «выбранные ключи» записывает в машину только указанные ключи. Для прода у каждого участника отметьте только его FIDO-ключ, тогда обычный ключ с ноутбука на машину не попадёт, даже если он есть в профиле.
Консоль
- Инстансы → боевая машина → секция «Доступ по SSH». У своей строки нажмите Изменить (или Выдать доступ и выберите участника).
- Выключите «Синхронизировать ключи пользователя», в поле Ключи оставьте только
prod-yubikey. Нажмите Сохранить. - Повторите для каждого участника с доступом — у всех должны остаться только ключи с пометкой «Аппаратный ключ (FIDO)».
CLI
Терминалh3 vm ssh-access grant <vm-id> <ID участника> --mode selected --key-ids <ID его FIDO-ключа> h3 vm ssh-access get <vm-id>Terraform
Terraformresource "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. Проверьте вход
На вашем компьютере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. Подготовьте запасной токен
Токен можно потерять, поэтому заведите второй, создайте на нём ключ тем же способом, добавьте в профиль как
prod-yubikey-backupи отметьте оба ключа в доступе к машине. Запасной токен храните отдельно от основного.Если оба токена недоступны, в карточке машины остаётся вход через браузерную консоль с паролем — им можно вернуть доступ, выдав новый ключ.
Проверка результата
В карточке машины, «Доступ по SSH»: у каждого участника только ключи с пометкой «Аппаратный ключ (FIDO)» и «PIN», статус «Применено». В блоке «Журнал доступа» видно, кто и когда менял ключи.
h3 vm ssh-access get <vm-id> -o json Как удалить ресурсы
Сценарий не создаёт платных ресурсов. Чтобы вернуть обычный вход, откройте доступ участника → Изменить → включите «Синхронизировать ключи пользователя» или отметьте обычный ключ → Сохранить.
- Ненужный FIDO-ключ удалите на вкладке SSH-ключи → Удалить — из машин он уйдёт сам.
- 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: подпись делает токен на вашем компьютере, бастион ключ не видит.
Связанные продукты и материалы
- Сценарий · 45 минСайт на облачном сервере: публичный IP, домен и HTTPS
- Сценарий · 35 минИнфраструктура как код: сервер в Terraform и state в S3
- Сценарий · 40 минПриложение в Managed Kubernetes из своего реестра образов
- Сценарий · 35 минManaged PostgreSQL для приложения: пользователь, pgvector и восстановление на момент времени
- ПродуктБезопасность
- ПродуктСерверы
Попробовать в h3llo.cloud
Новым пользователям — 4 000 ₽ на 30 дней на любые сервисы: бонуса хватит, чтобы попробовать этот сценарий целиком. Бонус начисляется после подтверждения телефона и привязки карты.