Ir para o conteúdo
Promovaweb

Segurança do repositório no GitHub

A segurança do repositório no GitHub é o conjunto de recursos que examina o código e as dependências do projeto em busca de vulnerabilidades conhecidas e de credenciais expostas. O Dependabot compara as dependências com o GitHub Advisory Database e o secret scanning procura tokens no histórico inteiro, por isso uma biblioteca vulnerável ou uma chave enviada por engano gera um alerta no próprio repositório.

Ficha e sumário da página

Referência técnica
GitHub CLI v2.104.0
Revisão
13 de novembro de 2026
Conteúdo
Documentação oficial consultada
  1. Dependência, credencial e código próprio
  2. Dependências com aviso publicado
  3. Segredos no histórico
  4. Vulnerabilidade no seu próprio código

Dependência, credencial e código próprio

Três tipos de falha chegam ao repositório sem que o teste comum perceba. A primeira está na dependência: uma biblioteca que estava correta na instalação e recebeu, meses depois, um aviso de vulnerabilidade. A segunda está na credencial: um token de API ou uma senha que entrou num commit por engano e ficou no histórico. A terceira é a vulnerabilidade no seu próprio código, relatada em privado por um pesquisador de segurança ou por outro desenvolvedor que usa o projeto.

O GitHub responde a cada caso com um recurso diferente. O Dependabot cuida das dependências, o secret scanning cuida das credenciais e os security advisories organizam a correção de uma vulnerabilidade do próprio projeto. Os três aparecem na aba Security and quality do repositório e trabalham sobre o mesmo histórico que o resto da plataforma usa.

Dependências com aviso publicado

O Dependabot lê o grafo de dependências do repositório, montado a partir dos arquivos de manifesto do projeto, como o package.json. O grafo muda quando um push altera as bibliotecas ou as versões delas. Os alertas comparam esse grafo com o GitHub Advisory Database, mas só os avisos que o GitHub revisou geram alerta. A própria documentação avisa que os alertas não pegam toda falha de segurança.

O alerta aparece em dois momentos: quando um aviso novo entra na base e atinge uma dependência da branch padrão ou quando o seu push muda o grafo para uma versão já marcada como vulnerável. Com as atualizações de segurança ligadas, o Dependabot tenta corrigir cada alerta aberto que tenha correção disponível, num pull request que sobe a dependência para a menor versão que contém a correção. Esse pull request passa pelos mesmos workflows e pela mesma revisão de qualquer outro.

Dependabot alerts

  • Avisam que uma dependência da branch padrão tem vulnerabilidade conhecida.
  • Usam os avisos revisados do GitHub Advisory Database.
  • Aparecem na aba Security and quality e no grafo de dependências.
  • Não alteram o código do repositório.

Dependabot security updates

  • Partem de um alerta já aberto para a dependência.
  • Abrem um pull request com a menor versão que contém a correção.
  • Rodam os workflows do Actions como qualquer pull request.
  • Esperam a revisão e o merge para a correção entrar na main.

Segredos no histórico

O secret scanning procura credenciais escritas no código, como chaves de API, senhas e tokens de serviços conhecidos. A varredura cobre o histórico Git inteiro, em todas as branches. Ela também lê os títulos, as descrições e os comentários das issues, dos pull requests e das discussões, além das wikis e dos gists secretos. Nos repositórios públicos, a varredura roda de graça. Nos privados de organizações, ela depende do GitHub Secret Protection.

Quando o segredo encontrado é de um parceiro do programa, o GitHub avisa o provedor da credencial, que pode revogá-la. Esses segredos de parceiros não aparecem nos alertas do repositório. O resultado prático é que um token de um serviço parceiro publicado por engano num repositório público pode ser revogado pelo próprio provedor, mesmo que ninguém do projeto tenha visto o alerta.

A proteção de push vem ligada por padrão para o seu perfil pessoal no GitHub.com e recusa o envio de segredos para repositórios públicos. Na versão por repositório, ela depende do GitHub Secret Protection e fica desligada até um administrador ligar. Nessa versão, um colaborador com escrita pode contornar a recusa informando o motivo: uso em testes, falso positivo ou correção posterior. As duas primeiras opções criam um alerta já fechado, enquanto a correção posterior deixa um alerta aberto no repositório.

Vulnerabilidade no seu próprio código

Os security advisories servem para a vulnerabilidade que está no código do projeto, fora das dependências. Num repositório público, os mantenedores abrem um rascunho de advisory para discutir a falha em privado e corrigem o código num fork privado temporário. O aviso só se torna público depois que a versão corrigida sai:

  1. Rascunho

    Os mantenedores avaliam em privado como a falha afeta o projeto.

  2. Fork privado

    A correção é feita num fork temporário, fora da vista pública.

  3. CVE

    O GitHub, autoridade de numeração de CVE, costuma revisar a solicitação em até 72 horas.

  4. Release

    gh release create

    A versão corrigida sai com tag e notas, como qualquer release.

  5. Publicação

    O GitHub revisa o advisory publicado e pode usá-lo nos alertas do Dependabot.

O caminho de um security advisory no GitHub, da discussão privada da falha até o alerta que chega aos projetos que usam a versão afetada.

O GitHub é uma autoridade de numeração de CVE, o identificador público de vulnerabilidades. Ele atribui o número a partir do próprio advisory sem tornar o aviso público. A documentação de releases orienta publicar um advisory para toda release que corrige uma vulnerabilidade. Um advisory publicado sem a versão corrigida faz o Dependabot avisar os projetos afetados sem indicar uma versão segura, por isso o formulário do advisory recebe essa versão ainda no rascunho. Depois da publicação, a revisão do GitHub e o envio dos alertas podem levar até 72 horas.

As releases do GitHub CLI, inclusive as que trazem correções de segurança, aparecem no changelog do GitHub CLI. Este é o último assunto do portal. O caminho completo, do commit à release, começa na página O que é o GitHub.

Continue na comunidade

Leve ao Discord da Promovaweb o workflow que falha só no Actions ou a release que saiu sem os arquivos. Com o log da execução na conversa, a comunidade compara o seu caso com projetos parecidos.

Uma VPS para o que sai da sua release

O Actions roda os testes e o build em máquinas que existem só durante a execução. O app que sai da release precisa de um servidor: a VPS da StayCloud em São Paulo vem com acesso root e disco NVMe.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.