Skip to main content

Criando uma configuração de segurança personalizada

Crie um custom security configuration para atender às necessidades de segurança específicas dos repositórios em sua organização.

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

Sobre o custom security configurations

Com custom security configurations, você pode criar coleções de configurações de habilitação para produtos de segurança de GitHub que atendem às necessidades de segurança específicas da sua organização. Por exemplo, você pode criar uma diferente custom security configuration para cada organização ou grupo de organizações para refletir seus requisitos de segurança exclusivos e obrigações de conformidade.

Você também pode escolher se deseja ou não incluir os recursos GitHub Code Security ou GitHub Secret Protection em uma configuração.

Se você fizer isso, tenha em mente que esses recursos incorrem em custos de uso (ou exigem GitHub Advanced Security licenças) quando aplicados a repositórios privados e internos. Para saber mais, confira Sobre GitHub Segurança Avançada.

          >[!IMPORTANT]
          > A ordem e os nomes de algumas configurações serão diferentes dependendo de você estar usando licenças do produto GitHub Advanced Security original ou dos dois novos produtos: GitHub Code Security e GitHub Secret Protection. Consulte [Como criar uma GitHub Advanced Security configuração](#creating-a-github-advanced-security-configuration) ou [criar uma Secret Protection and Code Security configuração](#creating-a-secret-protection-and-code-security-configuration).

Criando uma Secret Protection and Code Security configuração

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

  2. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  3. Na seção "Segurança" da barra lateral, selecione o menu suspenso Advanced Security e, em seguida, clique em Repositórios.

  4. Na seção "Security configurations", clique em Nova configuração.

  5. Para configurar grupos de recursos de segurança para seus repositórios, clique em Configuração personalizada.

  6. Para ajudar a identificar seu custom security configuration e esclarecer seu propósito na página "Security configurations", nomeie sua configuração e crie uma descrição.

  7. Opcionalmente, habilite "Secret Protection", um recurso pago para repositórios privados . Habilitar Secret Protection habilita alertas para secret scanning. Além disso, você pode escolher se deseja habilitar, desabilitar ou manter as configurações existentes para os seguintes secret scanning recursos: * Verificações de validade. Para saber mais sobre verificações de validade de padrões de parceiro, consulte Avaliar alertas da verificação de segredo. * Metadados estendidos. Para saber mais sobre verificações de metadados estendidas, consulte Sobre verificações de metadados estendidas e Avaliar alertas da verificação de segredo.

    Observação

    Você só poderá habilitar verificações de metadados estendidas se as verificações de validade estiverem habilitadas.

    •     **Padrões de não provedores**. Para saber mais sobre a verificação de padrões que não são de provedor, consulte [AUTOTITLE](/code-security/secret-scanning/introduction/supported-secret-scanning-patterns#non-provider-patterns) e [AUTOTITLE](/code-security/secret-scanning/managing-alerts-from-secret-scanning/viewing-alerts).
      
    •     **Procurar senhas genéricas**. Para saber mais, consulte [AUTOTITLE](/code-security/secret-scanning/copilot-secret-scanning/responsible-ai-generic-secrets).
      
    •     **Proteção por push**. Para saber mais sobre a proteção por push, consulte [AUTOTITLE](/code-security/secret-scanning/introduction/about-push-protection).
      
    •     **Ignorar privilégios**. Ao atribuir privilégios de bypass ou isenções, os atores selecionados podem contornar ou pular a proteção de push. Há um processo de revisão e aprovação para todos os outros colaboradores. Consulte [AUTOTITLE](/code-security/secret-scanning/using-advanced-secret-scanning-and-push-protection-features/delegated-bypass-for-push-protection/about-delegated-bypass-for-push-protection).
      
    •     **Impedir o descarte direto de alertas**. Para saber mais, consulte [AUTOTITLE](/code-security/secret-scanning/using-advanced-secret-scanning-and-push-protection-features/enabling-delegated-alert-dismissal-for-secret-scanning).
      
  8. Opcionalmente, habilite "Code Security", um recurso pago para repositórios privados . Você pode escolher se deseja habilitar, desabilitar ou manter as configurações existentes para os seguintes code scanning recursos: * Configuração padrão. Para saber mais sobre a configuração padrão, confira Como definir a configuração padrão da verificação de código.

Observação

Para criar uma configuração que você pode aplicar a todos os repositórios, independentemente da configuração atual do code scanning, escolha "Enabled with advanced setup allowed". Isso habilita a configuração padrão apenas em repositórios em que a análise de CodeQL não é executada ativamente. Opção disponível em GitHub Enterprise Server 3.19.

  •      **Tipo de executor**. Se você quiser direcionar agentes específicos para code scanning, você pode optar por usar agentes personalizados nesta fase. Consulte [AUTOTITLE](/code-security/code-scanning/enabling-code-scanning/configuring-default-setup-for-code-scanning#assigning-labels-to-runners). 
    
* 
          **Impedir o descarte direto de alertas**. Para saber mais, consulte [AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/enabling-delegated-alert-dismissal-for-code-scanning).
  1. Ainda em "Code Security", na tabela "Verificação de dependência", escolha se deseja habilitar, desabilitar ou manter as configurações existentes para os seguintes recursos de verificação de dependência: * Gráfico de dependências. Para saber mais sobre o grafo de dependência, consulte Sobre o gráfico de dependências.

    Dica

    Quando "Code Security" e o grafo de dependência estiverem habilitados, isso habilita a revisão de dependência, consulte Sobre a análise de dependência.

    •      **Envio automático de dependência**. Para saber mais sobre o envio automático de dependência, consulte [AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-automatic-dependency-submission-for-your-repository).
      
    •      **
           Dependabot alertas** Para saber sobre Dependabot, consulte [AUTOTITLE](/code-security/dependabot/dependabot-alerts/about-dependabot-alerts).
      
    •      **Atualizações de segurança**. Para saber mais sobre atualizações de segurança, consulte [AUTOTITLE](/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates).
      
    •      **Impedir o descarte direto de alertas**. Para saber mais, consulte [AUTOTITLE](/code-security/dependabot/dependabot-alerts/enable-delegated-alert-dismissal).
      
    •      **
           Malware alerts
           **. Para saber mais, consulte [AUTOTITLE](/code-security/concepts/supply-chain-security/dependabot-malware-alerts).
      
  2. Para "Private vulnerability reporting", escolha se deseja habilitar, desabilitar ou manter as configurações existentes. Para saber mais sobre relatórios de vulnerabilidades privadas, consulte Como configurar relatórios privados de vulnerabilidades em um repositório.

  3. Opcionalmente, na seção "Policy", você pode usar opções adicionais para controlar como a configuração é aplicada: * Usar como padrão para repositórios recém-criados. Selecione o menu suspenso Nenhum e clique em Repositórios****Públicos, Privados e Internos ou Todos.

    Observação

    O security configuration padrão de uma organização é aplicado automaticamente apenas a novos repositórios criados dentro da organização. Se um repositório for transferido para sua organização, você ainda precisará aplicar um security configuration apropriado ao repositório manualmente.

    •      **Impor configuração**. Impeça que os proprietários do repositório alterem recursos habilitados ou desabilitados pela configuração (recursos que não estão definidos não são impostos). Selecione **Enforce** no menu suspenso.
      

    Observação

    Algumas situações podem interromper a aplicação de security configurations. Confira Imposição de configuração de segurança.

  4. Para concluir a criação do seu custom security configuration, clique em Salvar configuração.

Criando uma GitHub Advanced Security configuração

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

  2. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  3. Na seção "Segurança" da barra lateral, selecione o menu suspenso Advanced Security e, em seguida, clique em Repositórios.

  4. Na seção "Configurações de segurança", clique em Nova configuração.

  5. Para ajudar a identificar seu custom security configuration e esclarecer seu propósito na página "Nova configuração", nomeie a configuração e crie uma descrição.

  6. Na linha "GitHub Advanced Security recursos", escolha se deseja incluir ou excluir GitHub Advanced Security recursos (GHAS).

  7. Na tabela "Secret scanning", escolha se deseja habilitar, desabilitar ou manter as configurações existentes para os seguintes recursos de segurança: * Verificações de validade. Para saber mais sobre verificações de validação para padrões de parceiros, consulte Avaliar alertas da verificação de segredo. * Padrões de não provedores. Para saber mais sobre a verificação de padrões que não são de provedor, consulte Padrões de varredura de segredos com suporte e Exibindo e filtrando alertas do escaneamento de segredos. * Procurar senhas genéricas. Para saber mais, consulte Detecção responsável de segredos genéricos com a varredura de segredos do Copilot. * Proteção por push. Para saber mais sobre a proteção por push, consulte Sobre a proteção por push. * Ignorar privilégios. Ao atribuir privilégios de passagem ou isenções, os atores escolhidos podem contornar ou pular a proteção por push. Há um processo de revisão e aprovação para todos os outros colaboradores. Consulte Sobre o bypass delegado para proteção contra push. * Impedir o descarte direto de alertas. Para saber mais, consulte Habilitar a dispensa de alerta delegada para verificação de segredo.

  8. Na tabela "Code scanning", escolha se deseja habilitar, desabilitar ou manter a configuração padrão existente para code scanning. * Configuração padrão. Para saber mais sobre a configuração padrão, confira Como definir a configuração padrão da verificação de código.

Observação

Para criar uma configuração que você pode aplicar a todos os repositórios, independentemente da configuração atual do code scanning, escolha "Enabled with advanced setup allowed". Isso habilita a configuração padrão apenas em repositórios em que a análise de CodeQL não é executada ativamente. Opção disponível em GitHub Enterprise Server 3.19.

  •      **Tipo de executor**. Se você quiser direcionar agentes específicos para code scanning, você pode optar por usar agentes personalizados nesta fase. Consulte [AUTOTITLE](/code-security/code-scanning/enabling-code-scanning/configuring-default-setup-for-code-scanning#assigning-labels-to-runners). 
    
* 
          **Impedir o descarte direto de alertas**. Para saber mais, consulte [AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/enabling-delegated-alert-dismissal-for-code-scanning).
  1. Na tabela "Verificação de dependências", escolha se deseja ativar, desativar ou manter as configurações existentes para os seguintes recursos de verificação de dependências: * Gráfico de dependências. Para saber mais sobre o grafo de dependência, consulte Sobre o gráfico de dependências.

    Dica

    Quando "GitHub Advanced Security" e o grafo de dependência estiverem habilitados, isso habilita a revisão de dependência, consulte Sobre a análise de dependência.

    •      **Envio automático de dependência**. Para saber mais sobre o envio automático de dependência, consulte [AUTOTITLE](/code-security/supply-chain-security/understanding-your-software-supply-chain/configuring-automatic-dependency-submission-for-your-repository).
      
    •      **
           Dependabot alertas** Para saber sobre Dependabot, consulte [AUTOTITLE](/code-security/dependabot/dependabot-alerts/about-dependabot-alerts).
      
    •      **Atualizações de segurança**. Para saber mais sobre atualizações de segurança, consulte [AUTOTITLE](/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates).
      
    •      **Impedir o descarte direto de alertas**. Para saber mais, consulte [AUTOTITLE](/code-security/dependabot/dependabot-alerts/enable-delegated-alert-dismissal).
      
    •      **
           Malware alerts
           **. Para saber mais, consulte [AUTOTITLE](/code-security/concepts/supply-chain-security/dependabot-malware-alerts).
      
  2. Para "Private vulnerability reporting", escolha se deseja habilitar, desabilitar ou manter as configurações existentes. Para saber mais sobre relatórios de vulnerabilidades privadas, consulte Como configurar relatórios privados de vulnerabilidades em um repositório.

  3. Opcionalmente, na seção "Policy", você pode usar opções adicionais para controlar como a configuração é aplicada: * Usar como padrão para repositórios recém-criados. Selecione o menu suspenso Nenhum e clique em Repositórios****Públicos, Privados e Internos ou Todos.

    Observação

    O security configuration padrão de uma organização é aplicado automaticamente apenas a novos repositórios criados dentro da organização. Se um repositório for transferido para sua organização, você ainda precisará aplicar um security configuration apropriado ao repositório manualmente.

    •      **Impor configuração**. Impeça que os proprietários do repositório alterem recursos habilitados ou desabilitados pela configuração (recursos que não estão definidos não são impostos). Selecione **Enforce** no menu suspenso.
      
  4. Para concluir a criação do seu custom security configuration, clique em Salvar configuração.

Próximas etapas

Para aplicar seu custom security configuration a repositórios em sua organização, consulte Aplicando uma configuração de segurança personalizada.

Para saber como editar seu custom security configuration, consulte Edição de uma configuração de segurança personalizada.