Dependabot helps users find and fix vulnerabilities in their dependencies. You must first set up Dependabot for your enterprise, and then you can enable Dependabot alerts to notify users about vulnerable dependencies and Dependabot updates to fix the vulnerabilities and keep dependencies updated to the latest version.
Dependabot is just one of many features available to harden supply chain security for . For more information about the other features, see About supply chain security for your enterprise.
With Dependabot alerts, identifies insecure dependencies in repositories and creates alerts on Enterprise Server, using data from the Advisory Database and the dependency graph service.
We add advisories to the Advisory Database from the following sources:
- Security advisories reported on
- The National Vulnerability database
- The npm Security advisories database
- The FriendsOfPHP database
- The Go Vulncheck database
- The Python Packaging Advisory database
- The Ruby Advisory database
- The RustSec Advisory database
- Community contributions. For more information, see https://.com//advisory-database/pulls.
If you know of another database we should be importing advisories from, tell us about it by opening an issue in https://.com//advisory-database.
After you set up Dependabot for your enterprise, vulnerability data is synced from the Advisory Database to your instance once every hour. Only -reviewed advisories are synchronized. For more information, see Browsing security advisories in the Advisory Database.
You can also choose to manually sync vulnerability data at any time. For more information, see Viewing the vulnerability data for your enterprise.
Note
When you enable Dependabot alerts, no code or information about code from Enterprise Server is uploaded to .com or GHE.com.
When Enterprise Server receives information about a vulnerability, it identifies repositories that use the affected version of the dependency and generates Dependabot alerts. You can choose whether or not to notify users automatically about new Dependabot alerts.
For repositories with Dependabot alerts enabled, scanning is triggered on any push to the default branch that contains a manifest file or lock file. Additionally, when a new vulnerability record is added, Enterprise Server scans all existing repositories and generates alerts for any repository that is vulnerable. For more information, see About Dependabot alerts.
After you enable Dependabot alerts, you can choose to enable Dependabot updates. When Dependabot updates are enabled for Enterprise Server, users can configure repositories so that their dependencies are updated and kept secure automatically.
Note
Dependabot updates on Enterprise Server requires Actions with self-hosted runners.
By default, Actions runners used by Dependabot need access to the internet, to download updated packages from upstream package managers. For Dependabot updates powered by Connect, internet access provides your runners with a token that allows access to dependencies and advisories hosted on .com.
You can enable Dependabot updates for specific private registries on Enterprise Server instances with limited, or no, internet access. For more information, see Configuring Dependabot to work with limited internet access.
With Dependabot updates, automatically creates pull requests to update dependencies in two ways.
- Dependabot version updates: Users add a Dependabot configuration file to the repository to enable Dependabot to create pull requests when a new version of a tracked dependency is released. For more information, see About Dependabot version updates.
- Dependabot security updates: Users toggle a repository setting to enable Dependabot to create pull requests when detects a vulnerability in one of the dependencies of the dependency graph for the repository. For more information, see About Dependabot alerts and About Dependabot security updates.
Before you can enable Dependabot alerts, you must first set up Dependabot for your enterprise:
- You must enable Connect. For more information, see Enabling Connect for .com.
- You must enable the dependency graph. For more information, see Enabling the dependency graph for your enterprise.
In the top-right corner of Enterprise Server, click your profile photo, then click Enterprise settings.
At the top of the page, click Connect.
Under "Dependabot", to the right of "Periodically download the Advisory Database so that users can receive vulnerability alerts for open source code dependencies", select the dropdown menu and click Enabled without notifications. Optionally, to enable alerts with notifications, click Enabled with notifications.
Note
This setting controls realtime email and web notifications only. Command line interface (CLI) warnings and email digests will still be delivered regardless of which option is selected.
Tip
We recommend configuring Dependabot alerts without notifications for the first few days to avoid an overload of realtime notifications. After a few days, you can enable notifications to receive Dependabot alerts as usual.
You can now enable Dependabot alerts for all existing or new private and internal repositories in the enterprise settings page for "Advanced Security." Alternatively, repository administrators and organization owners can enable Dependabot alerts for each repository and organization. Public repositories are always enabled by default. For more information, see Configuring Dependabot alerts.
Before you can enable Dependabot updates:
- You must enable Dependabot alerts for your enterprise. For more information, see "Enabling Dependabot alerts" above.
- You must enable TLS. Dependabot updates run on self-hosted runners, which need to have TLS enabled. For more information, see Getting started with self-hosted runners for your enterprise.
- You must configure Enterprise Server to use Actions with self-hosted runners. For more information, see Getting started with Actions for Enterprise Server.
Dependabot updates are not supported on Enterprise Server if your enterprise uses clustering.
Note
After you enable the dependency graph, you can use the Dependabot action. The action will raise an error if any vulnerabilities or invalid licenses are being introduced. For more information about the action, and for instructions about how to download the most recent version, see Using the latest version of the official bundled actions.
Sign in to your Enterprise Server instance at
http(s)://HOSTNAME/login.From an administrative account on Enterprise Server, in the upper-right corner of any page, click .
If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.
In the " Site admin" sidebar, click Management Console.
In the "Settings" sidebar, click Security.
Under "Security", select Dependabot updates.
Under the "Settings" sidebar, click Save settings.
Note
Saving settings in the Management Console restarts system services, which could result in user-visible downtime.
Wait for the configuration run to complete.
Click Visit your instance.
Configure dedicated self-hosted runners to create the pull requests that will update dependencies. This is required because the workflows use a specific runner label. For more information, see Managing self-hosted runners for Dependabot updates on your enterprise.
In the top-right corner of Enterprise Server, click your profile photo, then click Enterprise settings.
At the top of the page, click Connect.
Under "Dependabot", to the right of "Users can easily upgrade to non-vulnerable open source code dependencies", click Enable.
When you enable Dependabot alerts, you should consider also setting up Actions for Dependabot security updates. This feature allows developers to fix vulnerabilities in their dependencies. For more information, see Managing self-hosted runners for Dependabot updates on your enterprise.
If you need enhanced security, we recommend configuring Dependabot to use private registries. For more information, see Configuring access to private registries for Dependabot.