Delen via


dotnet nuget vertrouwen

Dit artikel is van toepassing op: ✔️ .NET 6 SDK en latere versies

Naam

dotnet nuget trust - Haalt vertrouwde ondertekenaars op of stelt deze in op de NuGet-configuratie.

Samenvatting

dotnet nuget trust [command] [Options]

dotnet nuget trust -h|--help

Description

De dotnet nuget trust opdracht beheert de vertrouwde ondertekenaars. Standaard accepteert NuGet alle auteurs en opslagplaatsen. Met deze opdrachten kunt u alleen een specifieke subset van ondertekenaars opgeven waarvan de handtekeningen worden geaccepteerd, terwijl alle andere worden geweigerd. Zie Algemene NuGet-configuraties voor meer informatie. Raadpleeg de verwijzing naar het NuGet-configuratiebestand voor meer informatie over hoe het nuget.config schema eruitziet.

Opmerking

Voor deze opdracht is een certificaathoofdarchief vereist dat geldig is voor zowel ondertekening als tijdstempel van code. Deze opdracht wordt mogelijk niet ondersteund voor bepaalde combinaties van besturingssysteem en .NET SDK. Zie NuGet-ondertekende pakketverificatie voor meer informatie.

Options

  • -?|-h|--helpHiermee wordt een beschrijving afgedrukt van het gebruik van de opdracht.

Commands

Als er geen opdracht is opgegeven, wordt de opdracht standaard ingesteld op list.

list

Een lijst met alle vertrouwde ondertekenaars in de configuratie. Deze optie bevat alle certificaten (met vingerafdruk- en vingerafdrukalgoritmen) die elke ondertekenaar heeft. Als een certificaat een voorgaande [U] heeft, betekent dit dat de certificaatvermelding allowUntrustedRoot als waar heeft ingesteld.

Samenvatting:

dotnet nuget trust list [--configfile <PATH>] [-h|--help] [-v, --verbosity <LEVEL>]

Options:

  • --configfile <FILE>

    Het NuGet-configuratiebestand (nuget.config) dat moet worden gebruikt. Indien opgegeven, worden alleen de instellingen uit dit bestand gebruikt. Als dit niet is opgegeven, wordt de hiërarchie van configuratiebestanden uit de huidige map gebruikt. Zie Common NuGet Configurationsvoor meer informatie.

  • -?|-h|--help

    Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.

  • -v|--verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. De standaardwaarde is minimal. Zie LoggerVerbosity voor meer informatie.

sync

Hiermee verwijdert u de huidige lijst met certificaten en vervangt u deze door een up-to-datumlijst uit de opslagplaats.

Samenvatting

dotnet nuget trust sync <NAME> [--configfile <PATH>] [-h|--help] [-v, --verbosity <LEVEL>]

Arguments

  • NAME

    De naam van de bestaande vertrouwde ondertekenaar die moet worden gesynchroniseerd.

Options:

  • --configfile <FILE>

    Het NuGet-configuratiebestand (nuget.config) dat moet worden gebruikt. Indien opgegeven, worden alleen de instellingen uit dit bestand gebruikt. Als dit niet is opgegeven, wordt de hiërarchie van configuratiebestanden uit de huidige map gebruikt. Zie Common NuGet Configurationsvoor meer informatie.

  • -?|-h|--help

    Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.

  • -v|--verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. De standaardwaarde is minimal. Zie LoggerVerbosity voor meer informatie.

remove

Hiermee verwijdert u vertrouwde ondertekenaars die overeenkomen met de opgegeven naam.

Samenvatting

dotnet nuget trust remove <NAME> [--configfile <PATH>] [-h|--help] [-v, --verbosity <LEVEL>]

Arguments

  • NAME

    De naam van de bestaande vertrouwde ondertekenaar die u wilt verwijderen.

Options:

  • --configfile <FILE>

    Het NuGet-configuratiebestand (nuget.config) dat moet worden gebruikt. Indien opgegeven, worden alleen de instellingen uit dit bestand gebruikt. Als dit niet is opgegeven, wordt de hiërarchie van configuratiebestanden uit de huidige map gebruikt. Zie Common NuGet Configurationsvoor meer informatie.

  • -?|-h|--help

    Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.

  • -v|--verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. De standaardwaarde is minimal. Zie LoggerVerbosity voor meer informatie.

author

Hiermee voegt u een vertrouwde ondertekenaar met de opgegeven naam toe op basis van de handtekening van de auteur van het pakket.

Samenvatting

dotnet nuget trust author <NAME> <PACKAGE> [--allow-untrusted-root] [--configfile <PATH>] [-h|--help] [-v, --verbosity <LEVEL>]

Arguments

  • NAME

    De naam van de vertrouwde ondertekenaar die u wilt toevoegen. Als NAME de configuratie al bestaat, wordt de handtekening toegevoegd.

  • PACKAGE

    Het opgegeven PACKAGE moet een lokaal pad naar het ondertekende .nupkg-bestand zijn.

Options:

  • --allow-untrusted-root

    Hiermee geeft u op of het certificaat voor de vertrouwde ondertekenaar moet worden gekoppeld aan een niet-vertrouwde basis. Dit wordt niet aanbevolen.

  • --configfile <FILE>

    Het NuGet-configuratiebestand (nuget.config) dat moet worden gebruikt. Indien opgegeven, worden alleen de instellingen uit dit bestand gebruikt. Als dit niet is opgegeven, wordt de hiërarchie van configuratiebestanden uit de huidige map gebruikt. Zie Common NuGet Configurationsvoor meer informatie.

  • -?|-h|--help

    Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.

  • -v|--verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. De standaardwaarde is minimal. Zie LoggerVerbosity voor meer informatie.

repository

Voegt een vertrouwde ondertekenaar toe met de opgegeven naam, op basis van de handtekening van de opslagplaats of de tegentekening van een ondertekend pakket.

Samenvatting

dotnet nuget trust repository <NAME> <PACKAGE> [--allow-untrusted-root] [--configfile <PATH>] [-h|--help] [--owners <LIST>] [-v, --verbosity <LEVEL>]

Arguments

  • NAME

    De naam van de vertrouwde ondertekenaar die u wilt toevoegen. Als NAME de configuratie al bestaat, wordt de handtekening toegevoegd.

  • PACKAGE

    Het opgegeven PACKAGE moet een lokaal pad naar het ondertekende .nupkg-bestand zijn.

Options:

  • --allow-untrusted-root

    Hiermee geeft u op of het certificaat voor de vertrouwde ondertekenaar moet worden gekoppeld aan een niet-vertrouwde basis. Dit wordt niet aanbevolen.

  • --configfile <FILE>

    Het NuGet-configuratiebestand (nuget.config) dat moet worden gebruikt. Indien opgegeven, worden alleen de instellingen uit dit bestand gebruikt. Als dit niet is opgegeven, wordt de hiërarchie van configuratiebestanden uit de huidige map gebruikt. Zie Common NuGet Configurationsvoor meer informatie.

  • -?|-h|--help

    Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.

  • --owners <LIST>

    Door puntkomma's gescheiden lijst met vertrouwde eigenaren om het vertrouwen van een opslagplaats verder te beperken.

  • -v|--verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. De standaardwaarde is minimal. Zie LoggerVerbosity voor meer informatie.

certificate

Voegt een vertrouwde ondertekenaar toe met de opgegeven naam, op basis van een vingerafdruk van een certificaat.

Samenvatting

dotnet nuget trust certificate <NAME> <FINGERPRINT> [--algorithm <ALGORITHM>] [--allow-untrusted-root] [--configfile <PATH>] [-h|--help] [-v, --verbosity <LEVEL>]

Arguments

  • NAME

    De naam van de vertrouwde ondertekenaar die u wilt toevoegen. Als er al een vertrouwde ondertekenaar met de opgegeven naam bestaat, wordt het certificaatitem toegevoegd aan die ondertekenaar. Anders wordt een vertrouwde auteur gemaakt met een certificaatitem van de opgegeven certificaatgegevens.

  • FINGERPRINT

    De vingerafdruk van het certificaat.

Options:

  • --algorithm <ALGORITHM>

    Hiermee geeft u het hash-algoritme dat wordt gebruikt om de vingerafdruk van het certificaat te berekenen. Standaard ingesteld op SHA256. Ondersteunde waarden zijn SHA256, SHA384 en SHA512.

  • --allow-untrusted-root

    Hiermee geeft u op of het certificaat voor de vertrouwde ondertekenaar moet worden gekoppeld aan een niet-vertrouwde basis. Dit wordt niet aanbevolen.

  • --configfile <FILE>

    Het NuGet-configuratiebestand (nuget.config) dat moet worden gebruikt. Indien opgegeven, worden alleen de instellingen uit dit bestand gebruikt. Als dit niet is opgegeven, wordt de hiërarchie van configuratiebestanden uit de huidige map gebruikt. Zie Common NuGet Configurationsvoor meer informatie.

  • -?|-h|--help

    Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.

  • -v|--verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. De standaardwaarde is minimal. Zie LoggerVerbosity voor meer informatie.

source

Voegt een vertrouwde ondertekenaar toe op basis van een bepaalde pakketbron.

Samenvatting

dotnet nuget trust source <NAME> [--configfile <PATH>] [-h|--help] [--owners <LIST>] [--source-url] [-v, --verbosity <LEVEL>]

Arguments

  • NAME

    De naam van de vertrouwde ondertekenaar die u wilt toevoegen. Als er alleen <NAME> zonder --<source-url>wordt opgegeven, wordt de pakketbron uit uw NuGet-configuratiebestanden met dezelfde naam toegevoegd aan de vertrouwde lijst. Als <NAME> de configuratie al bestaat, wordt de pakketbron eraan toegevoegd.

Options:

  • --configfile <FILE>

    Het NuGet-configuratiebestand (nuget.config) dat moet worden gebruikt. Indien opgegeven, worden alleen de instellingen uit dit bestand gebruikt. Als dit niet is opgegeven, wordt de hiërarchie van configuratiebestanden uit de huidige map gebruikt. Zie Common NuGet Configurationsvoor meer informatie.

  • -?|-h|--help

    Hiermee wordt een beschrijving afgedrukt van hoe de opdracht gebruikt moet worden.

  • --owners <LIST>

    Door puntkomma's gescheiden lijst met vertrouwde eigenaren om het vertrouwen van een opslagplaats verder te beperken.

  • --source-url

    Als er een source-url is opgegeven, moet het een v3-pakketbron-URL (zoals https://api.nuget.org/v3/index.json). Andere pakketbrontypen worden niet ondersteund.

  • -v|--verbosity <LEVEL>

    Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijnq[uiet], , , m[inimal]en n[ormal]d[etailed]diag[nostic]. De standaardwaarde is minimal. Zie LoggerVerbosity voor meer informatie.

Voorbeelden

  • Vertrouwde ondertekenaars vermelden:

    dotnet nuget trust list
    
  • Vertrouwensbron NuGet in het opgegevennuget.config-bestand:

    dotnet nuget trust source NuGet --configfile ..\nuget.config
    
  • Vertrouw een auteur van een ondertekend nupkg-pakketbestand foo.nupkg:

    dotnet nuget trust author PackageAuthor .\foo.nupkg
    
  • Vertrouw een opslagplaats van een ondertekend nupkg-pakketbestand foo.nupkg:

    dotnet nuget trust repository PackageRepository .\foo.nupkg
    
  • Vertrouw een certificaat voor pakketondertekening met behulp van de SHA256-vingerafdruk:

      dotnet nuget trust certificate MyCert  F99EC8CDCE5642B380296A19E22FA8EB3AEF1C70079541A2B3D6E4A93F5E1AFD --algorithm SHA256
    
  • Vertrouwenseigenaren Nuget en Microsoft uit de opslagplaats https://api.nuget.org/v3/index.json:

      dotnet nuget trust source NuGetTrust --source-url https://api.nuget.org/v3/index.json --owners "Nuget;Microsoft"
    
  • Vertrouwde ondertekenaar met de naam NuGet verwijderen uit het opgegevennuget.config-bestand :

      dotnet nuget trust remove NuGet --configfile ..\nuget.config