Skip to main content

Добавление нового ключа SSH в учетную запись GitHub

Чтобы настроить учетную запись в GitHub.com для использования нового (или существующего) ключа SSH, необходимо также добавить ключ в учетную запись.

Сведения о добавлении ключей SSH в учетную запись

Вы можете получать доступ к данным в репозиториях и записывать их в GitHub.com с помощью SSH (протокол Secure Shell). При подключении через SSH проверка подлинности выполняется с помощью файла закрытого ключа на локальном компьютере. Дополнительные сведения см. в разделе "Сведения об SSH."

Вы также можете использовать SSH для подписывания фиксаций и тегов. Дополнительные сведения о подписи фиксаций см. в статье Сведения о проверке подписи фиксации.

После создания пары ключей SSH необходимо добавить открытый ключ в GitHub.com, чтобы включить доступ по протоколу SSH для вашей учетной записи.

Предварительные требования

Перед добавлением нового ключа SSH в учетную запись в GitHub.com, выполните следующие действия.

  1. Проверьте существующие ключи SSH. Дополнительные сведения см. в разделе Проверка наличия ключей SSH.
  2. Создайте новый ключ SSH и добавьте его в агент SSH вашего компьютера. Дополнительные сведения см. в разделе Создание нового ключа SSH и его добавление в агент SSH.

Добавление нового ключа SSH в вашу учетную запись

После добавления нового ключа проверки подлинности SSH в учетную запись в GitHub.com можно перенастроить любые локальные репозитории для использования SSH. Дополнительные сведения см. в разделе Переключение удаленных URL-адресов с HTTPS на SSH.

Примечание. GitHub улучшили безопасность за счет удаления старых небезопасных типов ключей 15 марта 2022 г.

По состоянию на эту дату ключи DSA (ssh-dss) больше не поддерживаются. Вы не можете добавить новые ключи DSA в личную учетную запись в GitHub.com.

Ключи RSA (ssh-rsa) с valid_after до 2 ноября 2021 г. могут продолжать использовать любой алгоритм подписи. Ключи RSA, созданные после этой даты, должны использовать алгоритм подписи SHA-2. Для использования сигнатур SHA-2 может потребоваться обновить некоторые старые клиенты.

  1. Скопируйте открытый ключ 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

    Совет. Если 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, открыть файл в любом текстовом редакторе и скопировать ключ в буфер обмена.

    1. В правом верхнем углу любой страницы щелкните фотографию профиля, а затем выберите **Параметры**.

    Значок "Настройки" на панели пользователя

  2. В разделе "Безопасность" на боковой панели щелкните Ключи SSH и GPG.

  3. Щелкните Создать ключ SSH или Добавить ключ SSH. Кнопка ключа SSH

  4. В поле "Название" добавьте описательную метку для нового ключа. Например, если вы используете личный ноутбук, можно назвать этот ключ "Личный ноутбук".

  5. Выберите тип ключа: ключ проверки подлинности или ключ подписывания. Дополнительные сведения о подписи фиксаций см. в статье Сведения о проверке подписи фиксации.

  6. Вставьте открытый ключ в поле "Ключ". Поле ключа

  7. Нажмите кнопку Добавить ключ SSH. Кнопка "Добавить ключ"

  8. При появлении запроса подтвердите доступ к GitHub Enterprise Cloud. Дополнительные сведения см. в разделе "Режим 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, вы можете добавить ключ в свою учетную запись с помощью этой команды.

gh ssh-key add ~/.ssh/id_ed25519.pub

Дополнительные материалы