Чому сертифікати, а не ключі

SSH довіряє при першому з’єднанні. Підключаєшся до нової машини, вона показує відбиток і питає, чи ти впевнений. Ніхто не перевіряє. Усі набирають yes. Це та сама звичка, що й проклацати попередження браузера, і саме цього від тебе потребує машина посередині.

В інший бік не краще. Кожен сервер тримає файл authorized_keys для кожного користувача, і кожен із них росте. Ключі додають і ніколи не прибирають. Хтось іде, а його ключ лишається на машині, про яку ніхто не пам’ятає, аж до дня, коли це стане важливо. Перевстанови сервер, і кожен клієнт кричить, що ключ хоста змінився, тож люди вчаться видаляти й це попередження.

Центр сертифікації SSH закриває обидві проблеми. CA підписує ключ кожного хоста, і клієнти довіряють CA, а не списку відбитків. CA підписує ключ кожного користувача на кілька годин, і сервери довіряють CA, а не списку ключів. Нічого приймати при першому з’єднанні, нічого прибирати, коли хтось іде, і сертифікат користувача, який до завтра помре сам.

Це інше налаштування, ніж бік X.509 у step-ca, описаний у Your Own Certificate Authority: step-ca In A Container, тому в нього окремий допис. Той самий контейнер, інші ключі, інші файли на кожній машині. Усе тут запускалося на step-ca 0.30.2 і OpenSSH 10.0 у pod Podman.

Без CAЗі step-ca
Клієнт уперше бачить серверПоказує відбиток, ти набираєш yesПеревіряє сертифікат хоста за CA, нічого не каже
Сервер перевстановилиКожен клієнт попереджає, що ключ змінивсяПідпиши новий ключ, клієнти нічого не помітять
Користувач отримує доступЙого ключ іде в authorized_keys на кожному серверіCA підписує його ключ, кожен сервер його приймає
Користувач ідеЗнайди й видали його ключ на кожному серверіПерестань підписувати; його сертифікат мертвий за 16 годин
Що тримає кожен серверПо одному authorized_keys на користувачаОдин відкритий ключ CA
Хто що підписує і хто чому довіряєstep-caключ CA хостівключ CA користувачівКлієнтсерт. користувача, 16 годдовіряє CA хостівСерверсерт. хоста, 30 днівдовіряє CA користувачівпідписує ключ користувачапідписує ключ хостаssh, без запитукожен перевіряєсерт. іншого
CA підписує обидва боки. Клієнтові треба довіряти лише ключу CA хостів, а серверу лише ключу CA користувачів. Жоден не тримає списку ключів іншого.

Як увімкнути SSH CA

Ключі SSH створюються під час першого налаштування step-ca або не створюються взагалі. Задай DOCKER_STEPCA_INIT_SSH=true під час першого запуску1, і в журналі з’являться два додаткові ключі:

SSH Host CA Key: ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAy...
SSH User CA Key: ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAy...
КлючЩо підписуєХто йому довіряє
CA хостівКлюч хоста кожного сервераКожен клієнт, у known_hosts
CA користувачівКлюч входу кожної людиниКожен сервер, у sshd_config

Він також додає провізіонер sshpop, який згодом дає хостові змогу поновлювати власний сертифікат. Якщо CA вже працює без SSH, перемикача немає. Це буде новий CA.

Підпис хоста

Візьми наявний ключ хоста сервера, підпиши його і поверни сертифікат на сервер:

step ssh certificate --host --sign \
  --provisioner admin --provisioner-password-file prov-pass \
  nas.home.example ssh_host_ecdsa_key.pub

Порядок має значення. Коли прапорці провізіонера стояли після імені хоста й файлу ключа, step відмовився:

too many positional arguments were provided in 'step ssh certificate <key-id> <key-file>'

Постав усі прапорці першими, і він підписує. Сертифікат так, як його читає ssh-keygen -L:

ПолеЗначення
Типecdsa-sha2-nistp256-cert-v01@openssh.com host certificate
Key IDnas.home.example
Principalsnas.home.example
Чинний30 днів, від 2026-10-09T18:34:30 до 2026-11-08T17:35:30

Principal це ім’я, яким клієнт мусить підключатися. Підключишся за ім’ям, якого немає в сертифікаті, і клієнт його не прийме, тож підписуй кожне ім’я, на яке відповідає хост.

Сервер

Два рядки в sshd_config2:

HostCertificate /etc/ssh/ssh_host_ecdsa_key-cert.pub
TrustedUserCAKeys /etc/ssh/ssh_user_ca_key.pub

HostCertificate віддає сертифікат хоста клієнтам, і його ключ «must match a private host key already specified»2. TrustedUserCAKeys це відкритий ключ CA користувачів, «trusted to sign user certificates for authentication»2. Запусти sshd -t перед перезапуском. Одна помилка в будь-якому шляху, і sshd каже Could not load host certificate, а це куди краще знайти зараз, ніж із заблокованої сесії.

На тестовому сервері authorized_keys немає взагалі. ls /home/damien/.ssh/authorized_keys повертає No such file or directory, а входи нижче однаково працюють.

Користувач

CA створює пару ключів і підписує її за один раз:

step ssh certificate damien id_ecdsa \
  --provisioner admin --provisioner-password-file prov-pass
ПолеЗначення
Типuser certificate
Principalsdamien
Чинний16 годин
Розширенняpermit-agent-forwarding, permit-port-forwarding, permit-X11-forwarding, permit-pty, permit-user-rc

Шістнадцять годин тут і є суттю. Це покриває робочий день і вмирає за ніч. Відкликати користувача здебільшого означає просто не підписати йому завтра.

Клієнт

Один рядок у known_hosts замінює кожен відбиток, який він інакше збирав би3:

@cert-authority *.home.example ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAy...

Він каже: будь-який хост під home.example, чий сертифікат підписано цим ключем, справжній. Саме позначка @cert-authority робить його рядком CA, а не ключем одного хоста.

Що показав тест

Усі чотири з клієнта, у якого немає нічого, крім сертифіката користувача і того одного рядка в known_hosts, зі StrictHostKeyChecking=yes, тож нічого не можна було прийняти на льоту:

ТестРезультат
Підписаний ключ із сертифікатом, як damienlogged in as damien, код виходу 0
Той самий ключ, сертифікат прибраноPermission denied (publickey,password,keyboard-interactive)
Сертифікатом входять як rootPermission denied: сертифікат називає лише damien
Клієнт без рядка CA хостівHost key verification failed.

Третій люди й пропускають. Сертифікат не відчиняє кожен обліковий запис на машині, лише principals, записані в ньому. Ключ у чиємусь authorized_keys так не вміє.

Поновлення

Хост поновлює власний сертифікат ключем, який уже має. Це провізіонер sshpop, який «allows a client to renew, revoke, or rekey an SSH certificate using that certificate for authentication with the CA»4. Без пароля5:

step ssh renew --force ssh_host_ecdsa_key-cert.pub ssh_host_ecdsa_key
Серійний номерЧинний до
Підписано151663258693294169972026-11-08 17:35:30
Поновлено66789577897973167682026-11-08 17:35:59

Новий серійний номер і свіжі 30 днів. Постав це на щотижневий таймер, і хост ніколи не прострочиться. Після цього перезавантаж sshd, інакше старий сертифікат лишиться в пам’яті.

Користувачі поновлюють, просто попросивши знову. Один step ssh certificate на день або при першому вході за день, і це вся робота.

Де це ламається

ВипадокЩо стаєтьсяЩо робити
CA лежитьНаявні сертифікати працюють далі; нових ніхто не отримуєЗапускай CA на тому, що не падає; у користувачів 16 годин запасу
Сертифікат хоста прострочивсяКлієнти відкидають хост, наче це незнайомецьТаймер поновлення і перезавантаження sshd після нього
Користувач мусить піти сьогодні, а не завтраЙого сертифікат працює до кінця строкуRevokedKeys у sshd_config приймає список відкликаних ключів2
Імені хоста немає серед principalsКлієнт відкидає хостПідписуй кожне ім’я, на яке він відповідає
SSH CA не створили під час налаштуванняДодати його ніякНовий CA, налаштований з увімкненим SSH
Ключі SSH від CA вкралиХто їх має, може входити будь-куди й бути будь-яким хостомТримай CA на окремій машині, з резервною копією, офлайн, якщо можеш

Останній рядок і є ціною. Кожен файл authorized_keys був власним малим ризиком. Тепер є один великий, в одному місці. Це краще, бо одне місце можна стерегти й замкнути, але лише якщо хтось це робить.

Довіра там, де її можна перевірити

У запиту відбитка й файлу authorized_keys є дещо спільне. Обидва просять людину ухвалити рішення про довіру без жодної інформації, щодня, назавжди. Люди в цьому не сильні й ніколи не будуть, тож вони перестають вирішувати й починають набирати yes.

CA переносить це рішення в одне місце, один раз, де його можна ухвалити як слід. У цьому вся ідея, і вона та сама, що стоїть за кожним вартим чогось стандартом: зроби ретельну річ один раз, запиши її і перестань просити людей робити це в голові сто разів на тиждень. Машина перевіряє підпис. Ти перевіряєш CA. Такий поділ праці тримається.


  1. smallstep/certificates — docker/entrypoint.sh — DOCKER_STEPCA_INIT_SSH=true додає --ssh до step ca init. ↩︎

  2. OpenBSD manual — sshd_config(5) — HostCertificate: «The certificate’s public key must match a private host key already specified by HostKey»; TrustedUserCAKeys: «public keys of certificate authorities that are trusted to sign user certificates for authentication»; RevokedKeys: «Keys listed in this file will be refused for public key authentication». ↩︎ ↩︎ ↩︎ ↩︎

  3. OpenBSD manual — sshd(8), SSH_KNOWN_HOSTS FILE FORMAT — позначка „@cert-authority“ «to indicate that the line contains a certification authority (CA) key». ↩︎

  4. Smallstep — Provisioners, SSHPOP — «An SSHPOP provisioner allows a client to renew, revoke, or rekey an SSH certificate using that certificate for authentication with the CA.» ↩︎

  5. Smallstep — step ssh renew — команда, якою поновлено сертифікат хоста. ↩︎