Observação: o administrador do site precisa habilitar code scanning antes que você possa usar esse recurso. Se você desejar usar o GitHub Actions para fazer a varredura do seu código, o administrador do site também deverá habilitar o GitHub Actions e configurar a infraestrutura necessária. Para obter mais informações, confira "Como configurar a verificação de código do seu dispositivo".
Sobre a sua configuração do code scanning
Você pode usar uma série de ferramentas para configurar code scanning no seu repositório. Para obter mais informações, confira "Como definir a configuração padrão da verificação de código" e "Como definir a configuração avançada para verificação de código."
A informação de registro e diagnóstico disponível para você depende do método que você usa para code scanning no repositório. Você pode verificar o tipo da code scanning que você está usando na guia Segurança do repositório usando o menu suspenso Ferramenta na lista de alertas. Para obter mais informações, confira "Gerenciamento de alertas de varredura de código para seu repositório".
Sobre análise e informações de diagnóstico
Você pode visualizar as análises e informações de diagnóstico para code scanning executar usando as análises de CodeQL em GitHub.
As informações de análise são mostradas para a análise mais recente em um cabeçalho na parte superior da lista de alertas. Para obter mais informações, confira "Gerenciamento de alertas de varredura de código para seu repositório".
As informações de diagnóstico são exibidas nos logs de fluxo de trabalho da Ação e consistem em métricas de resumo e diagnóstico do extrator. Para obter informações sobre como acessar os logs da code scanning no GitHub, confira "Como ver a saída de log da code scanning" abaixo.
Se você estiver utilizando o CodeQL CLI fora de GitHub, você verá informações de diagnóstico na saída gerada durante a análise do banco de dados. Estas informações também estão incluídas nos resultados do SARIF que você enviou para GitHub com os resultados de code scanning.
Para obter mais informações sobre a CodeQL CLI, confira "Como analisar o código com as consultas CodeQL".
Sobre métricas resumidas
As métricas resumidas incluem:
- Linhas de código na base de dados (usadas como linha de base), antes da criação e extração do banco de dados de CodeQL
- Linhas de código no banco de dados CodeQL extraído do código, incluindo bibliotecas externas e arquivos gerados automaticamente
- Linhas de código no banco de dados de CodeQL excluindo arquivos gerados automaticamente e bibliotecas externas
Sobre diagnósticos de extração de código-fonte de CodeQL
Os diagnósticos do extrator só cobrem os arquivos vistos durante a análise. As métricas incluem:
- Número de arquivos analisados com sucesso
- Número de arquivos que geraram erros do extrator durante a criação do banco de dados
- Número de arquivos que geraram avisos do extrator durante a criação do banco de dados
Você pode ver informações detalhadas sobre os erros e avisos do extrator do CodeQL que ocorreram durante a criação do banco de dados habilitando o registro em log de depuração. Para obter mais informações, confira "Os logs não são detalhados o suficiente".
Visualizar a saída do registro de code scanning
Esta seção aplica-se à execução de code scanning usando GitHub Actions (CodeQL ou terceiros).
Depois de configurar code scanning para o seu repositório, você poderá inspecionar a saída das ações conforme forem executadas.
-
No nome do repositório, clique em Ações.
Você verá uma lista que inclui uma entrada para executar o fluxo de trabalho de code scanning. O texto da entrada é o título que você deu à sua mensagem de commit.
-
Clique na entrada para o fluxo de trabalho de code scanning.
Nota: Se você estiver procurando a execução do fluxo de trabalho do CodeQL disparada habilitando a configuração padrão, o texto da entrada será "CodeQL".
-
Clique no nome do trabalho à esquerda. Por exemplo, Analisar (LANGUAGE) .
-
Revise a saída de log das ações deste fluxo de trabalho enquanto elas são executadas.
-
Opcionalmente, para saber mais sobre o commit que acionou a execução de fluxo de trabalho, clique no hash de commit curto. Esse hash de commit curto tem sete caracteres minúsculos logo após o nome de usuário do autor do commit.
-
Depois que todos os trabalhos forem concluídos, você poderá visualizar os as informações dos alertas de code scanning que foram identificados. Para obter mais informações, confira "Gerenciamento de alertas de varredura de código para seu repositório".