Como procurar avisos de segurança no GitHub Advisory Database

Acessar uma consultoria no GitHub Advisory Database

Você pode acessar qualquer aviso no GitHub Advisory Database.

1. Navegue até https://github.com/advisories.

2. Opcionalmente, para filtrar a lista de avisos, use o campo de pesquisa ou os menus suspensos na parte superior da lista.

   Note

   Você pode usar a barra lateral à esquerda para explorar os avisos examinados e não examinados do GitHub separadamente ou para filtrar por ecossistema.

3. Clique em um aviso para examinar as informações. Por padrão, você verá os avisos examinados pelo GitHub sobre vulnerabilidades de segurança. Para mostrar o avisos de malware, use type:malware na barra de pesquisa.

O banco de dados também pode ser acessado usando a API do GraphQL. Por padrão, as consultas retornarão avisos examinados pelo GitHub sobre vulnerabilidades de segurança, a menos que você especifique type:malware. Para obter mais informações, confira Eventos e cargas de webhook.

Além disso, você pode acessar o GitHub Advisory Database usando a API REST. Para saber mais, confira Pontos de extremidade de API REST para avisos de segurança globais.

Editando uma consultoria em GitHub Advisory Database

Você pode sugerir melhorias para qualquer consultoria em GitHub Advisory Database. Para saber mais, confira Editando consultorias de segurança no banco de dados consultivo do GitHub.

Pesquisar em GitHub Advisory Database

Você pode procurar no banco de dados e usar qualificadores para limitar sua busca. Por exemplo, você pode procurar consultorias criadas em uma determinada data, em um ecossistema específico ou em uma biblioteca em particular.

A formatação de data precisa seguir o padrão ISO8601, que é YYYY-MM-DD (ano-mês-dia). Adicione também informações de hora THH:MM:SS+00:00 opcionais após a data, para fazer a pesquisa por hora, minuto e segundo. Isso é T, seguido de HH:MM:SS (hora-minutos-segundos) e uma diferença UTC (+00:00).

Ao pesquisar uma data, você pode usar qualificadores de maior que, menor que e intervalo para filtrar os resultados ainda mais. Para obter mais informações, confira "Noções básicas de sintaxe de pesquisa".

Qualificador	Exemplo
type:reviewed	type:reviewed mostrará os avisos examinados pelo GitHub sobre vulnerabilidades de segurança.
type:malware	type:malware mostrará avisos de malware.
type:unreviewed	type:unreviewed mostrará os avisos não verificados.
GHSA-ID	GHSA-49wp-qq6x-g2rf mostrará o aviso com esta ID do GitHub Advisory Database.
CVE-ID	CVE-2020-28482 mostrará o aviso com esse número de ID do CVE.
ecosystem:ECOSYSTEM	ecosystem:npm mostrará apenas os avisos que afetam os pacotes do npm.
severity:LEVEL	severity:high mostrará apenas os avisos com um nível de severidade alta.
affects:LIBRARY	affects:lodash mostrará apenas os avisos que afetam a biblioteca lodash.
cwe:ID	cwe:352 mostrará apenas os avisos com esse número de CWE.
credit:USERNAME	credit:octocat mostrará apenas os avisos creditados à conta de usuário "octocat".
sort:created-asc	sort:created-asc classificará os resultados pelos avisos mais antigos primeiro.
sort:created-desc	sort:created-desc classificará os resultados pelos avisos mais recentes primeiro.
sort:updated-asc	sort:updated-asc classificará os resultados pela atualização menos recente primeiro.
sort:updated-desc	sort:updated-desc classificará os resultados pela atualização mais recente primeiro.
is:withdrawn	is:withdrawn mostrará apenas os avisos que foram retirados.
created:YYYY-MM-DD	created:2021-01-13 mostrará apenas os avisos criados nessa data.
updated:YYYY-MM-DD	updated:2021-01-13 mostrará apenas os avisos atualizados nessa data.

Um qualificador GHSA-ID é um ID exclusivo que o GitHub atribui automaticamente a cada aviso no GitHub Advisory Database. Para saber mais sobre esses identificadores, confira Sobre o GitHub Advisory Database.

Visualizar seus repositórios vulneráveis

Para qualquer aviso examinado pelo GitHub no GitHub Advisory Database, você pode ver qual dos repositórios são afetados por essa vulnerabilidade de segurança ou esse malware. Para ver um repositório vulnerável, você deve ter acesso a Dependabot alerts para esse repositório. Para saber mais, confira Sobre alertas do Dependabot.

1. Navegue até https://github.com/advisories.
2. Clique em uma consultoria.
3. Na parte superior da página do aviso, clique em Alertas do Dependabot.
   
4. Opcionalmente, para filtrar a lista, use a barra de pesquisa ou os menus suspensos. O menu suspenso "Organização" permite filtrar Dependabot alerts por proprietário (organização ou usuário).
5. Para obter mais detalhes sobre o aviso e para recomendações de como corrigir o repositório vulnerável, clique no nome do repositório.