Сведения о добавлении ключей SSH в учетную запись
Вы можете получать доступ к данным в репозиториях и записывать их в экземпляр GitHub Enterprise Server с помощью SSH (протокол Secure Shell). При подключении через SSH проверка подлинности выполняется с помощью файла закрытого ключа на локальном компьютере. Дополнительные сведения см. в разделе Сведения о протоколе SSH.
Вы также можете использовать SSH для подписывания фиксаций и тегов. Дополнительные сведения о подписи фиксации см. в разделе Сведения о проверке подписи фиксации.
После создания пары ключей SSH необходимо добавить открытый ключ в экземпляр GitHub Enterprise Server, чтобы включить доступ по протоколу SSH для вашей учетной записи.
Предварительные требования
Перед добавлением нового ключа SSH в учетную запись в экземпляр GitHub Enterprise Server, выполните следующие действия.
- Проверьте существующие ключи SSH. Дополнительные сведения см. в разделе Проверка наличия существующих ключей SSH.
- Создайте новый ключ SSH и добавьте его в агент SSH вашего компьютера. Дополнительные сведения см. в разделе Создание нового ключа SSH и его добавление в ssh-agent.
Добавление нового ключа SSH в вашу учетную запись
После добавления нового ключа проверки подлинности SSH в учетную запись в экземпляр GitHub Enterprise Server можно перенастроить любые локальные репозитории для использования SSH. Дополнительные сведения см. в разделе Управление удаленными репозиториями.
Примечание. По умолчанию, начиная с GitHub Enterprise Server версии 3.6 и более поздних версий, по состоянию на 0:00 UTC 1 августа 2022 г. подключение по протоколу SSH, удовлетворяющее обоим следующим условиям, будет завершено сбоем.
- Ключ RSA был добавлен в учетную запись пользователя экземпляр GitHub Enterprise Server после полуночи (UTC) 1 августа 2022 г.
- Клиент SSH подписывает попытку подключения с помощью хэш-функции SHA-1.
GitHub Enterprise Server версии 3.6 и более поздних версий также не поддерживает SSH-подключения, использующие шифры DSA, HMAC-SHA-1 или CBC. Ключи RSA SSH, отправленные до даты прекращения, могут по-прежнему проходить проверку подлинности с помощью хэш-функции SHA-1, пока ключ остается действительным. Дополнительные сведения о поиске используемой версии GitHub Enterprise Server см. в разделе Сведения о версиях документации GitHub.
Администратор сайта может настроить дату прекращения подключений с помощью RSA-SHA-1 и заблокировать все подключения с помощью RSA-SHA-1. Для получения дополнительных сведений обратитесь к администратору сайта или ознакомьтесь с разделом Настройка SSH-подключений к экземпляру.
-
Скопируйте открытый ключ SSH в буфер обмена.
Если файл открытого ключа SSH имеет другое имя или путь, отличный от примера кода, измените имя файла или путь в соответствии с текущей настройкой. При копировании ключа не добавляйте символы перевода строки и пробелы.
$ pbcopy < ~/.ssh/id_ed25519.pub # Copies the contents of the id_ed25519.pub file to your clipboard
Совет. Если
pbcopy
не работает, можно найти скрытую папку.ssh
, открыть файл в любом текстовом редакторе и скопировать ключ в буфер обмена.$ clip < ~/.ssh/id_ed25519.pub # Copies the contents of the id_ed25519.pub file to your clipboard
Совет: С помощью подсистема Windows для Linux (WSL) можно использовать
clip.exe
.clip
В противном случае вы можете найти скрытую.ssh
папку, открыть файл в любом текстовом редакторе и скопировать его в буфер обмена.$ cat ~/.ssh/id_ed25519.pub # Then select and copy the contents of the id_ed25519.pub file # displayed in the terminal to your clipboard
Совет. Кроме того, можно найти скрытую папку
.ssh
, открыть файл в любом текстовом редакторе и скопировать ключ в буфер обмена. -
В разделе "Доступ" на боковой панели щелкните SSH и ключи GPG.
-
Щелкните Создать ключ SSH или Добавить ключ SSH.
-
В поле "Название" добавьте описательную метку для нового ключа. Например, если вы используете личный ноутбук, можно назвать этот ключ "Личный ноутбук".
-
Выберите тип ключа: ключ проверки подлинности или ключ подписывания. Дополнительные сведения о подписи фиксации см. в разделе Сведения о проверке подписи фиксации.
-
Вставьте открытый ключ в поле "Ключ".
-
Нажмите кнопку Добавить ключ SSH.
-
При появлении запроса подтвердите доступ к GitHub Enterprise Server. Дополнительные сведения см. в разделе Режим sudo.
Дополнительные сведения о GitHub CLI см. в разделе Сведения о GitHub CLI.
Прежде чем использовать GitHub CLI для добавления ключа SSH в учетную запись, необходимо пройти проверку подлинности в GitHub CLI. Дополнительные сведения см. в разделе gh auth login
в документации по GitHub CLI.
В настоящее время для добавления ключей проверки подлинности SSH можно использовать только GitHub CLI, добавлять ключи подписывания SSH нельзя.
Чтобы добавить ключ проверки подлинности SSH в учетную запись GitHub, используйте подкоманду ssh-key add
, указав открытый ключ.
gh ssh-key add KEY-FILE
Чтобы указать заголовок для нового ключа, используйте флаг -t
или --title
.
gh ssh-key add KEY-FILE --title "personal laptop"
Если вы создали ключ SSH, следуя инструкциям в разделе Создание нового ключа SSH и его добавление в ssh-agent, вы можете добавить ключ в учетную запись с помощью этой команды.
gh ssh-key add ~/.ssh/id_ed25519.pub