跳至主要内容

管理您的通行密钥

您可能会在登录期间收到注册通行密钥的提示,或者可以选择在您的帐户设置中注册新的通行密钥。对于 2FA 用户,您可以将现有的符合条件的安全密钥升级为通行密钥。

谁可以使用此功能?

管理自己凭据的个人帐户所有者可以使用通行密钥对 GitHub.com 进行身份验证。

关于管理您的通行密钥

如果您从符合条件的设备和浏览器连接到 GitHub.com,GitHub 可能会在您登录期间提示您将该设备注册为通行密钥。您还可以从您的帐户设置中向您的帐户添加通行密钥。有关更多信息,请参阅“向您的帐户添加通行密钥”。

如果您使用双因素身份验证 (2FA),GitHub 可能会在您对 GitHub.com 进行身份验证后提示您将现有的符合条件的安全密钥(例如 Mac TouchID 或 Windows Hello)升级为通行密钥。您还可以从您的帐户设置中升级符合条件的安全密钥。有关更多信息,请参阅“将现有的安全密钥升级为通行密钥”。

有关如何从您的帐户中移除通行密钥的信息,请参阅“从您的帐户中移除通行密钥”。

向你的账户添加通行密钥

  1. 在 GitHub 上的任何页面的右上角,单击你的个人资料照片,然后单击设置
  2. 在侧边栏的“访问”部分,单击 密码和身份验证
  3. 在“通行密钥”下,单击添加通行密钥
  4. 如果出现提示,请使用你的密码进行身份验证,或使用另一种现有的身份验证方法。
  5. 在“配置无密码身份验证”下,查看提示,然后单击添加通行密钥
  6. 在提示中,按照通行密钥提供商概述的步骤操作。
  7. 在下一页上,查看确认已成功注册通行密钥的信息,然后单击完成

将现有安全密钥升级到通行密钥

备注

  • 升级安全密钥的平台支持不一致,因此,如果你在尝试注册现有凭据时看到操作系统或浏览器出现故障,我们建议你移除安全密钥并重新注册。
  • 如果你最近使用了安全密钥并且它有资格升级,则会在设置菜单中安全密钥旁边显示一个升级按钮。你可以使用此按钮触发升级流程。你还可以尝试将其他密钥注册为通行密钥以升级它们,即使未显示升级按钮。

在开始升级过程之前,请确保你使用的是链接到现有安全密钥的设备。然后,当你单击账户设置中的添加通行密钥时,GitHub 将自动让你进入“升级到通行密钥”流程。

  1. 在 GitHub 上的任何页面的右上角,单击你的个人资料照片,然后单击设置
  2. 在侧边栏的“访问”部分,单击 密码和身份验证
  3. 在“通行密钥”下,单击添加通行密钥
  4. 如果出现提示,请使用你的密码进行身份验证,或使用另一种现有的身份验证方法。
  5. 在“配置无密码身份验证”下,“将你的安全密钥注册升级到通行密钥”下,查看确认要升级的安全密钥名称的信息,然后单击升级到通行密钥
  6. 在提示中,按照通行密钥提供商概述的步骤操作。
  7. 在下一页上,查看确认已成功注册通行密钥的信息,然后单击完成

从你的帐户中移除通行密钥

  1. 在 GitHub 上的任何页面的右上角,单击你的个人资料照片,然后单击设置
  2. 在侧边栏的“访问”部分,单击 密码和身份验证
  3. 在你想要移除的通行密钥右侧,单击.
  4. 查看“删除确认”弹出窗口中的信息,然后单击删除

恢复通行密钥

许多通行密钥支持同步,其中你的通行密钥由提供商的帐户系统(iCloud、Google 帐户、密码管理器等)进行备份。如果你丢失了设备,你可以通过登录到你的通行密钥提供商来恢复你的同步通行密钥。

在某些情况下,你的通行密钥可能是“设备绑定的”,这意味着该通行密钥无法同步且不会备份到云端。例如,你可以将 FIDO2 硬件安全密钥(例如 YubiKey)注册为通行密钥,但该通行密钥不会同步。如果你的通行密钥是设备绑定的,并且你丢失或抹除了该设备,则无法恢复该通行密钥。如果你仅使用设备绑定的通行密钥,最好在至少两个不同的设备上注册通行密钥,以防你无法访问其中一个设备。

你可以在帐户安全设置中的“通行密钥”下查看哪些通行密钥已同步,哪些是设备绑定的。已同步的通行密钥会在其名称旁边显示一个蓝色的已同步标签。

进一步阅读