跳转到正文

强制启用 2FA

双因素认证(2FA)强制策略允许组织管理员要求所有成员在访问组织资源前,必须在其账户上启用 2FA。这为您的应用和数据提供了更高水平的安全保障。

当组织启用 2FA 强制策略时:

  • 所有成员必须在其 Capgo 账户上启用 2FA
  • 未启用 2FA 的成员将被拒绝访问该组织的应用
  • Web 仪表板和 CLI 都将执行此要求
  • 新成员必须启用 2FA 才能访问组织资源

当您尝试访问要求启用 2FA 的组织,但尚未启用时:

  1. 您将看到访问被拒绝的消息
  2. 您将被引导至账户设置中启用 2FA
  3. 启用后,您可以正常访问该组织

当使用 Capgo CLI 与要求启用 2FA 的组织中的应用程序交互时:

🔐 Access Denied: Two-Factor Authentication Required
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
This organization requires all members to have 2FA enabled.
To regain access:
1. Go to https://web.capgo.app/settings/account
2. Enable Two-Factor Authentication on your account
3. Try your command again
  1. 前往您的组织设置
  2. 前往 安全 章节
  3. 切换 要求所有成员启用 2FA
  4. 确认操作

你可以使用 Capgo CLI 启用 2FA 强制:

终端窗口
# Enable 2FA enforcement for an organization
npx @capgo/cli organization set YOUR_ORG_ID --enforce-2fa
# Disable 2FA enforcement
npx @capgo/cli organization set YOUR_ORG_ID --no-enforce-2fa

通过 CLI 启用时,你会看到:

  • 哪些成员未启用 2FA
  • 如果你自己未启用 2FA,会显示警告
  • 应用更改前的确认 prompt

你可以列出所有组织成员及其 2FA 状态:

终端窗口
npx @capgo/cli organization members YOUR_ORG_ID

这将显示:

  • 成员邮箱与角色
  • 是否已启用 2FA
  • 需要启用 2FA 的成员数量摘要

在组织设置中,你可以查看每个成员是否已启用 2FA。

如果您需要为账号启用 2FA,请参阅我们的 双重身份验证 (2FA) 设置指南.

  • 提前沟通:在启用强制执行前,至少提前一周通知成员
  • 提供支持:分享 2FA 设置指南 与团队一起
  • 检查准备情况:使用 npx @capgo/cli organization members 查看谁还需要启用 2FA
  • 监控访问问题:随时准备帮助被锁定的成员
  • 保留备用代码:提醒成员保存自己的 2FA 备用代码
  • 定期审查:定期检查所有成员是否已启用 2FA
  • 使用 API 密钥:CI/CD 系统应使用 API 密钥,而非用户账户
  • API 密钥所有者:确保创建 CI/CD API 密钥的用户已启用 2FA
  • 轮换密钥:定期轮换自动化系统中使用的 API 密钥

“访问被拒绝:需要双因素身份验证”

标题:“拒绝访问:需要双重身份验证”

问题:你在尝试访问组织时会看到这个错误。

解决方案:

  1. 前往 账号设置
  2. 为你的账号启用 2FA
  3. 再次尝试访问该组织

“无法启用 2FA 强制执行”

标题:“无法启用 2FA 强制执行”

问题:你无法为你的组织启用 2FA 强制执行。

解决方案:

  • 确保您拥有 super_admin 组织中的相应权限
  • 请先在自己的账户上启用 2FA
  • 如果问题仍然存在,请联系支持团队

问题:CLI 命令因 2FA 相关错误而失败。

解决方案:

  • 验证您的 API 密钥是否有效: npx @capgo/cli doctor
  • 确保 API 密钥的所有者已启用 2FA
  • 如果使用基于登录的身份验证,请重新验证: npx @capgo/cli login

强制启用 2FA 有助于您的组织满足各种合规要求:

标准版要求2FA 如何提供帮助
SOC 2 合规访问控制确保所有用户进行强身份验证
ISO 27001信息安全增加一层身份验证
HIPAA访问管理防止未授权访问
GDPR数据保护降低账号被盗风险
PCI DSS身份验证控制符合多因素身份验证要求

如果你正在使用 强制启用 2FA 来规划安全与合规,请结合 加密 了解 Encryption 的实现细节, 合规性 了解合规部分的实现细节, Capgo 安全扫描器 了解 Capgo Security Scanner 的产品工作流, Capgo 安全 用于 Capgo 安全的产品工作流,以及 Capgo 信任中心 用于 Capgo 信任中心的产品工作流。