Skip to main content
Skip to content

安全配置状态

应用了 security configuration 的每个存储库都有一个配置状态,用于反映该存储库与该配置之间关系的当前状态。

存储库的配置状态指示其与已应用 security configuration的关系的当前状态。 这种关系可能会随时间而变化,例如,当存储库管理员重写设置、管理员启用强制或附件失败时。 有关配置和存储库交互方式的详细信息,请参阅 大规模启用安全功能。

可以在组织的设置页上的 security configurations 存储库表中查看配置状态,或使用 REST API 检索它们。 有关详细信息,请参阅 使用存储库表筛选组织中的存储库 和 配置。

配置状态参考

下表描述了所有配置状态、导致每个状态的原因、每个状态在组织设置存储库表中的显示方式以及建议的操作。

在存储库表中,“配置状态”筛选器支持“附加”、“已删除”、“失败”、“强制”和“企业删除”。 状态为 detached “无配置”的存储库显示为“无配置”,不能按 UI 中的配置状态进行筛选。 但是,在列出组织级配置的存储库时,REST API status 的参数会接受 detached 。

StatusDescription原因用户界面显示建议的操作
attached当前正在应用该配置。 存储库从配置继承所有设置。组织或企业管理员将配置应用到存储库。配置名称(例如,“我的配置”)无需采取任何行动。
attaching正在应用配置。 这是一个暂时性状态。组织或企业管理员刚刚应用了配置。
正在应用 CONFIGURATION-NAME等待操作完成。 如果状态没有更改,请检查是否存在附加失败问题。
updating正在存储库上更新配置。组织或企业管理员更改了配置中的设置。
更新 CONFIGURATION-NAME等待更新完成。
enforced该配置正在被主动应用并强制执行。 存储库管理员无法更改配置控制的功能的启用状态。组织或企业管理员在配置上启用了强制实施。
已强制执行 CONFIGURATION-NAME无需采取任何行动。 有关详细信息,请参阅“安全配置的强制执行”。
removed存储库级设置已更改,该设置与配置冲突。 配置仍与存储库关联,但存储库不再继承所有设置。存储库管理员更改了未强制配置的安全设置。
已删除 CONFIGURATION-NAME若要还原预期设置,请重新应用存储库的“Advanced Security”页中的配置。 为防止将来发生覆盖,请考虑启用强制执行。
removed_by_enterprise企业级配置更改导致与存储库设置发生冲突。企业管理员更改了与应用于存储库的组织级别配置冲突的设置。
已删除 CONFIGURATION-NAME与企业管理员协调以解决冲突。 在组织或企业级别重新应用配置。
failed无法将配置附加到存储库。现有存储库设置与配置之间的冲突导致无法附加。
失败原因在存储库表中按 config-status:failed 进行筛选,然后按照相应存储库的修复指南进行操作。 有关详细信息,请参阅“诊断安全配置问题”。
detached未应用任何配置。 存储库的安全设置是单独管理的。组织管理员解除了该配置的关联,或者该存储库从未关联到任何配置。无需配置如果希望存储库继承集中管理的设置,请应用配置。 有关详细信息,请参阅“删除自定义安全配置”。

理解 removed 与 detached

这些状态反映不同的情况:

  • removed:存储库管理员更改了与未强制配置冲突的安全设置。 配置仍与存储库相关联,但存储库不再计入组织的该配置的覆盖范围指标。 重新应用配置可还原关系。
  • detached:配置与存储库完全断开连接。 存储库的现有安全设置保持不变,但没有配置对其进行管理。 若要还原集中管理的设置,请应用新的配置。

若要防止存储库达到 removed 状态,请对配置启用强制。 有关详细信息,请参阅“安全配置的强制执行”。

使用审核日志跟踪配置状态更改

每当配置状态发生更改时,组织的审核日志记录 repository_security_configuration 事件。 可以使用筛选器搜索这些事件 action:repository_security_configuration 。 有关详细信息,请参阅 组织的审核日志事件 和 搜索企业的审核日志。

延伸阅读