Dela via

dotnet nuget-förtroende

Den här artikeln gäller för: ✔️ .NET 6 SDK och senare versioner

Namn

dotnet nuget trust – Hämtar eller anger betrodda undertecknare till NuGet-konfigurationen.

Sammanfattning

dotnet nuget trust [command] [Options]

dotnet nuget trust -h|--help

Description

Kommandot dotnet nuget trust hanterar betrodda undertecknare. Som standard accepterar NuGet alla författare och lagringsplatser. Med de här kommandona kan du bara ange en specifik delmängd av undertecknare vars signaturer kommer att accepteras, samtidigt som du avvisar alla andra. Mer information finns i Vanliga NuGet-konfigurationer. Mer information om hur nuget.config-schemat ser ut finns i referensen för NuGet-konfigurationsfilen.

Anmärkning

Det här kommandot kräver ett rotarkiv för certifikat som är giltigt för både kodsignering och tidsstämpling. Det här kommandot kanske inte heller stöds i vissa kombinationer av operativsystem och .NET SDK. Mer information finns i NuGet-signerad paketverifiering.

Options

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

Commands

Om inget kommando har angetts kommer kommandot som standard att listvara .

list

Visar en lista över alla betrodda undertecknare i konfigurationen. Det här alternativet inkluderar alla certifikat (med fingeravtrycks- och fingeravtrycksalgoritm) som varje undertecknare har. Om ett certifikat har ett föregående [U] innebär det att certifikatposten har allowUntrustedRoot inställt som true.

Sammanfattning:

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

Options:

  • --configfile <FILE>

    NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är minimal. Mer information finns i LoggerVerbosity.

sync

Tar bort den aktuella listan över certifikat och ersätter dem med en up-to-date-lista från lagringsplatsen.

Sammanfattning

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

Arguments

  • NAME

    Namnet på den befintliga betrodda undertecknaren som ska synkroniseras.

Options:

  • --configfile <FILE>

    NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är minimal. Mer information finns i LoggerVerbosity.

remove

Tar bort alla betrodda undertecknare som matchar det angivna namnet.

Sammanfattning

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

Arguments

  • NAME

    Namnet på den befintliga betrodda undertecknaren att ta bort.

Options:

  • --configfile <FILE>

    NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är minimal. Mer information finns i LoggerVerbosity.

author

Lägger till en betrodd undertecknare med det angivna namnet, baserat på paketets författarens signatur.

Sammanfattning

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

Arguments

  • NAME

    Namnet på den betrodda undertecknaren som ska läggas till. Om NAME det redan finns i konfigurationen läggs signaturen till.

  • PACKAGE

    Angiven PACKAGE ska vara en lokal sökväg till den signerade .nupkg-filen .

Options:

  • --allow-untrusted-root

    Anger om certifikatet för den betrodda undertecknaren ska tillåtas länka till en rot som inte är betrodd. Detta rekommenderas inte.

  • --configfile <FILE>

    NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är minimal. Mer information finns i LoggerVerbosity.

repository

Lägger till en betrodd undertecknare med det angivna namnet, baserat på lagringsplatsens signatur eller motsignering av ett signerat paket.

Sammanfattning

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

Arguments

  • NAME

    Namnet på den betrodda undertecknaren som ska läggas till. Om NAME det redan finns i konfigurationen läggs signaturen till.

  • PACKAGE

    Angiven PACKAGE ska vara en lokal sökväg till den signerade .nupkg-filen .

Options:

  • --allow-untrusted-root

    Anger om certifikatet för den betrodda undertecknaren ska tillåtas länka till en rot som inte är betrodd. Detta rekommenderas inte.

  • --configfile <FILE>

    NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • --owners <LIST>

    Semikolonavgränsad lista över betrodda ägare för att ytterligare begränsa förtroendet för en lagringsplats.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är minimal. Mer information finns i LoggerVerbosity.

certificate

Lägger till en betrodd undertecknare med förnamnet baserat på ett certifikats fingeravtryck.

Sammanfattning

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

Arguments

  • NAME

    Namnet på den betrodda undertecknaren som ska läggas till. Om det redan finns en betrodd undertecknare med det angivna namnet läggs certifikatobjektet till i den undertecknaren. Annars skapas en betrodd författare med ett certifikatobjekt från den angivna certifikatinformationen.

  • FINGERPRINT

    Certifikatets fingeravtryck.

Options:

  • --algorithm <ALGORITHM>

    Anger hash-algoritmen som används för att beräkna certifikatets fingeravtryck. Standardvärdet är SHA256. Värden som stöds är SHA256, SHA384 och SHA512.

  • --allow-untrusted-root

    Anger om certifikatet för den betrodda undertecknaren ska tillåtas länka till en rot som inte är betrodd. Detta rekommenderas inte.

  • --configfile <FILE>

    NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är minimal. Mer information finns i LoggerVerbosity.

source

Lägger till en betrodd undertecknare baserat på en viss paketkälla.

Sammanfattning

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

Arguments

  • NAME

    Namnet på den betrodda undertecknaren som ska läggas till. Om endast <NAME> tillhandahålls utan --<source-url>läggs paketkällan från NuGet-konfigurationsfilerna med samma namn till i den betrodda listan. Om <NAME> det redan finns i konfigurationen läggs paketkällan till.

Options:

  • --configfile <FILE>

    NuGet-konfigurationsfilen (nuget.config) som ska användas. Om det anges används endast inställningarna från den här filen. Om det inte anges används hierarkin för konfigurationsfiler från den aktuella katalogen. Mer information finns i Vanliga NuGet-konfigurationer.

  • -?|-h|--help

    Skriver ut en beskrivning av hur du använder kommandot.

  • --owners <LIST>

    Semikolonavgränsad lista över betrodda ägare för att ytterligare begränsa förtroendet för en lagringsplats.

  • --source-url

    Om en source-url anges måste det vara en v3-paketkäll-URL (till exempel https://api.nuget.org/v3/index.json). Andra typer av paketkällor stöds inte.

  • -v|--verbosity <LEVEL>

    Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är minimal. Mer information finns i LoggerVerbosity.

Examples

  • Lista betrodda undertecknare:

    dotnet nuget trust list

  • NuGet för betrodd källa i angiven nuget.config fil:

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

  • Lita på en författare från den signerade nupkg-paketfilen foo.nupkg:

    dotnet nuget trust author PackageAuthor .\foo.nupkg

  • Lita på en lagringsplats från den signerade nupkg-paketfilen foo.nupkg:

    dotnet nuget trust repository PackageRepository .\foo.nupkg

  • Lita på ett paketsigneringscertifikat med dess SHA256-fingeravtryck:

      dotnet nuget trust certificate MyCert  F99EC8CDCE5642B380296A19E22FA8EB3AEF1C70079541A2B3D6E4A93F5E1AFD --algorithm SHA256

  • Betrodda ägare Nuget och Microsoft från lagringsplatsen https://api.nuget.org/v3/index.json:

      dotnet nuget trust source NuGetTrust --source-url https://api.nuget.org/v3/index.json --owners "Nuget;Microsoft"

  • Ta bort betrodd undertecknare med namnet NuGet från angiven nuget.config fil:

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