O que muda com a atualização de 13 de novembro
O GitHub adicionou repository_scan aos endpoints existentes de configuração do AI Scan para organizações e repositórios, em prévia pública. GET e PATCH usam /orgs/{org}/code-scanning/ai-scan ou /repos/{owner}/{repo}/code-scanning/ai-scan. A nova propriedade aceita enabled ou disabled, junto do controle pr_scan já existente para pull requests.
Isso permite incorporar uma mudança de configuração a scripts de implantação e definições de infraestrutura. Não transforma esses scripts em um agendador de análises. Para repositórios pertencentes a organizações, o anúncio abrange os públicos e os privados ou internos que contam com GitHub Code Security ou GitHub Advanced Security. O GitHub Enterprise Server não é compatível com esta atualização. Consulte a documentação atual de elegibilidade para o tipo de proprietário e a visibilidade dos repositórios que você usa.
Consulte a hierarquia de políticas antes de alterar uma configuração
Quando uma organização desabilita a análise de repositórios, seus repositórios não podem habilitá-la por conta própria. Quando a organização habilita o recurso, os repositórios elegíveis herdam a configuração e seus administradores podem desabilitá-la individualmente. Uma restrição da empresa continua tendo precedência: uma tentativa de habilitar o AI Scan que contrarie essa restrição retorna 422. O valor desejado para um repositório não pode se sobrepor a uma política de nível superior.
A API também diferencia consulta de administração. Os requisitos dos tokens com permissões granulares variam conforme o endpoint: consultas de organizações exigem permissão de leitura de Administration, enquanto consultas de repositórios exigem permissão de leitura de Code scanning alerts; atualizações exigem permissão de escrita de Administration no nível correspondente. Verifique tanto o papel de quem faz a solicitação quanto as permissões do endpoint específico. Um processo de inventário somente leitura não deve receber acesso de escrita só porque uma etapa posterior da implantação precisa dele.
Uma atualização conjunta bloqueada não altera nenhum dos campos
O GitHub permite incluir pr_scan e repository_scan na mesma solicitação. Se alguma das mudanças solicitadas não puder ser aplicada, a solicitação falha e nenhuma das duas configurações muda. Por exemplo, uma solicitação que altera a análise de pull requests e habilita a análise do repositório não deve ser registrada como uma implantação parcialmente bem-sucedida quando um dos campos estiver bloqueado.
Trate esse processo como uma verificação de que o estado real corresponde ao desejado. Salve os valores iniciais, envie apenas a mudança pretendida e autorizada e depois compare a resposta e uma nova consulta com os valores desejados. Um 422 não comprova que um dos campos foi atualizado, nem identifica sempre a mesma causa: a referência REST também lista falhas de validação. Mantenha o erro retornado no registro da implantação e resolva sua causa real antes de tentar novamente.
Habilitado, analisado e revisado são estados diferentes
Habilitar repository_scan não inicia uma análise. Usuários com acesso de escrita disparam as análises sob demanda; cada execução consome créditos do Code Security AI. A documentação atual limita as análises de repositórios à branch padrão e informa que análises agendadas e automáticas a cada push não são compatíveis. Por isso, o orçamento e a execução da análise precisam de responsáveis e evidências próprios.
Uma análise concluída também é uma busca limitada, não uma prova de que todo o repositório está livre de vulnerabilidades. O GitHub descreve um agente que seleciona o código a examinar dentro de um limite de tempo. A documentação alerta para vulnerabilidades que podem passar despercebidas, alertas duplicados com o CodeQL e resultados imprecisos gerados por IA. Revise cada alerta e suas evidências; não transforme uma configuração habilitada nem um resultado vazio em um certificado de ausência de vulnerabilidades.
Um registro da implantação que outro desenvolvedor possa revisar
Para um piloto pequeno, o Codorc sugere registrar separadamente os pontos de verificação a seguir. São verificações operacionais propostas, não resultados de um teste da API real nem uma avaliação da qualidade de detecção do GitHub.
- Identifique a organização, a visibilidade do repositório e a política da empresa aplicável. Confirme a elegibilidade, quem é o administrador responsável e qual é o orçamento de créditos aprovado antes de alterar qualquer coisa.
- Salve as configurações atuais da organização e do repositório com data e hora. Mantenha credenciais fora dos logs e use apenas as permissões necessárias em cada etapa.
- Registre as mudanças pretendidas nos campos e o status retornado. Em uma atualização conjunta, verifique os dois campos juntos; após uma resposta incerta, consulte o estado antes de enviar outra solicitação de escrita.
- Registre uma análise disparada deliberadamente separada da habilitação: qual revisão da branch padrão foi examinada, quando a execução terminou e qual consumo foi informado.
- Designe uma pessoa para revisar os resultados e verificar as correções. Registre por que um alerta foi aceito, descartado ou considerado duplicado e leve em conta as limitações documentadas das novas análises ao conferir uma correção.
A data do evento corresponde ao anúncio original. A data de publicação indica quando o artigo apareceu na Codorc.



