Criando uma configuração de segurança personalizada para sua empresa

Crie uma custom security configuration para atender às necessidades específicas de segurança da sua empresa.

Quem pode usar esse recurso?

Proprietários e membros da empresa com a função administrador

Neste artigo

Sobre custom security configurations

Recomendamos que você proteja sua empresa com o GitHub-recommended security configuration e, em seguida, avalie as descobertas de segurança em seus repositórios antes de configurar o custom security configurations. Para saber mais, confira Aplicando a configuração de segurança recomendada GitHub à sua empresa.

Com custom security configurations, você pode criar conjuntos de configurações de ativação para os produtos de segurança da GitHub para atender às necessidades específicas de segurança da sua empresa. Por exemplo, você pode criar um custom security configuration para cada organização ou grupo de organizações para refletir seus requisitos de segurança e obrigações de conformidade exclusivos.

Você também pode escolher de deseja ou não incluir recursos do GitHub Code Security ou do GitHub Secret Protection em sua configuração.

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

Importante

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 Criando uma configuração GitHub Advanced Security ou Criando uma configuração Secret Protection and Code Security.

Criando uma configuração Secret Protection and Code Security

  1. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
  2. Na parte superior da página, clique em Settings.
  3. Na barra lateral esquerda, clique em Advanced Security.
  4. Na seção "Security configurations", clique em New configuration.
  5. Para ajudar a identificar seus custom security configuration e esclarecer sua finalidade na página "Security configurations", nomeie sua configuração e crie uma descrição.
  6. Opcionalmente, habilite a "Secret Protection", um recurso pago para repositórios privados e internos. Habilitar a Secret Protection habilita alertas para a secret scanning. Além disso, você pode escolher se deseja habilitar, desabilitar ou manter as configurações existentes para os seguintes recursos do secret scanning: * Verificações de validade. Para saber mais sobre verificações de validade para modelos de parceiros, consulte Sobre verificações de validade e 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, confira [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, confira [AUTOTITLE](/code-security/secret-scanning/copilot-secret-scanning/responsible-ai-generic-secrets).

    •     **Proteção por push**. Para saber mais sobre a proteção de push, consulte [AUTOTITLE](/code-security/secret-scanning/introduction/about-push-protection). 

    •     **Ignorar privilégios**. Ao atribuir privilégios de bypass, o repositório, a organização e os membros empresariais selecionados podem ignorar a proteção por push. Há um processo de revisão e aprovação para todos os outros colaboradores. Confira [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, confira [AUTOTITLE](/code-security/secret-scanning/using-advanced-secret-scanning-and-push-protection-features/enabling-delegated-alert-dismissal-for-secret-scanning).
  7. Opcionalmente, habilite a "Code Security", um recurso pago para repositórios privados e internos. Você pode escolher se deseja habilitar, desabilitar ou manter as configurações existentes para os seguintes recursos do 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ê ter como alvo executores específicos para a code scanning, você poderá optar por usar executores personalizados nesta etapa. Confira [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, confira [AUTOTITLE](/code-security/code-scanning/managing-your-code-scanning-configuration/enabling-delegated-alert-dismissal-for-code-scanning).

  1. Ainda em "Code Security", na tabela "Dependency scanning", 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 a "Code Security" e o grafo de dependência estão habilitados, isso habilita a revisão de dependência; confira Sobre a análise de dependência.

    •      **Envio automático de dependência**. Para saber mais sobre o envio automático de dependência, confira [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).

  2. Para "Private vulnerability reporting", escolha se deseja habilitar, desabilitar ou manter as configurações existentes. Para saber mais sobre como elaborar 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 None e clique em Public, Private and internal ou All repositories.

    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 de seu custom security configuration, clique em Salvar configuração.

Criando uma configuração GitHub Advanced Security

  1. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
  2. Na parte superior da página, clique em Settings.
  3. Na barra lateral esquerda, clique em Advanced Security.
  4. Na seção superior, clique em Nova configuração.
  5. Para ajudar a identificar sua configuração custom security configuration e esclarecer sua finalidade na página "Nova configuração", dê um nome à sua configuração e crie uma descrição.
  6. Na linha "recursos GitHub Advanced Security", escolha se deseja incluir ou excluir recursos GitHub Advanced Security (GHAS).
  7. Na tabela "Secret scanning", escolha se deseja ativar, desativar ou manter as configurações existentes para os seguintes recursos de segurança:
    * Verificações de validade. Para saber mais sobre as verificações de validade 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, confira Padrões de varredura de segredos com suporte e Exibindo e filtrando alertas do escaneamento de segredos. * Procurar senhas genéricas. Para saber mais, confira 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 de push, confira Sobre a proteção por push. * Impedir o descarte direto de alertas. Para saber mais, confira Habilitar a dispensa de alerta delegada para verificação de segredo.
  8. Na tabela "Code scanning", escolha se deseja ativar, desativar ou manter as configurações existentes para a configuração padrão de code scanning. * Configuração padrão. Para saber mais, 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ê ter como alvo executores específicos para a code scanning, você poderá optar por usar executores personalizados nesta etapa. Confira [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, confira [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 gráfico de dependências estão ativados, isso habilita a revisão de dependências, 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, confira [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).

  2. Para "Private vulnerability reporting", escolha se deseja habilitar, desabilitar ou manter as configurações existentes. Para saber mais sobre como elaborar 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 None e clique em Public, Private and internal ou All repositories.

    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 de seu custom security configuration, clique em Salvar configuração.

Próximas etapas

Para configurar opcionalmente configurações adicionais de secret scanning para a empresa, consulte Configurando definições adicionais de verificação de segredos para sua empresa.

Para aplicar suas custom security configuration aos repositórios da 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.