Enabling the dependency graph and Dependabot alerts on your enterprise account

You can connect your GitHub Enterprise Server instance to GitHub Enterprise Cloud and enable the dependency graph and Alertas do Dependabot in repositories in your instance.

Enterprise owners who are also owners of the connected GitHub Enterprise Cloud organization or enterprise account can enable the dependency graph and Alertas do Dependabot on your GitHub Enterprise Server instance.

About alerts for vulnerable dependencies on your GitHub Enterprise Server instance

GitHub identifies vulnerable dependencies in repositories and creates Alertas do Dependabot on your GitHub Enterprise Server instance, using:

  • Data from the Banco de Dados Consultivo GitHub
  • The dependency graph service

For more information about these features, see "About the dependency graph" and "About alerts for vulnerable dependencies."

About synchronization of data from the Banco de Dados Consultivo GitHub

Adicionamos vulnerabilidades a Banco de Dados Consultivo GitHub a partir das seguintes fontes:

  • A Base de Dados de Vulnerabilidade Nacional
  • Uma combinação de aprendizado de máquina e revisão humana para detectar vulnerabilidades em commits públicos em GitHub
  • Consultorias de segurança relatadas em GitHub
  • O banco de dados de Consultorias de segurança de npm

You can connect your GitHub Enterprise Server instance to GitHub.com with GitHub Connect. Once connected, vulnerability data is synced from the Banco de Dados Consultivo GitHub to your instance once every hour. You can also choose to manually sync vulnerability data at any time. No code or information about code from your GitHub Enterprise Server instance is uploaded to GitHub.com.

About generation of Alertas do Dependabot

If you enable vulnerability detection, when your GitHub Enterprise Server instance receives information about a vulnerability, it identifies repositories in your instance that use the affected version of the dependency and generates Alertas do Dependabot. You can choose whether or not to notify users automatically about new Alertas do Dependabot.

Enabling the dependency graph and Alertas do Dependabot for vulnerable dependencies on your GitHub Enterprise Server instance

Prerequisites

For your GitHub Enterprise Server instance to detect vulnerable dependencies and generate Alertas do Dependabot:

You can enable the dependency graph via the Console de gerenciamento or the administrative shell. We recommend you follow the Console de gerenciamento route unless your GitHub Enterprise Server instance uses clustering.

Enabling the dependency graph via the Console de gerenciamento

  1. Faça login no your GitHub Enterprise Server instance em http(s)://HOSTNAME/login.
  2. A partir de uma conta administrativa em GitHub Enterprise Server, clique em no canto superior direito de qualquer página. Ícone de foguete para acessar as configurações de administrador do site
  3. Na barra lateral esquerda, clique em Console de gerenciamento. Console de gerenciamento aba na barra lateral esquerda
  4. In the left sidebar, click Security. Security sidebar
  5. Under "Security," click Dependency graph. Checkbox to enable or disable the dependency graph
  6. Na barra lateral esquerda, clique Save settings (Salvar configurações). Botão Save settings (Salvar configurações) no Console de gerenciamento
  7. Aguarde a conclusão da execução de suas configurações.
  8. Click Visit your instance.

Enabling the dependency graph via the administrative shell

  1. Faça login no your GitHub Enterprise Server instance em http(s)://HOSTNAME/login.

  2. In the administrative shell, enable the dependency graph on your GitHub Enterprise Server instance:

    $ ghe-config app.dependency-graph.enabled true

    Note: For more information about enabling access to the administrative shell via SSH, see "Accessing the administrative shell (SSH)."

  3. Apply the configuration.

    $ ghe-config-apply
  4. Return to GitHub Enterprise Server.

Enabling Alertas do Dependabot

Before enabling Alertas do Dependabot for your instance, you need to enable the dependency graph. For more information, see above.

  1. No canto superior direito de GitHub Enterprise Server, clique na sua foto de perfil e, em seguida, clique em Configurações da empresa. "Configurações da empresa" no menu suspenso para foto do perfil em GitHub Enterprise Server

  2. In the enterprise account sidebar, click GitHub Connect. GitHub Connect tab in the enterprise account sidebar

  3. Under "Repositories can be scanned for vulnerabilities", select the drop-down menu and click Enabled without notifications. Optionally, to enable alerts with notifications, click Enabled with notifications. Drop-down menu to enable scanning repositories for vulnerabilities

    Tip: We recommend configuring Alertas do Dependabot without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive Alertas do Dependabot as usual.

Viewing vulnerable dependencies on your GitHub Enterprise Server instance

You can view all vulnerabilities in your GitHub Enterprise Server instance and manually sync vulnerability data from GitHub.com to update the list.

  1. A partir de uma conta administrativa em GitHub Enterprise Server, clique em no canto superior direito de qualquer página. Ícone de foguete para acessar as configurações de administrador do site
  2. In the left sidebar, click Vulnerabilities. Vulnerabilities tab in the site admin sidebar
  3. To sync vulnerability data, click Sync Vulnerabilities now. Sync vulnerabilities now button

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.