> ## Documentation Index
> Fetch the complete documentation index at: https://buildcharts.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# NuGetAuthenticate@v1

> Inject Azure Artifacts credentials into generated builds.

This plugin configures NuGet tools to authenticate with Azure Artifacts and other NuGet repositories. It follows the same model as [NuGetAuthenticate@1](https://learn.microsoft.com/en-us/azure/devops/pipelines/tasks/reference/nuget-authenticate-v1?view=azure-pipelines) in Azure DevOps.

## Usage

```yaml theme={"theme":{"light":"plastic","dark":"plastic"}}
plugins:
  - NuGetAuthenticate@v1
```

With this configuration in place, running `buildcharts generate` automatically injects the necessary secrets and modifications so that `dotnet restore` and NuGet push operations can authenticate against Azure Artifacts feeds.

## What it does

* Runs `dotnet nuget list source --format short`
* Keeps sources whose host ends with `pkgs.dev.azure.com` or `pkgs.visualstudio.com`
* Prefers existing environment credentials when available
* Otherwise installs the [Microsoft Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider) under `.buildcharts/plugins/NuGetAuthenticate@v1`
* Writes secret files under `.buildcharts/secrets`
* Writes `ARTIFACTS_CREDENTIALPROVIDER_EXTERNAL_FEED_ENDPOINTS`, a JSON payload describing the endpoint(s) and associated credentials
* Patches the generated `.buildcharts/docker-bake.hcl` so these secrets are mounted into the Docker build

## Environment variables

* `ARTIFACTS_CREDENTIALPROVIDER_EXTERNAL_FEED_ENDPOINTS`
* `ARTIFACTS_CREDENTIALPROVIDER_ACCESSTOKEN`
* `AZURE_ARTIFACTS_ENV_ACCESS_TOKEN`
* `SYSTEM_ACCESSTOKEN`
* `VSS_NUGET_ACCESSTOKEN` (legacy)
* `VSS_NUGET_EXTERNAL_FEED_ENDPOINTS` (legacy)

<Note>
  `ARTIFACTS_CREDENTIALPROVIDER_*` is the preferred prefix. The older `VSS_NUGET_*` variables are legacy names kept for compatibility. See the [Artifacts Credential Provider environment variables](https://github.com/microsoft/artifacts-credprovider#environment-variables).
</Note>

## Notes

* The plugin only acts on Azure DevOps-hosted NuGet feeds.
* If no matching NuGet sources are found, the plugin exits without patching the generated HCL.

## Read more

* [Azure DevOps NuGetAuthenticate@1](https://learn.microsoft.com/en-us/azure/devops/pipelines/tasks/reference/nuget-authenticate-v1?view=azure-pipelines)
* [Managing NuGet Credentials in Docker Scenarios](https://github.com/dotnet/dotnet-docker/blob/main/documentation/scenarios/nuget-credentials.md#using-the-azure-artifact-credential-provider)
* [Microsoft Artifacts Credential Provider](https://github.com/microsoft/artifacts-credprovider)