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

Assembla 托管 Perforce、Subversion 和 Git 代码仓库，并提供项目管理工具（Assembla），所以你的 Assembla 登录往往守护着源代码。它支持用身份验证器 App 进行双重认证（2FA），组合（portfolio）所有者可以要求组合中的所有人都必须使用。它有两点与众不同。设置界面只给你一个二维码，没有其他任何东西，也没有可以手动输入的密钥。而且开启 2FA 后，你的密码在代码仓库客户端中就不能用了（Assembla）。

本指南以 iPhone 上的 Authenticator App - Novaz 为例。其他能生成基于时间验证码的身份验证器 App 操作也一样。

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

开始之前

• 用 SSO 登录？ Assembla 表示，使用单点登录的账号没有密码，而没有密码就无法开启 Assembla 自己的 2FA（Assembla）。
• 你的组合使用 Google 2FA： 同一篇文章指出，如果组合要求使用 Google 2FA，则该方式优先。除此之外它没有进一步解释。
• App 列表已经过时。 Assembla 的列表里仍然有 Windows Phone，但它的验证码是标准的基于时间的验证码，所以 Novaz 可以扫描同一个二维码。

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

Assembla 的帮助介绍了以下步骤（Assembla）：

1. 点击页面顶部你的头像。
2. 选择 My Profile（我的个人资料）› Two-factor authentication（双重认证）。页面会显示双重认证当前处于停用状态，并显示一个二维码。
3. 在 Novaz 中点按 +，然后点按 扫描二维码，将相机对准电脑屏幕上的二维码。如果 Assembla 就在这台 iPhone 上打开，先截屏，再点按 +，然后点按 选择照片。参阅在同一台 iPhone 上扫描二维码。
4. 在 Confirm current password（确认当前密码）下，输入你的 Assembla 密码。
5. 在 Enter the six-digit code from the application（输入应用程序中的六位数验证码）下，输入 Novaz 当前的验证码。
6. 点击 Enable（启用）。
7. 保存 Assembla 给你的恢复码文件。手机丢失时，它就是你重新登录的途径。

页面上没有设置密钥

Assembla 的界面不显示文本密钥。如果你的手机无法扫描，它的帮助给出了一个变通办法：用另一个二维码读取 App（例如桌面二维码读取器）解码二维码，得到一个 otpauth:// 链接。链接中 secret= 的部分就是密钥。在 Novaz 中，你可以通过 + › 手动输入密钥 把它填入 设置密钥。参阅什么是 2FA 设置密钥？

用 Novaz 扫描更简单。手动输入的密钥至少需要 16 个字符，而 Assembla 没有说明它的密钥有多长。

你的恢复码文件

开启 2FA 时，Assembla 会给你一个包含恢复码的文件。如果手机丢了，而你没有 Novaz 备份，或者是在最近一次导出备份文件之后才添加的 Assembla，这个文件就是你重新登录的途径。请把它放在不用那台手机也能拿到的地方。Assembla 的帮助没有说明文件里有多少个恢复码，也没有说明如何获取一组新的。详见2FA 备用码。

Git、SVN 和 Perforce 客户端

开启 2FA 后，外部客户端无法再用你的用户名和密码检出代码或提交。请改为创建 API 密钥（Assembla、Assembla）：

1. 点击你的头像，然后选择 My Profile › API Applications & Sessions（API 应用程序与会话）。
2. 勾选 Repository access（代码仓库访问），然后点击 Create（创建）。
3. 在客户端中，用你的 Assembla 用户名登录，并用 API secret（API 密钥）代替密码。

当 2FA 是必需的时

如果组合管理员开启了这项要求（More（更多）› Portfolio Admin（组合管理），然后在 Two-factor Authentication 部分选择 Enabled（已启用）并点击 Update 2FA Settings（更新 2FA 设置）），尚未开启 2FA 的成员必须在下次登录时完成设置。在此之前，他们完全无法进入 Assembla（Assembla）。

如果 Assembla 不接受你的验证码

Assembla 的帮助没有关于验证码被拒的建议。最常见的原因是手机时钟有偏差。在 iPhone 上，打开 设置 › 通用 › 日期与时间，开启 自动设置。时钟偏差达到 15 秒或以上时，Novaz 会显示警告。更多原因见身份验证器验证码无效？

更换手机、丢失手机或关闭 2FA

Assembla 对这三种情况的处理方式相同：先关闭 2FA，再用新设备重新开启（Assembla）。

1. 点击你的头像，然后选择 My Profile › Two-factor Authentication。
2. 在 Confirm current password 中输入密码。
3. 在 Enter the six-digit code from the application 中输入一个验证码。如果手机丢了，Assembla 表示可以在这个输入框中填入一个未使用过的恢复码。
4. 点击 Disable（停用）。之后你就可以重新设置 2FA。

如果你要换手机又没有 Novaz 备份，请趁旧 iPhone 还能用时操作。有 iCloud 备份或备份文件时，你也可以直接在新 iPhone 上恢复账号。参阅如何把身份验证器 App 转移到新 iPhone。

如果手机和恢复文件都丢了，Assembla 要求你发电子邮件到 support@assembla.com 重置账号。它的帮助没有说明支持团队需要什么证明，也没有说明需要多长时间。另请参阅丢了装有身份验证器 App 的手机？

Assembla 官方帮助

• Using Two-Factor Authentication with your Assembla Account
• Working on my Repos with Third Party Authentication
• Assembla: Managed Cloud Hosting For Perforce, SVN & Git