Sdílet prostřednictvím


dotnet nuget trust (důvěra)

Tento článek se vztahuje na: ✔️ .NET 6 SDK a novější verze

Název

dotnet nuget trust – Získá nebo nastaví důvěryhodné podepisující osoby na konfiguraci NuGet.

Přehled

dotnet nuget trust [command] [Options]

dotnet nuget trust -h|--help

Description

Příkaz dotnet nuget trust spravuje důvěryhodné podepisující osoby. Ve výchozím nastavení přijímá NuGet všechny autory a úložiště. Tyto příkazy umožňují zadat pouze určitou podmnožinu podepisujících osob, jejichž podpisy budou přijaty, a zároveň zamítnout všechny ostatní. Další informace najdete v tématu Běžné konfigurace NuGet. Podrobnosti o tom, jak schéma nuget.config vypadá, najdete v referenčních informacích ke konfiguračnímu souboru NuGet.

Poznámka:

Tento příkaz vyžaduje kořenové úložiště certifikátů, které je platné pro podepisování kódu i časové razítko. Tento příkaz také nemusí být podporován v některých kombinacích operačního systému a sady .NET SDK. Další informace najdete v tématu Ověření podepsaného balíčku NuGet.

Možnosti

  • -?|-h|--helpVytiskne popis použití příkazu.

Commands

Pokud není zadán žádný příkaz, příkaz se ve výchozím nastavení nastaví na listhodnotu .

list

Zobrazí seznam všech důvěryhodných podepisujících uživatelů v konfiguraci. Tato možnost bude obsahovat všechny certifikáty (s algoritmem otisku prstu a otisku prstu), které má každý podepisující uživatel. Pokud má certifikát předchozí [U], znamená to, že položka certifikátu povoluje HodnotuUntrustedRoot nastavenou na hodnotu true.

Přehled:

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

Options:

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu běžné konfigurace NuGet.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Výchozí hodnota je minimal. Další informace najdete v tématu LoggerVerbosity.

sync

Odstraní aktuální seznam certifikátů a nahradí je seznamem up-to-date z úložiště.

Přehled

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

Arguments

  • NAME

    Název existujícího důvěryhodného podepisujícího podpisu, který se má synchronizovat.

Options:

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu běžné konfigurace NuGet.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Výchozí hodnota je minimal. Další informace najdete v tématu LoggerVerbosity.

remove

Odebere všechny důvěryhodné podepisující osoby, které odpovídají danému jménu.

Přehled

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

Arguments

  • NAME

    Název existujícího důvěryhodného podepisujícího uživatele, který chcete odebrat.

Options:

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu běžné konfigurace NuGet.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Výchozí hodnota je minimal. Další informace najdete v tématu LoggerVerbosity.

author

Přidá důvěryhodného podepisujícího uživatele s daným jménem na základě podpisu autora balíčku.

Přehled

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

Arguments

  • NAME

    Název důvěryhodného podepisujícího uživatele, který chcete přidat. Pokud NAME už v konfiguraci existuje, připojí se podpis.

  • PACKAGE

    Daná PACKAGE hodnota by měla být místní cesta k podepsanému souboru .nupkg .

Options:

  • --allow-untrusted-root

    Určuje, jestli má být certifikát důvěryhodného podepisujícího oprávněn zřetězen do nedůvěryhodného kořenového adresáře. Toto se nedoporučuje.

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu běžné konfigurace NuGet.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Výchozí hodnota je minimal. Další informace najdete v tématu LoggerVerbosity.

repository

Přidá důvěryhodný podepisující znak s daným názvem na základě podpisu úložiště nebo čítače podepsaného balíčku.

Přehled

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

Arguments

  • NAME

    Název důvěryhodného podepisujícího uživatele, který chcete přidat. Pokud NAME už v konfiguraci existuje, připojí se podpis.

  • PACKAGE

    Daná PACKAGE hodnota by měla být místní cesta k podepsanému souboru .nupkg .

Options:

  • --allow-untrusted-root

    Určuje, jestli má být certifikát důvěryhodného podepisujícího oprávněn zřetězen do nedůvěryhodného kořenového adresáře. Toto se nedoporučuje.

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu běžné konfigurace NuGet.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • --owners <LIST>

    Seznam důvěryhodných vlastníků oddělený středníkem pro další omezení důvěryhodnosti úložiště.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Výchozí hodnota je minimal. Další informace najdete v tématu LoggerVerbosity.

certificate

Přidá důvěryhodného podepisujícího uživatele s daným jménem na základě otisku prstu certifikátu.

Přehled

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

Arguments

  • NAME

    Název důvěryhodného podepisujícího uživatele, který chcete přidat. Pokud důvěryhodný podepisující znak s daným názvem již existuje, položka certifikátu se do této podepisující osoby přidá. V opačném případě se vytvoří důvěryhodný autor s položkou certifikátu z informací o daném certifikátu.

  • FINGERPRINT

    Otisk certifikátu.

Options:

  • --algorithm <ALGORITHM>

    Určuje hashovací algoritmus použitý k výpočtu otisku prstu certifikátu. Výchozí hodnota je SHA256. Podporované jsou hodnoty SHA256, SHA384 a SHA512.

  • --allow-untrusted-root

    Určuje, jestli má být certifikát důvěryhodného podepisujícího oprávněn zřetězen do nedůvěryhodného kořenového adresáře. Toto se nedoporučuje.

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu běžné konfigurace NuGet.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Výchozí hodnota je minimal. Další informace najdete v tématu LoggerVerbosity.

source

Přidá důvěryhodný podepisující znak na základě daného zdroje balíčku.

Přehled

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

Arguments

  • NAME

    Název důvěryhodného podepisujícího uživatele, který chcete přidat. Pokud je k dispozici pouze <NAME> bez --<source-url>, zdroj balíčku z konfiguračních souborů NuGet se stejným názvem se přidá do důvěryhodného seznamu. Pokud <NAME> už v konfiguraci existuje, zdroj balíčku se k němu připojí.

Options:

  • --configfile <FILE>

    Konfigurační soubor NuGet (nuget.config), který se má použít. Pokud je zadáno, použijí se pouze nastavení z tohoto souboru. Pokud není zadáno, použije se hierarchie konfiguračních souborů z aktuálního adresáře. Další informace najdete v tématu běžné konfigurace NuGet.

  • -?|-h|--help

    Vytiskne popis použití příkazu.

  • --owners <LIST>

    Seznam důvěryhodných vlastníků oddělený středníkem pro další omezení důvěryhodnosti úložiště.

  • --source-url

    source-url Pokud je k dispozici, musí se jednat o zdrojovou adresu URL balíčku v3 (například https://api.nuget.org/v3/index.json). Jiné typy zdrojů balíčků nejsou podporovány.

  • -v|--verbosity <LEVEL>

    Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], , m[inimal]n[ormal], d[etailed]a diag[nostic]. Výchozí hodnota je minimal. Další informace najdete v tématu LoggerVerbosity.

Examples

  • Vypsat důvěryhodné podepisující osoby:

    dotnet nuget trust list
    
  • Důvěřovat zdrojovému NuGetu v zadaném souborunuget.config :

    dotnet nuget trust source NuGet --configfile ..\nuget.config
    
  • Důvěřovat autorovi ze podepsaného souboru balíčku nupkg foo.nupkg:

    dotnet nuget trust author PackageAuthor .\foo.nupkg
    
  • Důvěřovat úložišti ze souboru podepsaného balíčku nupkg foo.nupkg:

    dotnet nuget trust repository PackageRepository .\foo.nupkg
    
  • Důvěřovat podpisovém certifikátu balíčku pomocí otisku prstu SHA256:

      dotnet nuget trust certificate MyCert  F99EC8CDCE5642B380296A19E22FA8EB3AEF1C70079541A2B3D6E4A93F5E1AFD --algorithm SHA256
    
  • Důvěřovat vlastníkům Nugetu a Microsoftu z úložiště https://api.nuget.org/v3/index.json:

      dotnet nuget trust source NuGetTrust --source-url https://api.nuget.org/v3/index.json --owners "Nuget;Microsoft"
    
  • Odeberte důvěryhodný podepisující znak NuGet ze zadaného souborunuget.config :

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