组织安全
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
Capgo 提供全面的安全控制功能,允许组织管理员在所有成员中强制执行安全策略。这些功能有助于您满足合规要求、保护敏感数据并维持强大的安全态势。
概览
“概览”章节组织安全设置允许超级管理员配置:
- 强制启用双重身份验证 (2FA) - 要求所有成员启用 2FA
- 密码策略 - 设置密码复杂度要求
- API 密钥安全 - 强制使用安全的 API 密钥并执行过期策略
- SSO(仅限 Enterprise 版) - 为您的域名提供 SAML 2.0 单点登录。适用于 Enterprise 套餐。请参阅 SSO 设置指南.

安全页面划分为几个标注清晰的板块:
- 安全标签页 - 通过组织设置侧边栏访问所有安全设置
- 强制启用 2FA - 双重身份验证 (2FA) 要求的开关与状态显示
- 密码策略 - 为组织成员配置密码复杂度规则
- API 密钥策略 - 安全 API 密钥及有效期要求的设置
- API 密钥有效期 - 控制 API 密钥是否必须设置有效期
访问安全设置
标题为“访问安全设置”的章节- 点击以下项进入组织设置: 设置 在侧边栏中
- 点击 组织 设置页面顶部的标签页
- 选择 安全 组织导航栏中的标签页(以盾牌图标高亮显示)
强制启用双重身份验证 (2FA)
“双因素身份验证 (2FA) 强制执行”部分强制启用 2FA 后,组织内所有成员都必须在其账户上启用双因素身份验证。这要求同时提供密码和验证 code,增加了一层关键的安全保障。
强制启用 2FA 后会发生什么
“强制启用 2FA 后会发生什么”部分- 未启用 2FA 的成员将 立即被阻止 访问组织应用
- Web dashboard 和 CLI 均强制执行此要求
- 新成员必须启用 2FA 才能访问组织资源
- 系统会实时追踪哪些成员已启用 2FA
了解 2FA 状态面板
标题为“了解 2FA 状态面板”的部分Security 页面展示了一个全面的 成员 2FA 状态 面板,其中显示:
- 成员总数 - 组织中的成员总数
- 已启用 2FA (绿色指示器)- 已成功启用双重身份验证的成员
- 未启用 2FA (橙色警告指示器)- 仍需设置 2FA 的成员
当成员未启用 2FA 时,他们会显示在一个 未启用 2FA 的成员 警告框中。该框显示:
- 每位成员的电子邮件地址及其在组织中的角色
- 一套 复制邮箱列表 用于快速复制所有受影响电子邮件地址以便沟通的按钮
启用 2FA 强制执行
标题为“启用 2FA 强制策略”的章节- 前往 组织设置 > 安全
- 找到 要求所有成员启用 2FA 页面顶部的区块
- 请查阅 成员 2FA 状态 查看哪些成员会受影响的面板
- 如果有成员未启用 2FA,请使用 复制邮箱列表 按钮,在启用前通知他们
- 切换旁边的开关 要求所有成员启用 2FA 以启用强制策略
- 该开关将显示 已禁用 或 已启用 状态位于右侧
CLI 支持 2FA 强制策略
标题为“CLI 支持 2FA 强制策略”的章节你也可以通过 CLI 管理 2FA 强制策略:
# Enable 2FA enforcementnpx @capgo/cli organization set YOUR_ORG_ID --enforce-2fa
# Disable 2FA enforcementnpx @capgo/cli organization set YOUR_ORG_ID --no-enforce-2fa
# Check member 2FA statusnpx @capgo/cli organization members YOUR_ORG_ID有关 2FA 强制策略的详细信息,请参阅 2FA 强制策略指南.
密码策略
标题为“密码策略”的章节密码策略允许你为所有组织成员强制实施密码复杂度要求。当成员的密码不符合策略要求时,他们必须在访问组织资源之前更新密码。
密码策略部分(在概览图中以指示器标记) 3 提供了一个简单的开关,用于在整个组织中强制实施密码要求。
密码策略如何工作
标题为“密码策略如何工作”的部分启用密码策略后:
- 所有组织成员都必须满足密码复杂度要求
- 未满足要求的用户将被锁定,直到他们更新密码
- 无论角色如何,该策略适用于所有成员
启用密码策略
标题为“启用密码策略”的部分- 前往 组织设置 > 安全
- 向下滚动以查找 密码策略 章节
- 阅读说明:“要求组织成员使用符合特定复杂性要求的密码”
- 切换 强制密码策略 开关以启用它
- 切换说明写道:“启用后,所有组织成员必须满足密码要求才能访问组织”
可用的密码要求
标题为“可用的密码要求”的部分| 设置 | 描述 | 范围 |
|---|---|---|
| 最小长度 | 所需的最少字符数 | 6-128 个字符 |
| 要求大写字母 | 密码必须包含至少一个大写字母 (A-Z) | 开启/关闭 |
| 要求数字 | 密码必须包含至少一个数字 (0-9) | 开启/关闭 |
| 要求特殊字符 | 密码必须包含至少一个特殊字符 (!@#$%^&*, 等) | 开启/关闭 |
成员合规性追踪
标题为“成员合规性追踪”的章节密码策略启用时,你可以监控合规情况:
- 成员总数: 你组织中的成员数量
- 已合规: 密码符合策略要求的成员
- 未合规: 需要更新密码的成员
未合规成员会连同邮箱地址一起列出。你可以复制邮箱列表,通知他们相关策略和需要修改的密码。
密码策略最佳实践
章节标题:“密码策略最佳实践”- 从合理的要求开始:至少 10-12 个字符,包含大小写字母和数字,既能提供良好的安全性,又不会过于严格
- 沟通变更:在启用新的密码要求之前通知您的团队
- 预留过渡时间:给成员时间更新他们的密码
- 考虑使用密码管理器:建议团队成员使用密码管理器来生成和存储强密码
API 密钥安全
章节标题为“API 密钥安全”Capgo 为 API 密钥提供两项安全控制:强制使用安全(哈希)的 API 密钥,以及要求设置过期日期。API 密钥策略部分(在概览图中用指示符 4 标出)通过密钥图标标识。
强制使用安全 API 密钥
章节标题为“强制使用安全 API 密钥”API 密钥策略部分中的第一个选项是 强制使用安全 API 密钥。启用后,此设置要求您组织中的所有 API 密钥都必须使用安全/哈希格式创建。
哈希后的 API 密钥更安全,因为:
- 实际密钥值绝不会存储在我们的服务器上
- 只有您(以及您的系统)能访问完整密钥
- 即使我们的数据库遭到入侵,您的密钥也无法被使用
开关说明为:“启用后,仅安全(哈希)API 密钥可访问此组织。明文 API 密钥将被拒绝。”
启用安全的 API 密钥
标题为“启用安全 API 密钥”的章节- 前往 组织设置 > 安全
- 向下滚动查找 API 密钥策略 章节(查找密钥图标)
- 找到 强制使用安全 API 密钥 开关
- 打开开关,启用 API 安全密钥强制策略
- 现有密钥不受影响;该策略仅适用于新建密钥
API 密钥过期策略
标题为“API 密钥过期策略”的章节第二个选项(标有指示器 5 ,见概览图)是 要求 API 密钥设置过期时间。你可以要求所有 API 密钥都设置过期日期,从而限制其有效期。
这是一项安全最佳实践,可以:
- 限制密钥泄露后的暴露窗口
- 确保定期进行密钥轮换
- 帮助满足凭据管理的合规要求
开关描述为:“启用后,该组织的所有 API 密钥都必须设置有效期”
配置过期策略
标题为“配置过期策略”的章节- 前往 组织设置 > 安全
- 找到 API 密钥策略 章节
- 找到 要求 API 密钥设置过期时间 切换(位于“强制使用安全 API 密钥”下方)
- 切换开关以启用过期要求
- 启用后,设置 最大过期天数 (1-365 天)
- 这限制了过期日期可以设置到未来的最远时间
- 示例:设置为 90 天意味着密钥最多可在创建后 90 天过期
推荐的 API 密钥策略
章节标题为“推荐的 API 密钥策略”| 使用场景 | 安全密钥 | 过期时间 | 最大天数 |
|---|---|---|---|
| 开发 | 推荐 | 可选 | 30-90 |
| CI/CD 流水线 | 必填 | 必填 | 90-180 |
| 生产环境 | 必填 | 必填 | 30-90 |
| 企业/合规 | 必填 | 必填 | 30-60 |
合规与审计
“合规与审计”部分组织安全功能可帮助您满足各种合规要求:
| 标准版 | 相关功能 |
|---|---|
| SOC 2 合规 | 强制 2FA、密码策略、API 密钥控制 |
| ISO 27001 | 所有安全功能都有助于证明访问控制 |
| HIPAA | 强身份验证与访问管理 |
| GDPR | 通过访问控制保护数据 |
| PCI DSS | 多因素认证、强密码 |
监控合规状态
章节标题:“监控合规状态”Security dashboard 可实时查看:
- 已启用 2FA 的成员数量
- 组织内密码策略合规情况
- API 密钥安全采用情况
使用“复制邮件列表”功能,轻松导出不合规成员列表,便于定向沟通。
故障排除
“故障排除”章节“访问被拒绝:未满足安全策略”
章节标题:“访问被拒绝:未满足安全策略”问题:成员无法访问该组织。
解决方案:
- 检查是否强制启用 2FA - 成员需要 启用 2FA
- 检查密码策略是否生效 - 成员需要更新密码
- 在 Security dashboard 中验证成员的合规状态
无法启用安全功能
标题为“无法启用安全功能”的章节问题:安全开关已禁用或无响应。
解决方案:
- 确保您拥有 超级管理员 组织角色
- 请检查网络连接
- 请尝试刷新页面
- 如果问题仍然存在,请联系支持团队
API 密钥创建失败
“API 密钥创建失败”章节问题:无法创建新的 API 密钥。
解决方案:
- 如果强制使用安全密钥,请确保使用安全密钥创建流程
- 如果需要设置有效期,请在允许的范围内设置过期日期
- 检查最大过期天数设置
下一步
“后续步骤”章节从组织安全继续
“组织安全”章节如果你正在使用 组织安全 来规划安全与合规,请结合 加密 了解 Encryption 的实现细节, 合规性 了解合规部分的实现细节, Capgo 安全扫描器 了解 Capgo Security Scanner 的产品工作流, Capgo 安全 用于 Capgo 安全的产品工作流,以及 Capgo 信任中心 用于 Capgo 信任中心的产品工作流。