☰ Menu

03.10.2026 · Signal Titans Editorial

GitHub expande API GraphQL de avisos de segurança com filtragem no servidor e novos campos de metadados

GitHub atualizou sua API GraphQL para avisos de segurança, adicionando novos campos e filtragem no servidor para otimizar a triagem de vulnerabilidades.

Ilustração conceitual de uma lupa digital brilhante examinando um ícone de escudo elegante sobre um fundo escuro.

O GitHub expandiu sua API GraphQL para SecurityAdvisory para fornecer metadados adicionais de avisos diretamente em consultas únicas, reduzindo a dependência da API REST em fluxos de trabalho de integração de segurança.

Novos campos de metadados para avisos de segurança

A atualização da API GraphQL introduz cinco novos campos ao objeto SecurityAdvisory. As integrações agora podem recuperar o identificador CVE oficial de um aviso por meio do campo cveId, acessar referências diretas ao código afetado através do sourceCodeLocation e visualizar o aviso de segurança do repositório vinculado com o repositoryAdvisoryUrl.

Além disso, o GitHub adicionou rastreamento preciso de registro de data e hora ao objeto. As consultas podem solicitar o githubReviewedAt para verificar quando o GitHub concluiu sua revisão, bem como o nvdPublishedAt para inspecionar quando o National Vulnerability Database publicou seu registro.

Filtragem de consultas no lado do servidor

Para otimizar a extração de dados, a consulta securityAdvisories recebeu dois filtros dedicados no lado do servidor: severities e isWithdrawn. Essas adições permitem que as aplicações filtrem os resultados nos servidores do GitHub, em vez de baixar grandes volumes de dados para processamento no cliente.

Os novos argumentos complementam os filtros de consulta existentes, incluindo classificação, identificador, pontuação EPSS e registros de data e hora de atualização. Ao permitir consultas direcionadas, desenvolvedores podem construir fluxos focados, como feeds de triagem baseados em severidade e auditorias para avisos retirados.

Eficiência de fluxo de trabalho e mecânica da API

Ao consolidar os atributos dos avisos na interface GraphQL, as integrações passam a operar sob um modelo de autenticação unificado e um único limite de taxa de requisições (rate-limit). A inclusão de campos diretos reduz as viagens de ida e volta na rede (round trips) entre os endpoints do GitHub e plataformas externas de segurança.

Todas as atualizações do esquema são cumulativas e somente de leitura, garantindo compatibilidade com versões anteriores para consultas GraphQL existentes sem interromper as implementações ativas de desenvolvedores.

Ilustração editorial gerada por IA; não é uma fotografia documental.

Fonte: New fields for SecurityAdvisory GraphQL API