使用任务列表跟踪问题中的代码扫描警报

您可以使用任务列表将代码扫描警报添加到议题中。 这样可以轻松创建包括修复警报在内的开发工作计划。

谁可以使用此功能？

If you have write permission to a repository you can track code scanning alerts in issues using task lists.

Code scanning 可用于 GitHub.com 上的所有公共存储库。 若要在组织拥有的专用存储库中使用 code scanning，必须具有 GitHub Advanced Security 许可证。 有关详细信息，请参阅“关于 GitHub 高级安全性”。

本文内容

注意：议题中 code scanning 警报的跟踪目前为 beta 版本，可能会发生更改。

此功能支持使用 GitHub Actions 在本机运行分析，或使用现有 CI/CD 基础结构以及第三方 code scanning 工具在外部运行分析，但不支持第三方跟踪工具。

关于跟踪议题中的 code scanning 警报

Code scanning 警报与 GitHub Issues 中的任务列表集成，使你能够在所有开发工作中确定警报的优先级并对其进行跟踪。 若要跟踪已有问题中的 code scanning 警报，请将警报的 URL 添加为问题中的任务列表项。 有关任务列表的详细信息，请参阅“关于任务列表”。

你还可以快速创建新议题来跟踪警报：

您可以使用多个议题来跟踪同一 code scanning 警报，并且议题可属于找到 code scanning 警报的存储库中的不同存储库。

GitHub Enterprise Cloud 在用户界面的不同位置提供视觉提示，以指示何时跟踪议题中的 code scanning 警报。

  • code scanning 警报列表页将显示在问题中跟踪的警报，以便你可以一目了然地查看哪些警报仍需要处理以及如何在众多问题中跟踪警报。

    code scanning 警报视图的屏幕截图。 第一个条目包括议题图标，后跟数字 2。 第三个条目包括议题图标，后跟数字 1。 两个条目都以深橙色框出。

  • “tracked in（跟踪）”部分也会显示在相应的警报页面中。

    code scanning 警报的屏幕截图。 在警报标题下，“跟踪依据 #1、#2”以深橙色框出。

  • 在跟踪议题上，GitHub 会在任务列表和悬停卡上显示安全徽章图标。

    只有对存储库具有写入权限的用户才能看到议题中警报的展开 URL 以及悬停卡片。 对于对存储库具有读取权限或根本没有权限的用户，警报将显示为纯 URL。

    图标的颜色为灰色，因为警报在每个分支上的状态为“打开”或“关闭”。 议题跟踪警报，因此警报在议题中不能具有单个打开/关闭状态。 如果一个分支上的警报已关闭，则图标颜色不变。

    显示跟踪 code scanning 警报的议题的屏幕截图。 将显示警报的悬浮卡片，标题前有一个灰色的安全锁屏提醒图标。

如果更改议题中相应任务列表项的复选框状态（选中/未选中），则跟踪的警报状态不会更改。

创建跟踪议题

你可以创建新议题来直接跟踪警报，而不是跟踪现有议题中的 code scanning 警报。 你可以从警报或 API 为 code scanning 警报创建跟踪议题。

从 code scanning 警报创建跟踪问题

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 在存储库名称下，单击“ 安全性”。 如果看不到“安全性”选项卡，请选择 下拉菜单并单击“安全性” 。

    存储库标头的屏幕截图，其中显示了选项卡。 “安全性”选项卡以深橙色边框突出显示。

  3. 在左侧边栏中，单击 Code scanning。

  4. 在“Code scanning”下，单击要探索的警报以显示详细警报页。

  5. （可选）若要查找要跟踪的警报，可以使用自由文本搜索或下拉菜单来筛选和定位警报。 有关详细信息，请参阅“管理存储库的代码扫描警报”。

  6. 在页面顶部的右侧，单击“创建问题”。

    code scanning 警报的屏幕截图。 “创建议题”按钮以深橙色框出。

    GitHub 自动创建一个议题来跟踪警报，并将警报添加为任务列表项。 GitHub 会预填议题：

    • 标题包含 code scanning 警报的名称。
    • 正文包含任务列表项，其中包含 code scanning 警报的完整 URL。

  7. （可选）编辑议题的标题和正文。

    警告：你可能需要编辑问题的标题，因为它可能会暴露安全信息。 你还可以编辑议题的正文。 请确保将任务列表项与警报链接一起保留，否则议题将不再跟踪警报。

  8. 单击“提交新问题”。

从 API 创建跟踪议题

  1. 开始通过 API 创建议题。 有关详细信息，请参阅“创建议题”。

  2. 在议题正文中提供代码扫描链接。 你必须使用以下任务列表语法来创建跟踪关系：- [ ] FULL-URL-TO-THE-CODE-SCANNING-ALERT

    例如，如果将 - [ ] https://github.com/octocat-org/octocat-repo/security/code-scanning/17 添加到问题，该问题将在 octocat-org 组织的 octocat-repo 存储库的“安全性”**** 选项卡中跟踪 ID 号为 17 的 code scanning 警报。