# 使用密钥登录

你可以在浏览器中使用密钥安全轻松地登录到 GitHub，而无需密码和双因素身份验证。 还可以在附近的设备上使用密钥登录。

> \[!NOTE] 如果站点管理员已为实例禁用了密钥，则可能无法使用密钥。

## 关于使用密钥登录

必须先将密钥添加到帐户，然后才能在浏览器中使用该密钥登录到 GitHub。 有关详细信息，请参阅“[管理通行密钥](/zh/enterprise-server@3.22/authentication/authenticating-with-a-passkey/managing-your-passkeys)”。

将密钥添加到帐户后，即可使用该密钥安全地登录到 GitHub，而无需输入密码、执行双因素身份验证 (2FA) 或验证新设备。 在一台设备上添加同步密钥后，即可在多台设备上使用该密钥。 这些设备必须使用相同的密钥提供程序（如 iCloud）。

某些身份验证器允许将密钥用于附近的设备。 例如，你可能想使用未设置密钥但启用了蓝牙功能的笔记本电脑登录到 GitHub。 如果已在手机上注册密钥，可以选择扫描 QR 码，或触发向手机推送通知，以便安全地完成登录。 有关详细信息，请参阅“[使用附近的设备通过密钥登录](#signing-in-with-a-passkey-using-a-nearby-device)”。

## 使用链接到主设备的密钥登录

1. 导航到 GitHub 的登录页面，地址为 `https://HOSTNAME/login?passkey=true`。
2. 单击“<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-passkey-fill" aria-label="passkey-fill" role="img"><path d="M2.743 4.757a3.757 3.757 0 1 1 5.851 3.119 5.991 5.991 0 0 1 2.15 1.383c.17.17.257.405.258.646.003.598.001 1.197 0 1.795L11 12.778v.721a.5.5 0 0 1-.5.5H1.221a.749.749 0 0 1-.714-.784 6.004 6.004 0 0 1 3.899-5.339 3.754 3.754 0 0 1-1.663-3.119Z"></path><path d="M15.75 6.875c0 .874-.448 1.643-1.127 2.09a.265.265 0 0 0-.123.22v.59c0 .067-.026.13-.073.177l-.356.356a.125.125 0 0 0 0 .177l.356.356c.047.047.073.11.073.176v.231c0 .067-.026.13-.073.177l-.356.356a.125.125 0 0 0 0 .177l.356.356c.047.047.073.11.073.177v.287a.247.247 0 0 1-.065.168l-.8.88a.52.52 0 0 1-.77 0l-.8-.88a.247.247 0 0 1-.065-.168V9.185a.264.264 0 0 0-.123-.22 2.5 2.5 0 1 1 3.873-2.09ZM14 6.5a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Z"></path></svg> Sign in with a passkey”\*\*\*\*。
3. 按照浏览器或平台中的提示，选择可从在用设备使用的密钥，然后完成身份验证过程。 例如，出现提示时，你可能会触摸指纹传感器或输入 PIN。

## 使用附近的设备通过密钥登录

1. 导航到 GitHub 的登录页面，地址为 `https://HOSTNAME/login?passkey=true`。
2. 单击“<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-passkey-fill" aria-label="passkey-fill" role="img"><path d="M2.743 4.757a3.757 3.757 0 1 1 5.851 3.119 5.991 5.991 0 0 1 2.15 1.383c.17.17.257.405.258.646.003.598.001 1.197 0 1.795L11 12.778v.721a.5.5 0 0 1-.5.5H1.221a.749.749 0 0 1-.714-.784 6.004 6.004 0 0 1 3.899-5.339 3.754 3.754 0 0 1-1.663-3.119Z"></path><path d="M15.75 6.875c0 .874-.448 1.643-1.127 2.09a.265.265 0 0 0-.123.22v.59c0 .067-.026.13-.073.177l-.356.356a.125.125 0 0 0 0 .177l.356.356c.047.047.073.11.073.176v.231c0 .067-.026.13-.073.177l-.356.356a.125.125 0 0 0 0 .177l.356.356c.047.047.073.11.073.177v.287a.247.247 0 0 1-.065.168l-.8.88a.52.52 0 0 1-.77 0l-.8-.88a.247.247 0 0 1-.065-.168V9.185a.264.264 0 0 0-.123-.22 2.5 2.5 0 1 1 3.873-2.09ZM14 6.5a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0Z"></path></svg> Sign in with a passkey”\*\*\*\*。
3. 按照浏览器或平台中的提示，选择可通过附近设备（如手机或平板电脑）使用的密钥。
4. 继续按照提示启动身份验证过程。 例如，可以选择扫描 QR 码，或触发对附近设备的推送通知。
5. 在附近设备上，按照提示完成身份验证过程。 例如，如果你使用的是 iPhone，可以执行 Face ID 或输入密码。

## 其他阅读材料

* [关于密钥](/zh/enterprise-server@3.22/authentication/authenticating-with-a-passkey/about-passkeys)
* [管理通行密钥](/zh/enterprise-server@3.22/authentication/authenticating-with-a-passkey/managing-your-passkeys)