Skip to content

Commit 1625564

Browse files
authored
Merge branch 'main' into main
2 parents dcea6c9 + 5b9c7bd commit 1625564

32 files changed

Lines changed: 345 additions & 56 deletions

File tree

Dockerfile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
# ---------------------------------------------------------------
1111
# To update the sha:
1212
# https://github.com/github/gh-base-image/pkgs/container/gh-base-image%2Fgh-base-noble
13-
FROM ghcr.io/github/gh-base-image/gh-base-noble:20260616-174421-gbe30bd25c@sha256:ff51e3a814bf958736588a809c5adc5cc15fe6c74bdb701296a08f86691bc67b AS base
13+
FROM ghcr.io/github/gh-base-image/gh-base-noble:20260622-194245-g8d7fb0aeb@sha256:ec6e933b7e49fcafd02cab5d31a179a96fa9badd127b39eb153bbe2affee9e48 AS base
1414

1515
# Install curl for Node install and determining the early access branch
1616
# Install git for cloning docs-early-access & translations repos

content/account-and-profile/concepts/account-management.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ For more information, see the following articles.
4848
* [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/removing-yourself-from-an-organization)
4949
* [AUTOTITLE](/account-and-profile/reference/personal-account-reference#account-deletion)
5050

51-
To delete your personal account, see [AUTOTITLE](/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/deleting-your-personal-account).
51+
To delete your personal account, see [AUTOTITLE](/account-and-profile/how-tos/account-management/deleting-your-personal-account).
5252

5353
## About unlinking your email address
5454

content/account-and-profile/concepts/email-addresses.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ You can also choose to block commits you push from the command line that expose
5555

5656
To ensure that commits are attributed to you and appear in your contributions graph, use an email address that is connected to your account on {% data variables.product.github %}{% ifversion fpt or ghec %}, or the `noreply` email address provided to you in your email settings{% endif %}.
5757

58-
For more information, see [AUTOTITLE](/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address).
58+
For more information, see [AUTOTITLE](/account-and-profile/how-tos/email-preferences/setting-your-commit-email-address).
5959

6060
## Next steps
6161

content/account-and-profile/concepts/username-changes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,4 +63,4 @@ After changing your username, CODEOWNERS files that include your old username wi
6363

6464
## Next steps
6565

66-
To change your username, see [AUTOTITLE](/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-personal-account/changing-your-username).
66+
To change your username, see [AUTOTITLE](/account-and-profile/how-tos/account-management/changing-your-username).

content/account-and-profile/how-tos/email-preferences/adding-an-email-address-to-your-github-account.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,6 @@ category:
3434

3535
## Next steps
3636

37-
If you are having trouble adding an email address, see [AUTOTITLE](/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/troubleshooting-adding-an-email).
37+
If you are having trouble adding an email address, see [AUTOTITLE](/account-and-profile/how-tos/email-preferences/troubleshooting-adding-an-email).
3838

3939
For reference information, see [AUTOTITLE](/account-and-profile/reference/email-addresses-reference).

content/account-and-profile/tutorials/personalize-your-profile.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -128,4 +128,4 @@ You can set a status to display information about your current availability.
128128

129129
* For reference information, see [AUTOTITLE](/account-and-profile/reference/profile-reference).
130130

131-
* For more detailed profile customizations, see [AUTOTITLE](/account-and-profile/how-tos/setting-up-and-managing-your-github-profile).
131+
* For more detailed profile customizations, see [AUTOTITLE](/account-and-profile/how-tos).
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: Automatic Dependabot access to {% data variables.product.github %}-hosted registries
3+
intro: 'Keep your private dependencies up to date reliably by granting {% data variables.product.prodname_dependabot %} automatic access to {% data variables.product.prodname_registry %} and {% data variables.product.prodname_container_registry %}, so you never need to create or rotate credentials for these registries.'
4+
versions:
5+
feature: org-automatic-registry-access
6+
shortTitle: Automatic registry access
7+
allowTitleToDifferFromFilename: true
8+
contentType: concepts
9+
category:
10+
- Secure your dependencies
11+
---
12+
13+
## About automatic access to {% data variables.product.github %}-hosted registries
14+
15+
{% data variables.product.prodname_dependabot %} can authenticate to private {% data variables.product.prodname_registry %} and {% data variables.product.prodname_container_registry %} packages using the same access grants that {% data variables.product.prodname_actions %} workflows use. If a package has granted your repository **Read** access in the package settings on {% data variables.product.github %}, {% data variables.product.prodname_dependabot %} can access that package automatically.
16+
17+
This eliminates the need to:
18+
19+
* Create and manage {% data variables.product.pat_generic_plural %} for registry access
20+
* Manually configure access to {% data variables.product.github %}-hosted registries in your `dependabot.yml` file
21+
* Rotate credentials when tokens expire
22+
23+
## How automatic access works
24+
25+
{% data variables.product.prodname_dependabot %} uses its `GITHUB_TOKEN` to request `packages: read` permission when pulling from `*.pkg.github.com` and {% data variables.product.prodname_container_registry_namespace %}. Any package that has granted your repository access through "Manage Actions access" accepts this token, the same way it would for a regular {% data variables.product.prodname_actions %} workflow. See [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package).git s
26+
27+
This works for every {% data variables.product.prodname_registry %} ecosystem that {% data variables.product.prodname_dependabot %} supports.
28+
29+
## When to use automatic access
30+
31+
Use automatic access to {% data variables.product.github %}-hosted registries when:
32+
33+
* Your repositories depend on private packages stored in {% data variables.product.prodname_registry %} or {% data variables.product.prodname_container_registry %}.
34+
* You want to reduce credential management overhead.
35+
* You want to avoid silent update failures caused by expired {% data variables.product.pat_generic_plural %}.
36+
37+
For third-party registries (such as Artifactory, Azure Artifacts, or Nexus), you can only use the `dependabot.yml` registry configuration or organization-level private registry settings. See [AUTOTITLE](/code-security/how-tos/secure-your-supply-chain/manage-your-dependency-security/configuring-access-to-private-registries-for-dependabot).
38+
39+
## How to enable automatic access
40+
41+
For each package that {% data variables.product.prodname_dependabot %} needs to read, you need to go to the package's settings page and add the repository that runs {% data variables.product.prodname_dependabot %} with **Read** access. See [AUTOTITLE](/code-security/how-tos/secure-your-supply-chain/manage-your-dependency-security/configuring-access-to-private-registries-for-dependabot#configuring-private-github-hosted-registries).
42+
43+
Once the repository has been granted access, {% data variables.product.prodname_dependabot %} can pull from that package automatically. You do not need to configure the `dependabot.yml` file, and you can remove any existing {% data variables.product.pat_generic %}-based registry entries you previously added for these packages.
44+
45+
For more information about configuring package access, see [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package).

content/code-security/concepts/supply-chain-security/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,10 +22,10 @@ children:
2222
- dependabot-pull-requests
2323
- multi-ecosystem-updates
2424
- about-the-dependabot-yml-file
25+
- automatic-dependabot-access-to-github-registries
2526
- dependabot-auto-triage-rules
2627
- dependabot-on-actions
2728
- dependabot-job-logs
2829
- immutable-releases
2930
- linked-artifacts
3031
---
31-

content/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,19 @@ Any private registries used by the build must also be accessible to the workflow
8181

8282
When you configure access to one or more private registries, {% data variables.product.prodname_dependabot %} can propose pull requests to upgrade a vulnerable dependency or to maintain a dependency, see [AUTOTITLE](/code-security/dependabot/working-with-dependabot/configuring-access-to-private-registries-for-dependabot) and [AUTOTITLE](/code-security/dependabot/working-with-dependabot/guidance-for-the-configuration-of-private-registries-for-dependabot).
8383

84+
{% ifversion org-automatic-registry-access %}
85+
86+
### Automatic access to {% data variables.product.github %}-hosted registries
87+
88+
For packages stored in {% data variables.product.prodname_registry %} and {% data variables.product.prodname_container_registry %}, {% data variables.product.prodname_dependabot %} can authenticate automatically without {% data variables.product.pat_generic_plural %} or `dependabot.yml` registry configuration.
89+
90+
{% data variables.product.prodname_dependabot %} uses its `GITHUB_TOKEN` to request read access, reusing the same package access grants that {% data variables.product.prodname_actions %} workflows use.
91+
92+
To enable this, grant the repository **Read** access to each package in the package settings. Once access is granted, {% data variables.product.prodname_dependabot %} can pull from those packages automatically, and you can remove any {% data variables.product.pat_generic %}-based registry entries you previously configured for them.
93+
94+
See [AUTOTITLE](/code-security/how-tos/secure-your-supply-chain/manage-your-dependency-security/configuring-access-to-private-registries-for-dependabot#configuring-private-github-hosted-registries).
95+
{% endif %}
96+
8497
{% ifversion org-private-registry-oidc %}
8598

8699
### Configuring OIDC authentication for a private registry

content/code-security/how-tos/secure-your-supply-chain/manage-your-dependency-security/configure-access-to-private-registries.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,41 @@ For specific ecosystems, you can configure {% data variables.product.prodname_de
2929

3030
{% ifversion dependabot-on-actions-self-hosted %}To allow {% data variables.product.prodname_dependabot %} access to registries hosted privately or restricted to internal networks, configure {% data variables.product.prodname_dependabot %} to run on {% data variables.product.prodname_actions %} self-hosted runners. For more information, see [AUTOTITLE](/code-security/dependabot/maintain-dependencies/managing-dependabot-on-self-hosted-runners).{% endif %}
3131

32+
{% ifversion org-automatic-registry-access %}
33+
34+
## Configuring private {% data variables.product.github %}-hosted registries
35+
36+
For packages stored in {% data variables.product.prodname_registry %} or {% data variables.product.prodname_container_registry %}, {% data variables.product.prodname_dependabot %} can authenticate automatically using its `GITHUB_TOKEN`. This uses the same "Manage Actions access" grants that {% data variables.product.prodname_actions %} workflows use. No {% data variables.product.pat_generic_plural %} or `dependabot.yml` registry entries are required.git push
37+
38+
The `dependabot.yml` registry configuration using {% data variables.product.pat_generic_title_case %}-based registry entries and described in [Configuring private third-party registries](#configuring-private-third-party-registries) is still required for third-party private registries (such as Artifactory, Azure Artifacts, or Nexus).
39+
40+
To grant {% data variables.product.prodname_dependabot %} access to a private package:
41+
42+
{% data reusables.package_registry.package-settings-from-org-level %}
43+
{% data reusables.package_registry.package-settings-option %}
44+
{% data reusables.package_registry.package-settings-actions-access %}
45+
1. {% data reusables.package_registry.package-settings-add-repo %}.
46+
Search for the repository where {% data variables.product.prodname_dependabot %} runs, and select it.
47+
{% data reusables.package_registry.package-settings-actions-access-role-repo %}
48+
Select **Read** as the access level. {% data variables.product.prodname_dependabot %} only needs read access to pull packages.
49+
50+
You need to repeat these steps for each private package that you want {% data variables.product.prodname_dependabot %} to access.
51+
52+
Once access is granted, {% data variables.product.prodname_dependabot %} can pull from those packages automatically. You can remove any {% data variables.product.pat_generic %}-based registry entries in `dependabot.yml` that you previously configured for these packages.
53+
54+
> [!NOTE]
55+
> This method works for every {% data variables.product.prodname_registry %} ecosystem that {% data variables.product.prodname_dependabot %} supports, including container images in {% data variables.product.prodname_container_registry %}.
56+
57+
For more information about how automatic access works, see [AUTOTITLE](/code-security/concepts/supply-chain-security/automatic-dependabot-access-to-github-registries). For more information about package access settings, see [AUTOTITLE](/packages/learn-github-packages/configuring-a-packages-access-control-and-visibility#ensuring-workflow-access-to-your-package).
58+
59+
## Configuring private third-party registries
60+
61+
{% else %}
62+
3263
## Configuring private registries
3364

65+
{% endif %}
66+
3467
{% ifversion org-private-registry %}
3568

3669
You can configure {% data variables.product.prodname_dependabot %}'s access to private registries at the org-level.

0 commit comments

Comments
 (0)