关于向帐户添加 SSH 密钥
可以使用 SSH(安全外壳协议)在 你的 GitHub Enterprise Server 实例 上的存储库中访问和写入数据。 通过 SSH 进行连接时,使用本地计算机上的私钥文件进行身份验证。有关详细信息,请参阅“关于 SSH”。
还可以使用 SSH 对提交和标记进行签名。 有关提交签名的详细信息,请参阅“关于提交签名验证”。
生成 SSH 密钥对后,必须将公钥添加到 你的 GitHub Enterprise Server 实例,才能为帐户启用 SSH 访问。
先决条件
在向 你的 GitHub Enterprise Server 实例 上的帐户添加新的 SSH 密钥之前,请完成以下步骤。
- 检查现有 SSH 密钥。 有关详细信息,请参阅“检查现有 SSH 密钥”。
- 生成新的 SSH 密钥,并将其添加到计算机的 SSH 代理。 有关详细信息,请参阅“生成新的 SSH 密钥并将其添加到 ssh-agent”。
向你的帐户添加新的 SSH 密钥
可以添加 SSH 密钥并将其用于身份验证或提交签名,或同时用于这两个目的。 如果要使用相同的 SSH 密钥进行身份验证和签名,则需要将其上传两次。
向 你的 GitHub Enterprise Server 实例 上的帐户添加新 SSH 身份验证密钥后,可以重新配置任何本地存储库以使用 SSH。 有关详细信息,请参阅“管理远程仓库”。
注意:默认情况下,若使用 GitHub Enterprise Server 3.6 及更高版本,则截至 2022 年 8 月 1 日午夜 (UTC),同时满足以下两个条件的 SSH 连接将失败 。
- RSA 密钥在 2022 年 8 月 1 日午夜 UTC 截止日期之后添加到 你的 GitHub Enterprise Server 实例 上的用户帐户。
- SSH 客户端使用 SHA-1 哈希函数对连接尝试进行签名。
GitHub Enterprise Server 3.6 及更高版本也不支持使用 DSA、HMAC-SHA-1 或 CBC 密码的 SSH 连接。 只要密钥保持有效,在截止日期之前上传的 RSA SSH 密钥便可以继续使用 SHA-1 哈希函数进行身份验证。 有关查找所使用的 GitHub Enterprise Server 版本的详细信息,请参阅“关于 GitHub 文档的版本”。
站点管理员可以使用 RSA-SHA-1 调整连接的截止日期,也可以使用 RSA-SHA-1 阻止所有连接。 有关详细信息,请联系站点管理员或参阅“配置与实例的 SSH 连接”。
-
将 SSH 公钥复制到剪贴板。
如果您的 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
文件夹,在你最喜欢的文本编辑器中打开该文件,并将其复制到剪贴板。