About Varredura de código results on pull requests
In repositories where Varredura de código is configured as a pull request check, Varredura de código checks the code in the pull request. By default, this is limited to pull requests that target the default branch, but you can change this configuration within GitHub Actions or in a third-party CI/CD system. If merging the changes would introduce new Varredura de código alerts to the target branch, these are reported as check results in the pull request. The alerts are also shown as annotations in the Files changed tab of the pull request. If you have write permission for the repository, you can see any existing Varredura de código alerts on the Security tab. For information about repository alerts, see "Managing Varredura de código alerts for your repository."
In repositories where Varredura de código is configured to scan each time code is pushed, Varredura de código will also map the results to any open pull requests and add the alerts as annotations in the same places as other pull request checks. For more information, see "Scanning on push."
If your pull request targets a protected branch that uses Varredura de código, and the repository owner has configured required status checks, then the "Varredura de código results" check must pass before you can merge the pull request. For more information, see "About protected branches."
About Varredura de código as a pull request check
There are many options for configuring Varredura de código as a pull request check, so the exact setup of each repository will vary and some will have more than one check.
Varredura de código results check
For all configurations of Varredura de código, the check that contains the results of Varredura de código is: Varredura de código results. The results for each analysis tool used are shown separately. Any new alerts caused by changes in the pull request are shown as annotations.
To see the full set of alerts for the analyzed branch, click View all branch alerts. This opens the full alert view where you can filter all the alerts on the branch by type, severity, tag, etc. For more information, see "Managing code scanning alerts for your repository."
Varredura de código results check failures
If the Varredura de código results check finds any problems with a severity of error, critical, or high, the check fails and the error is reported in the check results. If all the results found by Varredura de código have lower severities, the alerts are treated as warnings or notes and the check succeeds.
You can override the default behavior in your repository settings, by specifying the level of severities and security severities that will cause a pull request check failure. For more information, see "Defining the severities causing pull request check failure".
Other Varredura de código checks
Depending on your configuration, you may see additional checks running on pull requests with Varredura de código configured. These are usually workflows that analyze the code or that upload Varredura de código results. These checks are useful for troubleshooting when there are problems with the analysis.
For example, if the repository uses the Fluxo de trabalho de análise do CodeQL a CodeQL / Analyze (LANGUAGE) check is run for each language before the results check runs. The analysis check may fail if there are configuration problems, or if the pull request breaks the build for a language that the analysis needs to compile (for example, C/C++, C#, or Java).
As with other pull request checks, you can see full details of the check failure on the Checks tab. For more information about configuring and troubleshooting, see "Configuring Varredura de código" or "Troubleshooting the CodeQL workflow."
Viewing an alert on your pull request
You can see any Varredura de código alerts introduced in a pull request by displaying the Files changed tab. Each alert is shown as an annotation on the lines of code that triggered the alert. The severity of the alert is displayed in the annotation.
If you have write permission for the repository, some annotations contain links with extra context for the alert. In the example above, from CodeQL analysis, you can click user-provided value to see where the untrusted data enters the data flow (this is referred to as the source). In this case you can also view the full path from the source to the code that uses the data (the sink) by clicking Show paths. This makes it easy to check whether the data is untrusted or if the analysis failed to recognize a data sanitization step between the source and the sink. For information about analyzing data flow using CodeQL, see "About data flow analysis."
To see more information about an alert, users with write permission can click the Show more details link shown in the annotation. This allows you to see all of the context and metadata provided by the tool in an alert view. In the example below, you can see tags showing the severity, type, and relevant common weakness enumerations (CWEs) for the problem. The view also shows which commit introduced the problem.
In the detailed view for an alert, some Varredura de código tools, like CodeQL analysis, also include a description of the problem and a Show more link for guidance on how to fix your code.
Fixing an alert on your pull request
Anyone with push access to a pull request can fix a Varredura de código alert that's identified on that pull request. If you commit changes to the pull request this triggers a new run of the pull request checks. If your changes fix the problem, the alert is closed and the annotation removed.
Dismissing an alert on your pull request
An alternative way of closing an alert is to dismiss it. You can dismiss an alert if you don't think it needs to be fixed. Por exemplo, um erro no código que é usado apenas para testes ou quando o esforço de corrigir o erro é maior do que o benefício potencial de melhorar o código. If you have write permission for the repository, the Dismiss button is available in code annotations and in the alerts summary. When you click Dismiss you will be prompted to choose a reason for closing the alert.
É importante escolher o motivo apropriado no menu suspenso, pois isso pode afetar se uma consulta continua sendo incluída em análise futura.
Se você ignorar um alerta de CodeQL como um falso resultado positivo, por exemplo, porque o código usa uma biblioteca de sanitização incompatível, considere contribuir para o repositório de CodeQL e melhorar a análise. Para obter mais informações sobre CodeQL, consulte "Contribuir para CodeQL".
For more information about dismissing alerts, see "Managing Varredura de código alerts for your repository."