关于 custom security configurations
使用 custom security configurations,可以为 GitHub 的安全产品创建启用设置集合,以满足组织的特定安全需求。 例如,可以为每个存储库组创建不同的 custom security configuration 以反映其不同级别的可见性、风险容忍度和影响。
创建安全配置时,请记住:
- 只有站点管理员在你的 GitHub Enterprise Server 实例上安装的功能才会显示在 UI 中。
- 如果你的组织或 GitHub Enterprise Server 实例持有 GitHub Advanced Security 许可证,那么 GitHub Advanced Security 功能才会可见。
- 某些功能,如 Dependabot security updates 和 code scanning 默认设置,还要求 GitHub Enterprise Server 实例上已安装 GitHub Actions。
创建 custom security configuration
Note
某些安全功能的启用状态取决于其他更高级别的安全功能。 例如,禁用 机密扫描警报 也将禁用非提供程序模式和推送保护。
-
在 GitHub 的右上角,选择个人资料照片,然后单击“你的组织”。
-
在组织名称下,单击 “设置”****。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。
-
在边栏的“安全性”部分中,选择“代码安全”下拉菜单,然后单击“配置”。
-
在“代码安全配置”部分中,单击“新建配置”。
-
为帮助识别 custom security configuration 并在“Code security configurations”页面上明确其用途,请为配置命名并创建一段说明。
-
在“GitHub Advanced Security 功能”行中,选择是包含还是排除 GitHub Advanced Security (GHAS) 功能。 如果计划将带有 GHAS 功能的 custom security configuration 应用到专用存储库,则这些存储库的每个活动的唯一提交者都必须有可用的 GHAS 许可证,否则不会启用该功能。 请参阅 关于 GitHub 高级安全的计费。
-
在安全设置表的“Dependency graph and Dependabot”部分中,选择要启用、禁用还是保留以下安全功能的现有设置:
- Dependabot alerts。 若要详细了解 Dependabot,请参阅 关于 Dependabot 警报。
- 安全更新。 若要了解安全更新,请参阅 关于 Dependabot 安全更新。
Note
你无法手动更改依赖项关系图的启用设置。 此设置由实例级别的站点管理员安装和管理。
-
在安全设置表的“Code scanning”部分中,选择是要启用、禁用还是保留 code scanning 默认设置的现有设置。 若要了解默认设置,请参阅 配置代码扫描的默认设置。
-
在安全设置表的“Secret scanning”部分中,选择要启用、禁用还是保留以下安全功能的现有设置:
- 警报。 要了解 机密扫描警报,请参阅 关于机密扫描。
- 非提供商模式。 若要了解有关扫描非提供程序模式的详细信息,请参阅 支持的机密扫描模式 和 查看和筛选机密扫描警报。
- 推送保护。 若要了解推送保护,请参阅 关于推送保护。
-
(可选)在“策略”部分中,可以选择根据其可见性自动将 security configuration 应用到新创建的存储库。 选择“None”下拉菜单,然后单击“Public”、“Private and internal”或“All repositories”****************。
Note
组织的默认 security configuration 仅自动应用到组织内新创建的存储库。 如果将存储库传输到组织,则仍需将适当的 security configuration 手动应用到存储库。
-
或者,在“策略”部分中,可以强制实施配置并阻止存储库所有者更改配置启用或禁用的功能(将不会强制执行未设置的功能)。 在“强制实施配置”旁边,从下拉菜单中选择“强制实施”。
Note
如果组织中的用户尝试使用 REST API 更改强制配置中某个功能的启用状态,则 API 调用将显示为成功,但不会更改任何启用状态。
在某些情况下,可能会中断存储库的 security configurations 强制实施。 例如,在以下情况下,code scanning 的启用将不适用于存储库:
- GitHub Actions 最初在存储库上启用,但在存储库中禁用。
- code scanning 配置所需的 GitHub Actions 在存储库中不可用。
- 具有标签
code-scanning
的自承载运行器不可用。 - 不应使用 code scanning 默认设置分析语言的定义已更改。
-
若要完成 custom security configuration 的创建,请单击“保存配置”。
后续步骤
如需了解如何将 custom security configuration 应用到组织中的仓库,请参阅 删除自定义安全配置。
若要了解如何编辑 custom security configuration,请参阅“编辑自定义安全配置”。