Bezdepbonusu7Программирование: статьи и ответы

Доступ и безопасность

SSH-ключ: создание, добавление на сервер и в GitHub, вход без пароля

SSH-ключ - это пара файлов, закрытый и открытый, которая заменяет пароль при входе на сервер и работе с GitHub. Создают его командой ssh-keygen, открытую часть добавляют на сервер или в настройки GitHub, а закрытую храните только у себя. Ниже по шагам: Ed25519 и RSA, passphrase, ssh-agent, config и права на файлы.

SSH-ключ: создание, добавление на сервер и в GitHub, вход без пароля
Содержание
  1. Как работает вход по SSH-ключу
  2. Как создать SSH-ключ командой ssh-keygen
  3. RSA вместо Ed25519
  4. Passphrase и ssh-agent
  5. Как добавить SSH-ключ на сервер
  6. Как добавить SSH-ключ в GitHub
  7. Файл ~/.ssh/config: несколько ключей и короткие имена
  8. Права на файлы и частые ошибки
  9. Частые вопросы

Как работает вход по SSH-ключу

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

Пароль можно подобрать или перехватить, а закрытый ключ по сети не отправляется вообще: клиент лишь доказывает, что владеет им. Поэтому ключи безопаснее паролей, а работать с ними удобнее: не нужно вводить секрет при каждом git push или входе на сервер.

ФайлЧто этоКому показывать
id_ed25519закрытый ключникому, никогда
id_ed25519.pubоткрытый ключсерверам, GitHub, администраторам
authorized_keysсписок разрешённых открытых ключей на серверележит на сервере
known_hostsотпечатки серверов, которым вы уже доверяетележит у вас
configнастройки подключенийлежит у вас

Все файлы лежат в папке ~/.ssh (в Windows это C:\Users\ИМЯ\.ssh). Если папки нет, команда генерации создаст её сама.

Как создать SSH-ключ командой ssh-keygen

Клиент OpenSSH есть в Linux и macOS, а в Windows 10 и 11 он включён в систему: команда выполняется в PowerShell. Современный выбор - алгоритм Ed25519. Ключи у него короткие, он быстрый и надёжный, а GitHub и большинство серверов его поддерживают.

ssh-keygen -t ed25519 -C "your_email@example.com"

Флаг -t задаёт тип ключа, а -C добавляет комментарий: он помогает отличать ключи друг от друга и не влияет на работу. Программа спросит три вещи.

  1. Куда сохранить файл. Для первого ключа нажмите Enter, и он ляжет в ~/.ssh/id_ed25519.
  2. Парольную фразу (passphrase). Введите её дважды или оставьте пустой, но лучше задать.
  3. Подтверждение фразы.
Терминал с командой ssh-keygen и созданными файлами ключа
Создание ключа: команда, парольная фраза и путь к открытому ключу

В конце программа покажет отпечаток ключа и нарисует его картинку. Проверьте, что файлы появились: ls ~/.ssh в Linux и macOS или dir $HOME\.ssh в PowerShell.

RSA вместо Ed25519

Старые серверы и устройства иногда не понимают Ed25519. Тогда создайте RSA-ключ длиной 4096 бит.

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

Флаг -b задаёт длину ключа. RSA считается надёжным при длине от 3072 бит, 4096 даёт запас. Файлы будут называться id_rsa и id_rsa.pub. Ключи типа DSA устарели и больше не принимаются GitHub.

Чтобы не затереть существующий ключ, укажите своё имя файла флагом -f, например -f ~/.ssh/id_ed25519_work. Это пригодится, когда ключей несколько.

Passphrase и ssh-agent

Парольная фраза шифрует закрытый ключ на диске. Если файл украдут, без фразы им не воспользоваться. Минус очевиден: фразу пришлось бы вводить при каждом подключении. Эту проблему решает ssh-agent: он хранит расшифрованный ключ в памяти и подставляет его по запросу.

# Linux и macOS: запустить агент и добавить ключ
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# показать загруженные ключи
ssh-add -l

Первая строка запускает агент и выводит его идентификатор процесса, вторая добавляет ключ и запрашивает фразу один раз. Команда ssh-add -l перечислит отпечатки загруженных ключей.

В Windows агент работает как служба, и по умолчанию она выключена. Откройте PowerShell от имени администратора и выполните следующее.

Get-Service ssh-agent | Set-Service -StartupType Manual
Start-Service ssh-agent
ssh-add $HOME\.ssh\id_ed25519

Чтобы агент подхватывал ключ сам, в файл конфигурации добавляют параметр AddKeysToAgent yes. Фразу можно сменить позже командой ssh-keygen -p -f ~/.ssh/id_ed25519.

Как добавить SSH-ключ на сервер

Для входа на свой VPS или хостинг открытый ключ нужно записать в файл ~/.ssh/authorized_keys нужного пользователя. Самый простой способ - команда ssh-copy-id. Она один раз спросит пароль и сама допишет ключ.

ssh-copy-id -i ~/.ssh/id_ed25519.pub user@203.0.113.10

# после этого вход без пароля
ssh user@203.0.113.10

В Windows PowerShell команды ssh-copy-id нет, зато ту же работу выполняет такая строка. Она читает открытый ключ и дописывает его в файл на сервере.

type $HOME\.ssh\id_ed25519.pub | ssh user@203.0.113.10 "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

Если ssh-copy-id недоступен, содержимое файла с расширением .pub можно вставить в authorized_keys вручную: одна строка на один ключ. Команды Linux, которые для этого понадобятся, собраны в статье основные команды Linux.

Отключение входа по паролю

Когда вход по ключу заработал, в файле /etc/ssh/sshd_config на сервере можно поставить PasswordAuthentication no и перезагрузить службу командой sudo systemctl reload ssh (в некоторых дистрибутивах служба называется sshd). Не закрывайте текущую сессию, пока не проверите вход по ключу во втором окне, иначе рискуете потерять доступ.

Как добавить SSH-ключ в GitHub

Сначала выведите открытый ключ и скопируйте его целиком, включая слово ssh-ed25519 в начале и комментарий в конце.

cat ~/.ssh/id_ed25519.pub        # Linux и macOS
type $HOME\.ssh\id_ed25519.pub   # Windows PowerShell

Затем в GitHub откройте меню профиля, пункт Settings, раздел SSH and GPG keys и нажмите New SSH key. Заполните название (например, "Рабочий ноутбук"), тип оставьте Authentication Key, вставьте ключ в поле Key и сохраните.

Страница настроек GitHub для добавления нового SSH-ключа
Страница добавления ключа в настройках GitHub

Проверить соединение можно командой ssh -T git@github.com. При первом подключении ssh спросит, доверять ли серверу, и покажет отпечаток: сверьте его с опубликованным в документации GitHub и введите yes. Успешный ответ выглядит так: "Hi ИМЯ! You've successfully authenticated, but GitHub does not provide shell access."

После этого репозитории клонируют по адресу вида git@github.com:user/repo.git, а не по https. Существующий репозиторий переключают командой git remote set-url origin git@github.com:user/repo.git. Подробнее о работе с сервисом в статьях как пользоваться GitHub и основные команды Git.

Файл ~/.ssh/config: несколько ключей и короткие имена

Когда ключей несколько или серверы имеют длинные адреса, подключения описывают в файле ~/.ssh/config. Каждый блок начинается со слова Host, это псевдоним, который вы вводите в командной строке.

Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
    AddKeysToAgent yes

Host myserver
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/id_ed25519_work

Теперь вместо длинной команды достаточно ssh myserver. Параметр IdentitiesOnly yes заставляет ssh использовать только указанный ключ и не перебирать все подряд. Для двух аккаунтов GitHub создают разные ключи и разные псевдонимы, как показано в статье про несколько учётных записей GitHub.

Права на файлы и частые ошибки

OpenSSH отказывается использовать закрытый ключ, если им может прочитать кто-то ещё. Сообщение при этом выглядит так: "WARNING: UNPROTECTED PRIVATE KEY FILE" и "Permissions are too open". Исправьте права.

chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519
chmod 644 ~/.ssh/id_ed25519.pub
chmod 600 ~/.ssh/authorized_keys
chmod 600 ~/.ssh/config

Что означают числа, объясняет статья про права доступа и chmod. Такие же права действуют на сервере для папки ~/.ssh и файла authorized_keys: если домашняя папка или эти файлы доступны на запись всем, сервер игнорирует ключ.

Закрытый ключ нельзя отправлять в мессенджеры, класть в репозиторий и вставлять в чаты и вопросы на форумах. В GitHub и в authorized_keys нужен только файл с расширением .pub. Если закрытый ключ попал в чужие руки, удалите его открытую часть везде, где он был добавлен, и создайте новую пару.

  • Permission denied (publickey): сервер не нашёл ваш ключ. Проверьте, что открытая часть лежит в authorized_keys нужного пользователя и ssh использует нужный файл (ssh -v user@host покажет, какие ключи пробуются).
  • Agent admitted failure to sign: агент не запущен или ключ в него не добавлен, выполните ssh-add.
  • Ключ не подходит из-за формата: скопирована часть строки или добавлен перенос. В файле .pub должна быть одна строка.
  • Не помните, какой ключ на сервере: сравните отпечатки командами ssh-keygen -lf ~/.ssh/id_ed25519.pub и ssh-add -l.

Удалить ключ просто: сотрите строку с ним из authorized_keys на сервере или нажмите Delete рядом с ключом в настройках GitHub, а файлы на своём компьютере удалите командой rm. Под WSL ключи лежат в своей папке ~/.ssh внутри Linux, о таком окружении рассказывает материал как установить WSL.

Частые вопросы

Как создать SSH-ключ?

Выполните ssh-keygen -t ed25519 -C "your_email@example.com" и нажмите Enter для пути по умолчанию. Появятся файлы id_ed25519 и id_ed25519.pub в папке ~/.ssh.

Где лежат SSH-ключи?

В папке .ssh внутри домашней директории: ~/.ssh в Linux и macOS, C:\Users\ИМЯ\.ssh в Windows.

Как посмотреть и скопировать SSH-ключ?

Откройте открытый ключ командой cat ~/.ssh/id_ed25519.pub (в PowerShell - type). Копируйте строку целиком. Файл без расширения .pub - закрытый, его показывать нельзя.

Как добавить SSH-ключ на сервер?

Командой ssh-copy-id -i ~/.ssh/id_ed25519.pub user@host либо вручную допишите строку из файла .pub в ~/.ssh/authorized_keys на сервере.

Как добавить SSH-ключ в GitHub?

Откройте Settings, затем SSH and GPG keys, нажмите New SSH key, введите название, вставьте открытый ключ и сохраните. Проверка: ssh -T git@github.com.

Что выбрать: Ed25519 или RSA?

Ed25519 короче, быстрее и подходит большинству современных систем. RSA с длиной 4096 бит берут, когда старый сервер не поддерживает Ed25519.

Как удалить SSH-ключ?

Удалите строку с открытым ключом из authorized_keys на сервере или нажмите Delete в настройках GitHub, а файлы на компьютере удалите командой rm.

Источники

  • Generating a new SSH key and adding it to the ssh-agent, GitHub Docs
  • Adding a new SSH key to your GitHub account, GitHub Docs
  • ssh-keygen(1) manual, OpenBSD

SSHLinuxGit

Похожие материалы

Версии программ и команды проверены на дату публикации. Если что-то изменилось, сверяйтесь с официальной документацией. Нашли неточность? Напишите на admin@bezdepbonusu7.win.