Configurando as atualizações de segurança do Dependabot

Sobre a configuração de Dependabot security updates

É possível habilitar o Dependabot security updates para qualquer repositório que use Dependabot alerts e o gráfico de dependências. Para obter mais informações, confira "Sobre as atualizações de segurança do Dependabot".

Você pode habilitar ou desabilitar Dependabot security updates para um repositório individual, para uma seleção de repositórios em uma organização, ou para todos os repositórios pertencentes à sua conta pessoal ou organização. Para obter mais informações sobre como habilitar recursos de segurança em uma organização, confira "Habilitar recursos de segurança em sua organização."

Repositórios com suporte

O GitHub habilita automaticamente as Dependabot security updates para repositórios recém-criados quando na conta pessoal na ou organização estiver habilitada a opção Habilitar automaticamente para novos repositórios de Dependabot security updates. Para obter mais informações, confira "Como gerenciar as Dependabot security updates dos repositórios" abaixo.

Se você criar um fork de um repositório com atualizações de segurança habilitadas, o GitHub desabilitará automaticamente as Dependabot security updates do fork. Depois, você poderá decidir se deseja habilitar as Dependabot security updates no fork específico.

Se as atualizações de segurança não estiverem habilitadas para o seu repositório e você não souber o motivo, primeiro tente habilitá-las utilizando as instruções fornecidas nas seções de procedimento abaixo. Se atualizações de segurança ainda não funcionarem, você pode entrar em contato com seu administrador do site.

Gerenciar Dependabot security updates para seus repositórios

Você pode habilitar ou desabilitar as Dependabot security updates para todos os repositórios qualificados pertencentes à sua conta pessoal ou à organização. Para obter mais informações, confira "Gerenciar as configurações de segurança e análise para a sua conta pessoal" ou "Gerenciando as configurações de segurança e de análise da sua organização".

Você pode habilitar ou desabilitar as Dependabot security updates em um repositório individual.

Habilitar ou desabilitar Dependabot security updates para um repositório individual

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

2. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

3. Na seção "Segurança" da barra lateral, clique em Segurança de código e análise.

4. Em "Segurança e análise de código", à direita de "Atualizações de segurança do Dependabot", clique em Habilitar para habilitar o recurso ou Desabilitar para desabilitá-lo.

Agrupamento de Dependabot security updates em uma única pull request

Para reduzir o número de pull requestsl que você pode estar vendo, você pode habilitar atualizações de segurança agrupadas para seu repositório ou sua organização. Quando isso é habilitado, o Dependabot agrupará as atualizações de segurança em uma pull request para cada ecossistema de pacote. Para usar atualizações de segurança agrupadas, você deve primeiro habilitar os seguintes recursos:

• Grafo de dependência Para obter mais informações, confira "Configurando o grafo de dependência".
• Dependabot alerts. Para obter mais informações, confira "Configurando alertas do Dependabot".
• Dependabot security updates. Para obter mais informações, confira "Configurando as atualizações de segurança do Dependabot".

Você pode habilitar pull requests para Dependabot security updates de uma ou ambas as seguintes maneiras.

• Para agrupar o maior número possível de atualizações de segurança disponíveis, entre diretórios e por ecossistema, habilite o agrupamento nas configurações de "Segurança e análise de código" para seu repositório ou em "Configurações globais", sob "Segurança de código", para sua organização.
• Para ter um controle mais fino dos agrupamentos, como agrupamento por nome de pacote, dependências de desenvolvimento/produção, nível SemVer ou entre vários diretórios por ecossistema, adicione opções de configuração ao arquivo de configuração dependabot.yml em seu repositório.

Habilitar ou desabilitar Dependabot security updates agrupadas para um repositório individual

Os administradores de repositório podem habilitar ou desabilitar atualizações de segurança agrupadas para seu repositório. A alteração da configuração do repositório substituirá quaisquer configurações padrão da organização. As regras de grupo configuradas em um arquivo dependabot.yml substituirão as configurações da interface do usuário para habilitar ou desabilitar atualizações de segurança agrupadas no nível da organização ou do repositório.

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

2. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

3. Na seção "Segurança" da barra lateral, clique em Segurança de código e análise.

4. Em "Segurança e análise de código", à direita de "Atualizações de segurança agrupadas", clique em Habilitar para habilitar o recurso ou Desabilitar para desabilitá-lo.

Habilitar ou desabilitar Dependabot security updates agrupadas para uma organização

É possível habilitar o agrupamento de Dependabot security updates em uma única pull request. Para obter mais informações, confira "Configurações de segurança globais para sua organização".

Como substituir o comportamento padrão com um arquivo de configuração

Você pode substituir o comportamento padrão de Dependabot security updates adicionando um arquivo dependabot.yml ao repositório. Com um arquivo dependabot.yml, você pode ter um controle mais granular do agrupamento e substituir o comportamento padrão das Dependabot security updates configurações.

Use a opção groups com a chave applies-to: security-updates para criar conjuntos de dependências (por gerenciador de pacotes), de modo que Dependabot abra uma única pull request para atualizar várias dependências ao mesmo tempo. Você pode definir grupos por nome de pacote (as chaves patterns e exclude-patterns), tipo de dependência (chave dependency-type) e SemVer (a chave update-types).

Dependabot cria grupos na ordem em que aparecem no arquivo dependabot.yml. Se uma atualização de dependência puder pertencer a mais de um grupo, ela será atribuída apenas ao primeiro grupo com o qual corresponder.

Se você precisar apenas das atualizações de segurança e quiser excluir as atualizações de versão, você pode definir open-pull-requests-limit como 0 para evitar atualizações de versão de um determinado package-ecosystem.

Para obter mais informações sobre as opções de configuração disponíveis para atualizações de segurança, confira "Opções de configuração para o arquivo dependabot.yml".

# Example configuration file that:
#  - Has a private registry
#  - Ignores lodash dependency
#  - Disables version-updates
#  - Defines a group by package name, for security updates for golang dependencies

version: 2
registries:
  example:
    type: npm-registry
    url: https://example.com
    token: ${{secrets.NPM_TOKEN}}
updates:
  - package-ecosystem: "npm"
    directory: "/src/npm-project"
    schedule:
      interval: "daily"
    # For Lodash, ignore all updates
    ignore:
      - dependency-name: "lodash"
    # Disable version updates for npm dependencies
    open-pull-requests-limit: 0
    registries:
      - example
  - package-ecosystem: "gomod"
    groups:
      golang:
        applies-to: security-updates
        patterns:
          - "golang.org*"

Leitura adicional

• "Sobre alertas do Dependabot"
• "Configurando alertas do Dependabot"
• "Ecossistemas de pacotes com suporte para grafos de dependência"