-
Notifications
You must be signed in to change notification settings - Fork 504
Add info about data.nuget.org #3561
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Changes from 1 commit
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -175,6 +175,10 @@ For example: | |
| </configuration> | ||
| ``` | ||
|
|
||
| > [!TIP] | ||
| > If your organization blocks access to `api.nuget.org`, consider asking the network administrator to allow `https://data.nuget.org/v3/index.json` and configure it as an [audit source](Auditing-Packages.md#audit-sources) for [NuGet Audit](Auditing-Packages.md). | ||
| > This endpoint only serves vulnerability data, not packages, so it might be allowed even when `api.nuget.org` is blocked. | ||
|
Comment on lines
+178
to
+180
|
||
|
|
||
| ### NuGet feeds | ||
|
|
||
| **📦 Package Consumer** | ||
|
|
||
| Original file line number | Diff line number | Diff line change | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
@@ -50,3 +50,11 @@ To use NuGet.org as a package repository with NuGet clients, you should use the | |||||||||||||||
| Older clients can still use the V2 protocol to reach NuGet.org. However, please note, NuGet clients 3.0 or later will have slower and less reliable service using the V2 protocol: | ||||||||||||||||
|
|
||||||||||||||||
| `https://www.nuget.org/api/v2` (**The V2 protocol is deprecated!**) | ||||||||||||||||
|
|
||||||||||||||||
| nuget.org also provides a vulnerability-data-only endpoint: | ||||||||||||||||
|
||||||||||||||||
| nuget.org also provides a vulnerability-data-only endpoint: | |
| NuGet.org also provides a vulnerability-data-only endpoint: |
Copilot
AI
Apr 22, 2026
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
“Service index … doesn't serve packages” is a bit misleading because service indexes typically list resource endpoints rather than serving package content directly. Consider rewording to clarify that https://data.nuget.org/v3/index.json doesn't advertise package download/search resources (it only advertises VulnerabilityInfo).
| This service index only contains the [`VulnerabilityInfo`](../api/vulnerability-info.md) resource and doesn't serve packages. | |
| It's designed for use as an [audit source](../concepts/Auditing-Packages.md#audit-sources) in environments where access to `api.nuget.org` is blocked at the network level. | |
| Because this endpoint doesn't provide package content, network administrators who block `api.nuget.org` to prevent package downloads might be willing to allow `data.nuget.org` if asked. | |
| This service index only advertises the [`VulnerabilityInfo`](../api/vulnerability-info.md) resource. | |
| It doesn't advertise package search or package download resources. | |
| It's designed for use as an [audit source](../concepts/Auditing-Packages.md#audit-sources) in environments where access to `api.nuget.org` is blocked at the network level. | |
| Because this endpoint doesn't advertise package download resources, network administrators who block `api.nuget.org` to prevent package downloads might be willing to allow `data.nuget.org` if asked. |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -161,6 +161,11 @@ Audit sources support the same attributes as `packageSources` (`protocolVersion` | |
| </auditSources> | ||
| ``` | ||
|
|
||
| > [!TIP] | ||
| > nuget.org also provides `https://data.nuget.org/v3/index.json`, a service index that only contains vulnerability data and doesn't serve packages. | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. What do you think about updating VS Options docs to also have a similar callout? https://learn.microsoft.com/en-us/nuget/consume-packages/nuget-visual-studio-options#audit-sources
Member
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @copilot add a similar message in the managing audit sources section of the visual studio options docs
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Added the similar |
||
| > Network administrators who block `api.nuget.org` to prevent package downloads might be willing to allow `data.nuget.org` if asked. | ||
| > For more information, see [audit sources](../concepts/Auditing-Packages.md#audit-sources). | ||
|
|
||
| ### packageSourceCredentials | ||
|
|
||
| Stores usernames and passwords for sources, typically specified with the `-username` and `-password` switches with `nuget sources`. Passwords are encrypted by default unless the `-storepasswordincleartext` option is also used. | ||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The phrase “doesn't include package content” can be confusing for a service index (which normally only lists resource endpoints). Consider rewording this bullet to explicitly say it doesn't include package download/search (or other non-vulnerability) resources, rather than referring to “package content”.