AI Scan é um conjunto de recursos de verificação alimentados por IA que complementam CodeQL. Os recursos diferem em seu escopo:
- AI Scan for repositories verifica o branch padrão de um repositório sob demanda em todos os idiomas, incluindo idiomas já compatíveis com CodeQL.
- A Verificação de IA para solicitações de pull atualmente encontra vulnerabilidades gerais de segurança em idiomas selecionados e estruturas não cobertas por CodeQL.
- A verificação de aplicativos de IA encontra riscos específicos para aplicativos e agentes de IA, como injeção de prompt indireto, independentemente da cobertura de CodeQL idioma.
Cada recurso tem seus próprios requisitos de cobertura, disponibilidade e cobrança.
Verificação com IA para repositórios
A Verificação de IA para repositórios está em prévia pública e está sujeita a alterações.
A Verificação de IA para repositórios localiza vulnerabilidades de segurança em toda a branch padrão do seu repositório, em qualquer idioma. Ele estende a cobertura para além dos idiomas com suporte CodeQL e pode encontrar vulnerabilidades adicionais em idiomas que CodeQL já analisa.
Os usuários com acesso de gravação executam verificações sob demanda. As descobertas são adicionadas à sua code scanning lista de pendências junto com CodeQL alertas, em que você pode atribuí-las, vinculá-las a problemas, incluí-las em campanhas de segurança ou usar agentic autofix para ajudar a corrigi-las.
Para obter mais informações, incluindo disponibilidade, cobrança, limitações e diretrizes de habilitação, consulte Verificação de IA para o backlog de um repositório.
Verificação por IA em pull requests
Vulnerabilidades gerais de segurança de código
AI Scan for pull requests encontra vulnerabilidades de segurança em alterações de pull requests para idiomas selecionados e estruturas não cobertas por CodeQL. Os exemplos incluem PHP e HCL (configuração do Terraform).
Quando habilitado, ele verifica as solicitações de pull qualificadas quando elas são criadas e após cada novo commit. As descobertas aparecem ao lado de CodeQL alertas com um rótulo de "IA".
Para obter mais informações, incluindo cobertura, disponibilidade, cobrança e diretrizes de habilitação, consulte Verificação de IA para solicitações de pull.
Riscos de aplicativos e agentes de IA
A verificação de aplicativos de IA encontra riscos de segurança em aplicativos de IA e agentes em pull requests, inicialmente focando na injeção indireta de prompts.
Quando habilitado, o detector verifica os pull requests elegíveis quando eles são criados e após cada novo commit. As descobertas aparecem como comentários no pull request.
Para obter mais informações, incluindo cobertura, disponibilidade, cobrança e diretrizes de habilitação, consulte Verificação de aplicativos de IA para pull requests.
Gerenciar o AI Scan
Para empresas, uma política compartilhada de AI Scan controla se as organizações podem habilitar esses recursos. Permitir a Verificação de IA não habilita automaticamente nenhum recurso. Consulte Como impor políticas para segurança e análise de código na empresa.
As organizações habilitam cada recurso separadamente, e os administradores de repositório podem desativar cada recurso de forma independente. Para obter permissões e instruções de configuração, consulte o artigo dedicado para cada recurso.
Você também pode usar a API REST para gerenciar a Verificação de IA para solicitações de pull e verificação de IA para repositórios nos níveis da organização e do repositório, usando as propriedades e repository_scan as pr_scan propriedades. Consulte Pontos de extremidade da API REST para varredura de código.