Esta versão do GitHub Enterprise Server foi descontinuada em 2026-03-17. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Definir proteção contra mesclagem de verificação de código

Proteja sua base de código bloqueando solicitações de pull que falham verificações de code scanning.

Quem pode usar esse recurso?

Proprietários da organização, gerentes de segurança e membros da organização com a função de administrador

O Code scanning está disponível para os seguintes tipos de repositório:

  • Repositórios públicos no GitHub.com
  • Repositórios de propriedade da organização em GitHub Team, GitHub Enterprise Cloudou GitHub Enterprise Server, com GitHub Advanced Security habilitados.

Neste artigo

Criar um conjunto de regras de proteção contra mesclagem para um repositório

Navegue até o repositório Configurações da barra lateral Configurações de conjuntos de regras do repositório

  1. Clique em Novo conjunto de regras.

  2. Para criar um conjunto de regras direcionado a branches, clique em Novo conjunto de regras de branch.

  3. Em "Nome do conjunto de regras", digite um nome para o conjunto de regras.

  4. Opcionalmente, para alterar o status de imposição padrão, clique em Disabled e selecione um status de imposição.

  5. Em "Proteções de ramificação", selecione Exigir resultados do code scanning.

  6. Em "Required tools and alert thresholds", clique em Add tool e selecione uma ferramenta de code scanning com o menu suspenso. Por exemplo, "CodeQL".

  7. Ao lado do nome de uma ferramenta do code scanning:

    • Clique em Alertas e selecione um dos seguintes: Nenhum, Erros, Erros e Avisos ou Todos.
    • Clique em Alertas de segurança e selecione um dos seguintes: Nenhum, Crítico, Alto ou superior, Médio ou superior ou Todos.

    Captura de tela da seção "Ferramentas necessárias e limites de alerta" das configurações de "Conjuntos de regras".

Para obter mais informações sobre a gravidade do alerta e os níveis de severidade de segurança, consulte Sobre alertas de digitalização de códigos.

Para obter mais informações sobre como gerenciar conjuntos de regras em um repositório, confira Como gerenciar conjuntos de regras de um repositório.

Criar um conjunto de regras de proteção contra mesclagem para todos os repositórios de uma organização

  1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

  2. Ao lado da organização, clique em Configurações.

  3. Na barra lateral esquerda, na seção "Code, planning, and automation", clique em Repository e, em seguida, em Rulesets.

    Captura de tela da página de configurações de uma organização. Na barra lateral, um link rotulado "Conjuntos de regras" está realçado em laranja.

  4. Clique em Novo conjunto de regras.

  5. Para criar um conjunto de regras direcionado a branches, clique em Novo conjunto de regras de branch.

  6. Em "Nome do conjunto de regras", digite um nome para o conjunto de regras.

  7. Opcionalmente, para alterar o status de imposição padrão, clique em Disabled e selecione um status de imposição.

  8. Em "Proteções de ramificação", selecione Exigir resultados do code scanning.

  9. Em "Required tools and alert thresholds", clique em Add tool e selecione uma ferramenta de code scanning com o menu suspenso. Por exemplo, "CodeQL".

  10. Ao lado do nome de uma ferramenta do code scanning:

    • Clique em Alertas e selecione um dos seguintes: Nenhum, Erros, Erros e Avisos ou Todos.
    • Clique em Alertas de segurança e selecione um dos seguintes: Nenhum, Crítico, Alto ou superior, Médio ou superior ou Todos.

    Captura de tela da seção "Ferramentas necessárias e limites de alerta" das configurações de "Conjuntos de regras".

Para obter mais informações sobre a gravidade do alerta e os níveis de severidade de segurança, consulte Sobre alertas de digitalização de códigos.

Para obter mais informações sobre como gerenciar conjuntos de regras para repositórios em uma organização, confira Como gerenciar conjuntos de regras para repositórios na sua organização.

Criar um conjunto de regras de proteção contra mesclagem com a API REST

Você pode usar a API REST para criar um conjunto de regras com a regra code_scanning, que permite definir ferramentas específicas e definir limites de alerta. Para saber mais, confira Pontos de extremidade da API REST para regras.