Aracılığıyla paylaş

dotnet nuget güveni

Bu makale şunlar için geçerlidir: ✔️ .NET 5.0.300 SDK ve sonraki sürümleri

Adı

dotnet nuget trust - Güvenilir imzalayanları NuGet yapılandırmasına alır veya ayarlar.

Özet

dotnet nuget trust [command] [Options]

dotnet nuget trust -h|--help

Açıklama

dotnet nuget trust komutu, güvenilir imzalayanları yönetir. NuGet varsayılan olarak tüm yazarları ve depoları kabul eder. Bu komutlar, imzaları kabul edilecek imzalayanların yalnızca belirli bir alt kümesini belirtmenize ve diğer tüm imzaları reddetmenize olanak sağlar. Daha fazla bilgi için bkz . Yaygın NuGet yapılandırmaları. nuget.config şemasının nasıl göründüğü hakkında ayrıntılı bilgi için NuGet yapılandırma dosyası başvurusuna bakın.

Not

Bu komut hem kod imzalama hem de zaman damgası için geçerli bir sertifika kök deposu gerektirir. Ayrıca, bu komut bazı işletim sistemi ve .NET SDK bileşimlerinde desteklenmeyebilir. Daha fazla bilgi için bkz . NuGet imzalı paket doğrulama.

Seçenekler

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

Komutlar

Herhangi bir komut belirtilmezse, komut varsayılan olarak olur list.

list

Yapılandırmadaki tüm güvenilir imzalayanları listeler. Bu seçenek, her imzalayanın sahip olduğu tüm sertifikaları (parmak izi ve parmak izi algoritmasıyla) içerir. Bir sertifikanın [U] öncesinde olması, sertifika girdisinde allowUntrustedRoot değerinin true olarak ayarlandığı anlamına gelir.

Özet:

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

Seçenekler:

  • --configfile <FILE>

    Kullanılacak NuGet yapılandırma dosyası (nuget.config). Belirtilirse, yalnızca bu dosyadaki ayarlar kullanılır. Belirtilmezse, geçerli dizindeki yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz . Yaygın NuGet Yapılandırmaları.

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. Varsayılan değer: minimal. Daha fazla bilgi için bkz. LoggerVerbosity.

sync

Geçerli sertifika listesini siler ve depodan güncel bir listeyle değiştirir.

Özet

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

Bağımsız değişkenler

  • NAME

    Eşitlenecek mevcut güvenilir imzalayanın adı.

Seçenekler:

  • --configfile <FILE>

    Kullanılacak NuGet yapılandırma dosyası (nuget.config). Belirtilirse, yalnızca bu dosyadaki ayarlar kullanılır. Belirtilmezse, geçerli dizindeki yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz . Yaygın NuGet Yapılandırmaları.

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. Varsayılan değer: minimal. Daha fazla bilgi için bkz. LoggerVerbosity.

remove

Verilen adla eşleşen tüm güvenilen imzalayanları kaldırır.

Özet

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

Bağımsız değişkenler

  • NAME

    Kaldırılacak mevcut güvenilir imzalayanın adı.

Seçenekler:

  • --configfile <FILE>

    Kullanılacak NuGet yapılandırma dosyası (nuget.config). Belirtilirse, yalnızca bu dosyadaki ayarlar kullanılır. Belirtilmezse, geçerli dizindeki yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz . Yaygın NuGet Yapılandırmaları.

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. Varsayılan değer: minimal. Daha fazla bilgi için bkz. LoggerVerbosity.

author

Paketin yazar imzasını temel alarak verilen ada sahip güvenilir bir imzalayan ekler.

Özet

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

Bağımsız değişkenler

  • NAME

    Eklenecek güvenilir imzalayanın adı. Yapılandırmada zaten varsa NAME , imza eklenir.

  • PACKAGE

    Verilen PACKAGE , imzalı .nupkg dosyasının yerel yolu olmalıdır.

Seçenekler:

  • --allow-untrusted-root

    Güvenilen imzalayanın sertifikasının güvenilmeyen bir köke zincirlemesine izin verilip verilmediğini belirtir. Bu önerilmez.

  • --configfile <FILE>

    Kullanılacak NuGet yapılandırma dosyası (nuget.config). Belirtilirse, yalnızca bu dosyadaki ayarlar kullanılır. Belirtilmezse, geçerli dizindeki yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz . Yaygın NuGet Yapılandırmaları.

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. Varsayılan değer: minimal. Daha fazla bilgi için bkz. LoggerVerbosity.

repository

İmzalı bir paketin depo imzasına veya karşı imzasına göre verilen ada sahip güvenilir bir imzalayan ekler.

Özet

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

Bağımsız değişkenler

  • NAME

    Eklenecek güvenilir imzalayanın adı. Yapılandırmada zaten varsa NAME , imza eklenir.

  • PACKAGE

    Verilen PACKAGE , imzalı .nupkg dosyasının yerel yolu olmalıdır.

Seçenekler:

  • --allow-untrusted-root

    Güvenilen imzalayanın sertifikasının güvenilmeyen bir köke zincirlemesine izin verilip verilmediğini belirtir. Bu önerilmez.

  • --configfile <FILE>

    Kullanılacak NuGet yapılandırma dosyası (nuget.config). Belirtilirse, yalnızca bu dosyadaki ayarlar kullanılır. Belirtilmezse, geçerli dizindeki yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz . Yaygın NuGet Yapılandırmaları.

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • --owners <LIST>

    Bir deponun güvenini daha da kısıtlamak için güvenilir sahiplerin noktalı virgülle ayrılmış listesi.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. Varsayılan değer: minimal. Daha fazla bilgi için bkz. LoggerVerbosity.

certificate

Sertifika parmak izini temel alarak verilen ada sahip güvenilir bir imzalayan ekler.

Özet

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

Bağımsız değişkenler

  • NAME

    Eklenecek güvenilir imzalayanın adı. Belirtilen ada sahip güvenilir bir imzalayan zaten varsa, sertifika öğesi bu imzalayana eklenir. Aksi takdirde, verilen sertifika bilgilerinden bir sertifika öğesiyle güvenilen bir yazar oluşturulur.

  • FINGERPRINT

    Sertifikanın parmak izi.

Seçenekler:

  • --algorithm <ALGORITHM>

    Sertifika parmak izini hesaplamak için kullanılan karma algoritmayı belirtir. Varsayılan olarak SHA256'dır. Desteklenen değerler SHA256, SHA384 ve SHA512'dir.

  • --allow-untrusted-root

    Güvenilen imzalayanın sertifikasının güvenilmeyen bir köke zincirlemesine izin verilip verilmediğini belirtir. Bu önerilmez.

  • --configfile <FILE>

    Kullanılacak NuGet yapılandırma dosyası (nuget.config). Belirtilirse, yalnızca bu dosyadaki ayarlar kullanılır. Belirtilmezse, geçerli dizindeki yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz . Yaygın NuGet Yapılandırmaları.

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. Varsayılan değer: minimal. Daha fazla bilgi için bkz. LoggerVerbosity.

source

Belirli bir paket kaynağını temel alan güvenilir bir imzalayan ekler.

Özet

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

Bağımsız değişkenler

  • NAME

    Eklenecek güvenilir imzalayanın adı. Yalnızca <NAME> olmadan --<source-url>sağlanırsa, NuGet yapılandırma dosyalarınızdan aynı ada sahip paket kaynağı güvenilen listeye eklenir. Yapılandırmada zaten varsa <NAME> , paket kaynağı buna eklenir.

Seçenekler:

  • --configfile <FILE>

    Kullanılacak NuGet yapılandırma dosyası (nuget.config). Belirtilirse, yalnızca bu dosyadaki ayarlar kullanılır. Belirtilmezse, geçerli dizindeki yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz . Yaygın NuGet Yapılandırmaları.

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • --owners <LIST>

    Bir deponun güvenini daha da kısıtlamak için güvenilir sahiplerin noktalı virgülle ayrılmış listesi.

  • --source-url

    source-url sağlanmışsa, bir v3 paketi kaynak URL'si (gibihttps://api.nuget.org/v3/index.json) olmalıdır. Diğer paket kaynak türleri desteklenmez.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. Varsayılan değer: minimal. Daha fazla bilgi için bkz. LoggerVerbosity.

Örnekler

  • Güvenilir imzalayanları listeleme:

    dotnet nuget trust list

  • Belirtilen nuget.config dosyasında kaynak NuGet'e güven:

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

  • İmzalı nupkg paket dosyasından bir yazara güven foo.nupkg:

    dotnet nuget trust author PackageAuthor .\foo.nupkg

  • foo.nupkg imzalı nupkg paket dosyasından bir depoya güvenin:

    dotnet nuget trust repository PackageRepository .\foo.nupkg

  • SHA256 parmak izini kullanarak bir paket imzalama sertifikasına güvenin:

      dotnet nuget trust certificate MyCert  F99EC8CDCE5642B380296A19E22FA8EB3AEF1C70079541A2B3D6E4A93F5E1AFD --algorithm SHA256

  • Depodan https://api.nuget.org/v3/index.jsongüven sahipleri Nuget ve Microsoft:

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

  • Belirtilen nuget.config dosyasından NuGet adlı güvenilir imzalayanı kaldırın:

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