Bitrise 2FA：如何设置身份验证器 App

Bitrise 是一个移动端 CI/CD 平台：你的个人 Bitrise 账号用于进入运行 iOS 和 Android 构建的工作区和项目。双重认证（2FA）是可选的，使用身份验证器 App。开启之前，请先了解 Bitrise 的一点：如果你同时丢失了身份验证器和恢复码，Bitrise 表示它的支持团队一般无法替你关闭 2FA（Bitrise）。所以本指南在后备方案上花的篇幅和设置步骤一样多。

Bitrise 的文档提到的是 Google Authenticator，但设置用的是标准二维码，所以任何身份验证器 App 都可以。下面的步骤以 iPhone 上的 Authenticator App - Novaz 为例。

我们如何核实本指南： Bitrise 的步骤来自 Bitrise 官方文档及其截图（链接见下文），我们于 2026 年 10 月 21 日查阅。我们没有在 Bitrise 账号上实际测试，因此个别标签可能略有不同。Novaz 的步骤已在 1.0.5 版 App 中核对。

使用身份验证器 App 开启 2FA

这项设置位于你的个人账号中，而不是工作区中（Bitrise）：

1. 登录 Bitrise，在左侧导航菜单中选择 Bitrise CI。
2. 点击右上角的个人头像，然后选择 Account settings（账号设置）。
3. 在左侧选择 Security（安全）。
4. 在 Two-factor authentication（双重认证）下，点击 2FA is enabled（2FA 已启用）开关。（Bitrise 的文档在开启和关闭时都使用这个标签。）
5. 屏幕上会出现一个二维码。在 Novaz 中点按 +，然后点按 扫描二维码，将相机对准它。如果二维码就显示在这台 iPhone 上，先截屏，再改用 选择照片。参阅在同一台 iPhone 上扫描二维码。
6. 在 Bitrise 中输入 Novaz 中的 6 位验证码。
7. 保存 Bitrise 给你的恢复码。

2FA 开启且恢复码保存好之后，Bitrise 会从 letsconnect@bitrise.io 发送一封确认邮件。

Bitrise 的页面没有提到可以代替扫描、手动输入的文本密钥。如果你在设置屏幕上确实找到了密钥，在 Novaz 中点按 +，然后点按 手动输入密钥，把它粘贴到 设置密钥 中。参阅什么是 2FA 设置密钥？

恢复码才是真正的后备

没有 Novaz 备份（iCloud 备份或备份文件）时，Novaz 的密钥只存在于你的 iPhone 上；而无论有没有备份，在 Bitrise 内部，恢复码都是你唯一的后备。把它们存在密码管理器中或打印出来，并存放在远离手机的地方。

Bitrise 的 Security 页面截图显示有一个 Recovery codes（恢复码）部分，里面有一个 New recovery codes（新的恢复码）按钮，你可以在那里获取一组新的恢复码。页面文字没有说明会得到多少个，也没有说明旧的会怎样。关于如何保存，详见 2FA 备用码。

Bitrise 何时要求输入验证码

Bitrise 把 2FA 描述为登录流程中额外的一步（Bitrise）。它的文档没有说明能否把浏览器标记为受信任，也没有说明多久会要求一次。

如果你的工作区强制使用 SAML SSO，你要通过公司的身份提供方登录，而该提供方可以执行自己的 2FA 规则（Bitrise）。这种情况下，如何证明你的身份由雇主的配置决定。

如果 Bitrise 不接受你的验证码

Bitrise 的文档没有涉及验证码被拒的情况。最常见的原因是 iPhone 的时钟：打开 设置 › 通用 › 日期与时间，开启 自动设置。iPhone 的时钟偏差达到 15 秒或以上时，Novaz 会提醒你。还要注意，多次登录失败可能导致你的 Bitrise 账号被锁定，之后 Bitrise 会通过电子邮件发送解锁说明（Bitrise）。其他原因见身份验证器验证码无效？

更换手机

Bitrise 没有介绍把 2FA 转移到新手机的方法。有 Novaz 的 iCloud 备份或备份文件时，直接在新 iPhone 上恢复账号即可。如果没有，请注意 Bitrise 的文档说，登录状态下关闭 2FA 只需要输入 Bitrise 密码；所以趁旧手机还在，你可以先关闭 2FA 再重新开启，用新 iPhone 扫描新的二维码。记得保存新的恢复码。参阅如何把身份验证器 App 转移到新 iPhone。

如果丢失了身份验证器

先用恢复码。没有恢复码的话，你的选择很有限（Bitrise）：

• 已关联的 Git 账号。 如果你之前把 GitHub、GitLab 或 Bitbucket 关联到了 Bitrise，Bitrise 建议尝试通过它登录。你可以在账号中关联这些服务（Bitrise），值得在需要之前就做好。
• Bitrise 支持团队，仅限少数情况。 只有在已经关联了 Git 提供方账号时，Bitrise 才能移除 2FA。用你注册时使用的电子邮件地址给支持团队发邮件，说明原因。支持团队会要求你在那个 Git 账号上新建一个名为 bitrise_verification 的公开仓库，并把链接发给他们。如果移除 2FA 看起来存在安全风险，他们仍可能拒绝。
• 新账号。 如果没有关联任何 Git 账号，Bitrise 建议创建一个新的 Bitrise 账号。

Bitrise 没有说明支持请求需要多长时间。详见丢了装有身份验证器 App 的手机？

关闭 2FA

前往 Account settings › Security，点击 Two-factor authentication 下的 2FA is enabled，在 Edit profile（编辑个人资料）窗口中输入你的 Bitrise 密码，然后点击 Done（完成）（Bitrise）。然后在 Novaz 中打开 Bitrise 条目，点按 移除账号。

Bitrise 官方帮助

• Two-factor authentication
• Accounts overview
• Configuring SAML SSO on Bitrise
• Resetting your password