|
| 1 | +--- |
| 2 | +title: Code scanning alert tracking using issues |
| 3 | +shortTitle: Alert tracking with issues |
| 4 | +intro: Connect security findings to your team's workflow by linking {% data variables.product.prodname_code_scanning %} alerts to issues for tracking and collaboration. |
| 5 | +permissions: People with write access for the repository can link {% data variables.product.prodname_code_scanning %} alerts to issues. |
| 6 | +versions: |
| 7 | + feature: code-scanning-link-alert-to-issue |
| 8 | +contentType: concepts |
| 9 | +category: |
| 10 | + - Find and fix code vulnerabilities |
| 11 | +--- |
| 12 | + |
| 13 | +{% data reusables.code-scanning.alert-tracking-with-issues-preview-note %} |
| 14 | + |
| 15 | +{% data reusables.code-scanning.enterprise-enable-code-scanning %} |
| 16 | + |
| 17 | +## How alert-to-issue linking works |
| 18 | + |
| 19 | +When {% data variables.product.prodname_code_scanning %} identifies a vulnerability in your code, you can link the alert to a {% data variables.product.prodname_dotcom %} **issue** to track remediation work. This brings security fixes into your existing planning and project management workflow, making vulnerabilities visible in sprint planning, project boards, and team backlogs. |
| 20 | + |
| 21 | +Each alert can link to a single issue, while each issue can track up to 50 different alerts. This flexibility lets you group related vulnerabilities or track them individually, depending on your team's workflow. |
| 22 | + |
| 23 | +You can link alerts to issues in any repository where you have access and {% data variables.product.prodname_github_issues %} is enabled, not just the repository where the alert was found. This is useful when you track work in a central repository or use a separate issue tracker for security fixes. |
| 24 | + |
| 25 | +## Understanding synchronization behavior |
| 26 | + |
| 27 | +**Alert and issue statuses are not automatically synchronized.** Changes you make to an alert do not update the linked issue, and vice versa. This means: |
| 28 | + |
| 29 | +* When you fix the vulnerability and the alert automatically closes, the linked issue remains open until you manually close it. |
| 30 | +* When you close or reopen an issue, the alert status stays unchanged. |
| 31 | +* When you delete an issue, the link is removed from the alert page and alert list, but the alert itself remains open. |
| 32 | + |
| 33 | +## Best practices for managing linked alerts and issues |
| 34 | + |
| 35 | +**Track remediation progress clearly.** When you commit a fix, add a comment to the linked issue noting that the code is updated. After the next {% data variables.product.prodname_code_scanning %} run confirms the alert is closed, manually close the issue. |
| 36 | + |
| 37 | +**Use labels to show status.** Create issue labels like "code-fixed-awaiting-scan" or use project fields to indicate when a vulnerability is fixed but the issue is waiting for final verification and closure. |
| 38 | + |
| 39 | +**Assign responsibility.** Use issue assignees to make it clear who owns the remediation work, especially when security and development teams need to coordinate. |
0 commit comments