ActiveState 2FA：如何设置身份验证器 App
作者：Novaz 团队 · 更新于 2026年10月29日
Novaz 操作步骤已在 1.0.5 版本中核实
本文译自英文指南。在服务的网站上，按钮和菜单的中文名称可能略有不同。
本页内容
你用 ActiveState Platform 账号登录来构建运行时、在命令行中使用 State Tool，以及访问你所在组织的私有项目。ActiveState 为使用密码登录的账号提供可选的双重认证（2FA）。它的文档只介绍了一种方式，即身份验证器 App 生成的 6 位验证码，而且没有强制要求 2FA。ActiveState 的文档举了 Google Authenticator 和 Authy 作为例子，但说明任何能读取二维码的类似 App 都可以（ActiveState）。本指南以 iPhone 上的 Authenticator App - Novaz 为例。其他身份验证器 App 的操作也一样。
我们如何核实本指南： ActiveState 的步骤来自 ActiveState 自己的文档（链接见下文），我们于 2026 年 10 月 21 日查阅。我们没有在 ActiveState 账号上实际测试，因此个别标签可能略有不同。Novaz 的步骤已在 1.0.5 版 App 中核对。
开始之前：登录方式很重要
ActiveState 账号可以用电子邮件地址和密码创建，也可以用 GitHub 账号创建（ActiveState）。这里介绍的 2FA 是 ActiveState 自己的，与你的 ActiveState 密码配合使用。ActiveState 的文档没有说明用 GitHub 登录时它是否适用。这种情况下，登录由 GitHub 自己的安全设置保护。
公司也可以通过 ActiveState 支持或客户经理，把 Platform 连接到自己的单点登录。如果你的组织这样做了，请向你的 IT 团队了解 2FA 对你来说如何运作。
使用身份验证器 App 开启 2FA
ActiveState 的文档给出了以下步骤（ActiveState）：
- 登录 ActiveState Platform。打开右上角显示你用户名的菜单，选择 Account Settings（账号设置）。
- 点击 Two-factor Authentication（双重认证），然后点击 Enable（启用）。
- ActiveState 会显示一个二维码。在 Novaz 中点按 +，然后点按 扫描二维码，将相机对准二维码。如果二维码就显示在你的 iPhone 屏幕上，先截屏，再点按 +，然后点按 选择照片。参阅在同一台 iPhone 上扫描二维码。
- 在文本框中输入 Novaz 中的 6 位验证码，点击 Confirm（确认）。
验证码被接受后，2FA 就开启了。
ActiveState 的文档只介绍了扫描二维码，没有提到可以代替扫码手动输入的文本密钥。如果你确实看到了密钥，就在 Novaz 中点按 +，然后点按 手动输入密钥，把它填入 设置密钥 字段。参阅什么是 2FA 设置密钥？
ActiveState 什么时候要求输入验证码
根据 ActiveState 的说明，开启 2FA 后，每次登录都需要输入密码和 App 中的当前验证码。文档没有介绍信任某台设备从而跳过验证码的方法（ActiveState）。
State Tool
运行 state auth 会在浏览器中打开 Platform 登录页面，你照常在那里输入验证码即可（ActiveState）。如果你改为通过命令行参数输入用户名和密码登录，命令参考中列出了一个用于输入 App 验证码的 --totp 参数，它只能与用户名和密码参数一起使用（ActiveState）。
对于 CI/CD 流水线，ActiveState 建议把 API 密钥保存在 ACTIVESTATE_API_KEY 环境变量中，你可以用 state export new-api-key 生成它（ActiveState）。这样你的构建服务器就不需要你手机上的验证码。
文档中没有备用码
ActiveState 的文档没有提到备用码或恢复码，也没有介绍第二种 2FA 方式。Novaz 把密钥保存在你的 iPhone 上，所以除非你在 设置 › 备份 中开启 iCloud 备份或导出备份文件，否则那台 iPhone 就是你获取 ActiveState 验证码的唯一来源。请保管好它，并在需要之前先读一读下面的恢复部分。一般性的背景知识见2FA 备用码。
如果 ActiveState 不接受你的验证码
ActiveState 的文档没有讲到验证码被拒的情况。最常见的原因是 iPhone 的时钟。打开 设置 › 通用 › 日期与时间，开启 自动设置。时钟偏差达到 15 秒或以上时，Novaz 也会提醒你。另外，请确保在验证码更换之前输入。其他原因见身份验证器验证码无效？
更换手机
ActiveState 没有介绍如何把 2FA 转移到新手机。根据它确实写明的步骤，可以这样做：趁旧手机还在手边，用验证码登录，在 Account Settings › Two-factor Authentication 中关闭 2FA，然后重新开启，用新手机扫描新的二维码。如果有 Novaz 的 iCloud 备份或备份文件，你也可以直接在新 iPhone 上恢复账号；如果没有，就按上面的方法操作。参阅如何把身份验证器 App 转移到新 iPhone。
如果丢失了身份验证器
ActiveState 的文档没有说明丢失了装有验证码的手机时该怎么办，也没有说明支持团队会要求提供什么证明，或者重置需要多长时间。自己关闭 2FA 的第一步是用验证码登录，所以手机一旦丢了，这条路也走不通（ActiveState）。也不要指望重置密码：ActiveState 的密码页面没有说重置密码会关闭 2FA（ActiveState）。
ActiveState 为账号事务提供的支持联系方式是 support@activestate.com，例如用于更改账号的电子邮件地址（ActiveState）。请用账号绑定的电子邮件给这个地址写信。需要立即采取的步骤见丢了装有身份验证器 App 的手机？
关闭 2FA
只要还能获取验证码，你随时都可以关闭 2FA。用验证码登录，从用户名菜单中打开 Account Settings，点击 Two-factor Authentication，然后点击 Disable（停用）。下次登录时，ActiveState 就不会再要求输入验证码（ActiveState）。在 Novaz 中打开 ActiveState 账号，点按 移除账号。
