Visitar URL original
Como relatar de modo privado uma vulnerabilidade de segurança - Documentos do GitHub
Skip to main content
Skip to content

Como relatar de modo privado uma vulnerabilidade de segurança

Alguns repositórios públicos configuram avisos de segurança para que qualquer pessoa possa relatar vulnerabilidades de segurança de modo direto e privado aos mantenedores.

Quem pode usar esse recurso?

Anyone can privately report a security vulnerability to repository maintainers.

Proprietários e administradores de repositórios públicos podem habilitar relatórios de vulnerabilidades privados nos respectivos repositórios. Confira Como configurar relatórios privados de vulnerabilidades em um repositório.

Observação

  • Se você tiver permissões de administração ou de segurança para um repositório público, não precisará enviar um relatório de vulnerabilidade. Em vez disso, crie um rascunho de aviso de segurança diretamente. Consulte Criando uma consultoria de segurança do repositório.
  • O relatório privado de vulnerabilidades é separado do arquivo SECURITY.md de um repositório. Você só pode relatar vulnerabilidades privadamente para repositórios em que esse recurso está habilitado. Se o repositório tiver uma política de segurança, a política será exibida acima do formulário de relatório para que você possa examinar as diretrizes do mantenedor antes de enviar.

Se um repositório público tiver relatórios de vulnerabilidades privados habilitados, qualquer pessoa poderá enviar um relatório de vulnerabilidade privada para os mantenedores do repositório.

Se o repositório não tiver relatórios de vulnerabilidades privados habilitados, você precisará iniciar o processo de relatório seguindo as instruções na política de segurança do repositório ou criando um problema solicitando aos mantenedores um contato de segurança preferencial. Consulte Divulgação coordenada de vulnerabilidades de segurança.

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique na Security and quality guia. Se você não conseguir ver a guia " Security and quality", selecione o menu suspenso e clique em Security and quality.

  3. Clique em Relatar uma vulnerabilidade para abrir o formulário de aviso.

  4. Se o repositório tiver uma política de segurança, examine a política exibida acima do formulário.

  5. Preencha o formulário de relatório de vulnerabilidades.

    Dica

    Por padrão, você deve fornecer um resumo, detalhes, prova de conceito e declaração de impacto. Os mantenedores podem personalizar o formulário e exigir outras informações. Forneça detalhes suficientes para os mantenedores reproduzirem e avaliarem a vulnerabilidade.

  6. Opcionalmente, selecione usei assistência de IA para encontrar ou redigir este relatório.

  7. Na parte inferior do formulário, clique em Enviar relatório. GitHub exibirá uma mensagem informando que os mantenedores foram notificados e que você tem um crédito pendente para este aviso de segurança.

    Dica

    Quando o relatório é enviado, GitHub adiciona automaticamente o repórter da vulnerabilidade como colaborador e como um usuário creditado na consultoria proposta.

  8. Opcionalmente, clique em Iniciar um fork privado temporário se quiser começar a corrigir o problema. Observe que somente o mantenedor do repositório pode mesclar as alterações do fork privado com o repositório pai.

    Captura de tela do final de um aviso de segurança. Um botão, com o texto "Start a temporary fork", está destacado com um contorno laranja-escuro.

As próximas etapas dependem da ação executada pelo mantenedor do repositório. Consulte Gerenciar vulnerabilidades de segurança relatadas privadamente.