This article applies to: ✔️ .NET 5.0.300 SDK and later versions
Contents
Arguments
• NAME
The name of the trusted signer to add. If only <NAME> is provided without --<source-url>, the package
source from your NuGet configuration files with the same name is added to the trusted list. If <NAME>
already exists in the configuration, the package source is appended to it.
Options:
• --configfile<FILE>
The NuGet configuration file (nuget.config) to use. If specified, only the settings from this file
will be used. If not specified, the hierarchy of configuration files from the current directory will
be used. For more information, see Common NuGet Configurations.
• -?|-h|--help
Prints out a description of how to use the command.
• --owners<LIST>
Semicolon-separated list of trusted owners to further restrict the trust of a repository.
• --source-url
If a source-url is provided, it must be a v3 package source URL (like https://api.nuget.org/v3/in‐dex.json). Other package source types are not supported.
• -v|--verbosity<LEVEL>
Sets the verbosity level of the command. Allowed values are q[uiet], m[inimal], n[ormal], d[etailed],
and diag[nostic]. The default is minimal. For more information, see <xref:Microsoft.Build.Frame‐
work.LoggerVerbosity>.
Description
The dotnetnugettrust command manages the trusted signers. By default, NuGet accepts all authors and
repositories. These commands allow you to specify only a specific subset of signers whose signatures
will be accepted, while rejecting all others. For more information, see Common NuGet configurations.
For details on what the nuget.config schema looks like, refer to the NuGet config file reference.
This command requires a certificate root store that is valid for both code signing and timestamp‐
ing. Also, this command may not be supported on some combinations of operating system and .NET
SDK. For more information, see NuGet signed package verification.
Dotnet Nuget Trust
Thisarticleappliesto: ✔️ .NET 5.0.300 SDK and later versions
Examples
• List trusted signers:
dotnet nuget trust list
• Trust source NuGet in specified nuget.config file:
dotnet nuget trust source NuGet --configfile ..\nuget.config
• Trust an author from signed nupkg package file foo.nupkg:
dotnet nuget trust author PackageAuthor .\foo.nupkg
• Trust a repository from signed nupkg package file foo.nupkg:
dotnet nuget trust repository PackageRepository .\foo.nupkg
• Trust a package signing certificate using its SHA256 fingerprint:
dotnet nuget trust certificate MyCert F99EC8CDCE5642B380296A19E22FA8EB3AEF1C70079541A2B3D6E4A93F5E1AFD --algorithm SHA256
• Trust owners Nuget and Microsoft from the repository https://api.nuget.org/v3/index.json:
dotnet nuget trust source NuGetTrust --source-url https://api.nuget.org/v3/index.json --owners "Nuget;Microsoft"
• Remove trusted signer named NuGet from specified nuget.config file:
dotnet nuget trust remove NuGet --configfile ..\nuget.config
2024-10-02 dotnet-nuget-trust(1)
Name
dotnet-nuget-trust - Gets or sets trusted signers to the NuGet configuration.
Options
• -?|-h|--help
Prints out a description of how to use the command.
Commands
If no command is specified, the command will default to list.
list
Lists all the trusted signers in the configuration. This option will include all the certificates (with
fingerprint and fingerprint algorithm) each signer has. If a certificate has a preceding [U], it means
that certificate entry has allowUntrustedRoot set as true.
Synopsis:
dotnet nuget trust list [--configfile <PATH>] [-h|--help] [-v, --verbosity <LEVEL>]
Options:
• --configfile<FILE>
The NuGet configuration file (nuget.config) to use. If specified, only the settings from this file
will be used. If not specified, the hierarchy of configuration files from the current directory will
be used. For more information, see Common NuGet Configurations.
• -?|-h|--help
Prints out a description of how to use the command.
• -v|--verbosity<LEVEL>
Sets the verbosity level of the command. Allowed values are q[uiet], m[inimal], n[ormal], d[etailed],
and diag[nostic]. The default is minimal. For more information, see <xref:Microsoft.Build.Frame‐
work.LoggerVerbosity>.
sync
Deletes the current list of certificates and replaces them with an up-to-date list from the repository.
Synopsis
dotnet nuget trust source <NAME> [--configfile <PATH>] [-h|--help] [--owners <LIST>] [--source-url] [-v, --verbosity <LEVEL>]
