在组织中应用 GitHub 建议的安全配置

使用由 GitHub 创建、管理和推荐的安全启用设置来保护代码。

谁可以使用此功能？

具有管理员角色的组织所有者、安全管理员和组织成员

本文内容

GitHub-recommended security configuration 是 GitHub 安全功能的启用设置集合，由 GitHub 主题专家创建和维护。 GitHub-recommended security configuration 旨在成功地降低高影响和低影响存储库的安全风险。 我们建议你将此配置应用于组织中的所有存储库。

Note

GitHub-recommended security configuration 包括 GitHub Code Security 和 GitHub Secret Protection 功能。 将配置应用于组织中的专用和内部仓库会产生使用费或需要许可证。

  1. 在 GitHub 的右上角，选择个人资料照片，然后单击“ 你的组织”****。

  2. 在组织名称下，单击 “设置”****。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  3. 在边栏的“Security”部分，选择“ Advanced Security”下拉菜单，然后单击“Configurations”********。

  4. 在组织的配置表的“GitHub 建议”行中，选择“应用于 ”下拉菜单，**** 然后单击“所有存储库”**** 或“所有无配置的存储库”****。

    Note

    组织的默认 security configuration 仅自动应用到组织内新创建的存储库。 如果将存储库传输到组织，则仍需将适当的 security configuration 手动应用到存储库。

  5. 查看有关更改如何影响 Secret Protection and Code Security 许可证消耗情况的详细信息。 若要应用 security configuration，请单击“应用”。

security configuration 适用于活动存储库和存档存储库，因为某些安全功能在存档存储库上运行，例如 secret scanning。 此外，如果存储库稍后取消存档，则可以确信它受到所选 security configuration 的保护。

  1. 在 GitHub 的右上角，选择个人资料照片，然后单击“ 你的组织”****。

  2. 在组织名称下，单击 “设置”****。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  3. 在边栏的“Security”部分，选择“ Advanced Security”下拉菜单，然后单击“Configurations”********。

  4. （可选）在“应用配置”部分中，筛选视图，查找要将 GitHub-recommended security configuration 应用到的存储库。 若要了解如何筛选仓库表，请参阅 使用存储库表筛选组织中的存储库。

  5. 在存储库表中，使用三种方法之一来选择存储库：

    • 选择要将 security configuration 应用到的存储库。
    • 若要选择仓库表当前页上显示的所有仓库，请选择与“NUMBER repositories”相关的复选框。
    • 选择仓库当前页“25 of NUMBER selected”后，单击“Select all”，即可选择组织内符合你应用的任何筛选器的所有仓库__****。

  6. **** 选择“应用配置 ”下拉菜单，然后单击****“GitHub 建议”。

    Note

    组织的默认 security configuration 仅自动应用到组织内新创建的存储库。 如果将存储库传输到组织，则仍需将适当的 security configuration 手动应用到存储库。

  7. 查看有关更改如何影响 Secret Protection and Code Security 许可证消耗情况的详细信息。 若要应用 security configuration，请单击“应用”。

security configuration 适用于活动存储库和存档存储库，因为某些安全功能在存档存储库上运行，例如 secret scanning。 此外，如果存储库稍后取消存档，则可以确信它受到所选 security configuration 的保护。

  1. 在 GitHub 的右上角，选择个人资料照片，然后单击“ 你的组织”****。

  2. 在组织名称下，单击 “设置”****。 如果看不到“设置”选项卡，请选择“”下拉菜单，然后单击“设置”********。

    组织配置文件中选项卡的屏幕截图。 “设置”选项卡以深橙色标出。

  3. 在边栏的“Security”部分，选择“ Advanced Security”下拉菜单，然后单击“Configurations”********。

  4. 在“Security configurations”部分，选择“GitHub recommended”。

  5. 在“策略”部分中的“强制实施配置”旁边，从下拉菜单中选择“强制实施”****。

Note

如果组织中的用户尝试使用 REST API 更改强制配置中某个功能的启用状态，则 API 调用将显示为成功，但不会更改任何启用状态。

在某些情况下，可能会中断存储库的 security configurations 强制实施。 例如，在以下情况下，code scanning 的启用将不适用于存储库：

  • GitHub Actions 最初在存储库上启用，但在存储库中禁用。
  • code scanning 配置所需的 GitHub Actions 在存储库中不可用。
  • 不应使用 code scanning 默认设置分析语言的定义已更改。

后续步骤

应用 GitHub-recommended security configuration 后，可以使用 global settings 自定义组织级别的安全设置。 请参阅 配置组织的全局安全设置。

尝试应用 security configuration 时可能会遇到错误。 有关详细信息，请参阅 查找和修复配置附加失败 和 排查安全配置问题。