• 错误：HTTP Basic: Access denied. If a password was provided for Git authentication ...
• 错误：invalid pin code
• 错误：生成恢复代码时 Permission denied (publickey)
• 恢复选项和 2FA 重置
  • 使用恢复代码
  • 使用 SSH 生成新的恢复代码
  • 重置帐户上的 2FA
  • 为企业用户重置 2FA

{{< details >}}

• Tier: 基础版，专业版，旗舰版
• Offering: JihuLab.com, 私有化部署

{{< /details >}}

错误：HTTP Basic: Access denied. If a password was provided for Git authentication ...

当发出请求时，您可能会收到如下错误信息：

HTTP Basic: Access denied. If a password was provided for Git authentication, the password was incorrect or you're required to use a token instead of a password. If a token was provided, it was either incorrect, expired, or improperly scoped.

发生此错误的情况是：

• 您已启用 2FA，并尝试使用用户名和密码进行身份验证。
• 您未启用 2FA，并尝试使用错误的用户名或密码进行身份验证。
• 您未启用 2FA，并且 强制所有用户启用 2FA 设置已激活。
• 您未启用 2FA，并且 为 Git 启用 HTTP(S) 的密码认证 设置未激活。

解决此错误的方法：

• 使用具有正确范围的 个人访问令牌：
  • 对于 HTTP(S) 上的 Git 请求：read_repository 或 write_repository
  • 对于 极狐GitLab容器注册表 请求：read_registry 或 write_registry
  • 对于 依赖代理 请求：read_registry 和 write_registry
• 如果您配置了 LDAP，请使用 LDAP 密码。
• 使用 OAuth 凭证助手。

错误：invalid pin code

invalid pin code 错误可能表明身份验证应用程序与极狐GitLab 实例之间存在时间同步问题。

解决此问题的方法是，打开生成您 2FA 代码的设备的时间同步功能。

{{< tabs >}}

{{< tab title=”Android” >}}

1. 转到 设置 > 系统 > 日期和时间。
2. 打开 自动设置时间。如果该设置已打开，关闭它，等待几秒，然后再次打开。

{{< /tab >}}

{{< tab title=”iOS” >}}

1. 转到 设置 > 通用 > 日期和时间。
2. 打开 自动设置。如果该设置已打开，关闭它，等待几秒，然后再次打开。

{{< /tab >}}

{{< /tabs >}}

错误：生成恢复代码时 Permission denied (publickey)

您可能会收到 Permission denied (publickey) 的错误信息。

如果您使用的是非默认 SSH 密钥对文件路径，并尝试通过 使用 SSH 生成恢复代码，就会出现此问题。

要解决此问题，请使用 ssh-agent 配置 SSH 指向不同目录。

恢复选项和 2FA 重置

如果您启用了 2FA，但无法生成代码，请使用以下方法之一来访问您的帐户：

使用恢复代码

当您启用 2FA 时，极狐GitLab 为您提供了一系列恢复代码。您可以使用这些代码登录您的帐户。

要使用恢复代码：

1. 在极狐GitLab 登录页面上，输入您的用户名或电子邮件和密码。
2. 在提示输入双重认证代码时，输入恢复代码。

使用恢复代码后，您不能再次使用相同的代码。您的其他恢复代码仍然有效。

使用 SSH 生成新的恢复代码

如果您已在极狐GitLab 帐户中添加了 SSH 密钥，则可以使用 SSH 生成一组新的恢复代码：

1. 在终端中运行：

   ssh git@JihuLab.com 2fa_recovery_codes
   

   在极狐GitLab 私有化部署实例中，将 gitlab.com 替换为极狐GitLab 服务器主机名（例如 gitlab.example.com）。

2. 在确认消息中输入 yes。
3. 保存极狐GitLab 生成的恢复代码。您之前的恢复代码不再有效。
4. 在登录页面上，输入您的用户名或电子邮件和密码。
5. 在提示输入双重认证代码时，输入您的新恢复代码之一。

登录后，立即使用新设备设置 2FA。

重置帐户上的 2FA

{{< details >}}

• Tier: 专业版，旗舰版
• Offering: JihuLab.com

{{< /details >}}

如果之前的恢复选项不起作用，您仍无法登录您的帐户，可以创建一个支持请求以禁用帐户上的 2FA。禁用 2FA 后，请尽快重新启用它以确保帐户安全。

此服务仅对拥有 JihuLab.com 订阅的帐户可用。

要创建支持请求：

1. 转到 极狐GitLab 支持。
2. 选择 提交票据。
3. 如果可能，请登录您的帐户。
4. 在议题下拉列表中，选择 极狐GitLab.com 用户帐户和登录问题。
5. 完成支持表单中的字段。
6. 选择 提交。

为企业用户重置 2FA

如果您是付费计划中的顶级群组所有者，您可以为企业用户禁用 2FA。有关详细信息，请参阅 禁用双重认证。