kepercayaan dotnet nuget

Artikel ini berlaku untuk: ✔️ .NET 6 SDK dan versi yang lebih baru

Nama

dotnet nuget trust - Mendapatkan atau mengatur penanda tangan tepercaya ke konfigurasi NuGet.

Sinopsis

dotnet nuget trust [command] [Options]

dotnet nuget trust -h|--help

Description

Perintah dotnet nuget trust mengelola penanda tangan tepercaya. Secara default, NuGet menerima semua penulis dan repositori. Perintah ini memungkinkan Anda untuk menentukan hanya subset penanda tangan tertentu yang tanda tangannya akan diterima, sambil menolak semua yang lain. Untuk informasi selengkapnya, lihat Konfigurasi NuGet umum. Untuk detail tentang seperti apa skema nuget.config, lihat referensi file konfigurasi NuGet.

Nota

Perintah ini memerlukan penyimpanan akar sertifikat yang valid untuk penandatanganan kode dan tanda waktu. Selain itu, perintah ini mungkin tidak didukung pada beberapa kombinasi sistem operasi dan .NET SDK. Untuk informasi selengkapnya, lihat Verifikasi paket yang ditandatangani NuGet.

Opsi

  • -?|-h|--helpMencetak deskripsi cara menggunakan perintah.

Commands

Jika tidak ada perintah yang ditentukan, perintah akan default ke list.

list

Mencantumkan semua penanda tangan tepercaya dalam konfigurasi. Opsi ini akan mencakup semua sertifikat (dengan algoritma sidik jari dan sidik jari) yang dimiliki setiap penanda tangan. Jika sertifikat memiliki [U] sebelumnya, artinya entri sertifikat telah mengizinkanUntrustedRoot ditetapkan sebagai true.

Sinopsis:

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

Options:

  • --configfile <FILE>

    File konfigurasi NuGet (nuget.config) untuk digunakan. Jika ditentukan, hanya pengaturan dari file ini yang akan digunakan. Jika tidak ditentukan, hierarki file konfigurasi dari direktori saat ini akan digunakan. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Defaultnya adalah minimal. Untuk informasi selengkapnya, lihat LoggerVerbosity .

sync

Menghapus daftar sertifikat saat ini dan menggantinya dengan daftar up-to-date dari repositori.

Sinopsis

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

Arguments

  • NAME

    Nama penanda tangan tepercaya yang ada untuk disinkronkan.

Options:

  • --configfile <FILE>

    File konfigurasi NuGet (nuget.config) untuk digunakan. Jika ditentukan, hanya pengaturan dari file ini yang akan digunakan. Jika tidak ditentukan, hierarki file konfigurasi dari direktori saat ini akan digunakan. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Defaultnya adalah minimal. Untuk informasi selengkapnya, lihat LoggerVerbosity .

remove

Menghapus penanda tangan tepercaya yang cocok dengan nama yang diberikan.

Sinopsis

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

Arguments

  • NAME

    Nama penanda tangan tepercaya yang ada untuk dihapus.

Options:

  • --configfile <FILE>

    File konfigurasi NuGet (nuget.config) untuk digunakan. Jika ditentukan, hanya pengaturan dari file ini yang akan digunakan. Jika tidak ditentukan, hierarki file konfigurasi dari direktori saat ini akan digunakan. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Defaultnya adalah minimal. Untuk informasi selengkapnya, lihat LoggerVerbosity .

author

Menambahkan penanda tangan tepercaya dengan nama yang diberikan, berdasarkan tanda tangan penulis paket.

Sinopsis

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

Arguments

  • NAME

    Nama penanda tangan tepercaya yang akan ditambahkan. Jika NAME sudah ada dalam konfigurasi, tanda tangan ditambahkan.

  • PACKAGE

    Yang diberikan PACKAGE harus berupa jalur lokal ke file .nupkg yang ditandatangani.

Options:

  • --allow-untrusted-root

    Menentukan apakah sertifikat untuk penanda tangan tepercaya harus diizinkan untuk menautkan ke akar yang tidak tepercaya. Ini tidak disarankan.

  • --configfile <FILE>

    File konfigurasi NuGet (nuget.config) untuk digunakan. Jika ditentukan, hanya pengaturan dari file ini yang akan digunakan. Jika tidak ditentukan, hierarki file konfigurasi dari direktori saat ini akan digunakan. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Defaultnya adalah minimal. Untuk informasi selengkapnya, lihat LoggerVerbosity .

repository

Menambahkan penanda tangan tepercaya dengan nama yang diberikan, berdasarkan tanda tangan repositori atau countersignature paket yang ditandatangani.

Sinopsis

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

Arguments

  • NAME

    Nama penanda tangan tepercaya yang akan ditambahkan. Jika NAME sudah ada dalam konfigurasi, tanda tangan ditambahkan.

  • PACKAGE

    Yang diberikan PACKAGE harus berupa jalur lokal ke file .nupkg yang ditandatangani.

Options:

  • --allow-untrusted-root

    Menentukan apakah sertifikat untuk penanda tangan tepercaya harus diizinkan untuk menautkan ke akar yang tidak tepercaya. Ini tidak disarankan.

  • --configfile <FILE>

    File konfigurasi NuGet (nuget.config) untuk digunakan. Jika ditentukan, hanya pengaturan dari file ini yang akan digunakan. Jika tidak ditentukan, hierarki file konfigurasi dari direktori saat ini akan digunakan. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • --owners <LIST>

    Daftar pemilik tepercaya yang dipisahkan titik koma untuk lebih membatasi kepercayaan repositori.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Defaultnya adalah minimal. Untuk informasi selengkapnya, lihat LoggerVerbosity .

certificate

Menambahkan penanda tangan tepercaya dengan nama yang diberikan, berdasarkan sidik jari sertifikat.

Sinopsis

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

Arguments

  • NAME

    Nama penanda tangan tepercaya yang akan ditambahkan. Jika penanda tangan tepercaya dengan nama yang diberikan sudah ada, item sertifikat ditambahkan ke penanda tangan tersebut. Jika tidak, penulis tepercaya dibuat dengan item sertifikat dari informasi sertifikat yang diberikan.

  • FINGERPRINT

    Sidik jari sertifikat.

Options:

  • --algorithm <ALGORITHM>

    Menentukan algoritma hash yang digunakan untuk menghitung sidik jari sertifikat. Default ke SHA256. Nilai yang didukung adalah SHA256, SHA384, dan SHA512.

  • --allow-untrusted-root

    Menentukan apakah sertifikat untuk penanda tangan tepercaya harus diizinkan untuk menautkan ke akar yang tidak tepercaya. Ini tidak disarankan.

  • --configfile <FILE>

    File konfigurasi NuGet (nuget.config) untuk digunakan. Jika ditentukan, hanya pengaturan dari file ini yang akan digunakan. Jika tidak ditentukan, hierarki file konfigurasi dari direktori saat ini akan digunakan. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Defaultnya adalah minimal. Untuk informasi selengkapnya, lihat LoggerVerbosity .

source

Menambahkan penanda tangan tepercaya berdasarkan sumber paket tertentu.

Sinopsis

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

Arguments

  • NAME

    Nama penanda tangan tepercaya yang akan ditambahkan. Jika hanya <NAME> disediakan tanpa --<source-url>, sumber paket dari file konfigurasi NuGet Anda dengan nama yang sama ditambahkan ke daftar tepercaya. Jika <NAME> sudah ada dalam konfigurasi, sumber paket ditambahkan ke konfigurasi tersebut.

Options:

  • --configfile <FILE>

    File konfigurasi NuGet (nuget.config) untuk digunakan. Jika ditentukan, hanya pengaturan dari file ini yang akan digunakan. Jika tidak ditentukan, hierarki file konfigurasi dari direktori saat ini akan digunakan. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • --owners <LIST>

    Daftar pemilik tepercaya yang dipisahkan titik koma untuk lebih membatasi kepercayaan repositori.

  • --source-url

    source-url Jika disediakan, url sumber paket v3 harus berupa URL sumber paket v3 (seperti https://api.nuget.org/v3/index.json). Jenis sumber paket lainnya tidak didukung.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], d[etailed], dan diag[nostic]. Defaultnya adalah minimal. Untuk informasi selengkapnya, lihat LoggerVerbosity .

Examples

  • Daftar penanda tangan tepercaya:

    dotnet nuget trust list
    
  • Sumber kepercayaan NuGet dalam file nuget.config yang ditentukan:

    dotnet nuget trust source NuGet --configfile ..\nuget.config
    
  • Percayai penulis dari file paket nupkg yang ditandatangani foo.nupkg:

    dotnet nuget trust author PackageAuthor .\foo.nupkg
    
  • Percayai repositori dari file paket nupkg yang ditandatangani foo.nupkg:

    dotnet nuget trust repository PackageRepository .\foo.nupkg
    
  • Percayai sertifikat penandatanganan paket menggunakan sidik jari SHA256-nya:

      dotnet nuget trust certificate MyCert  F99EC8CDCE5642B380296A19E22FA8EB3AEF1C70079541A2B3D6E4A93F5E1AFD --algorithm SHA256
    
  • Percayai pemilik Nuget dan Microsoft dari repositori https://api.nuget.org/v3/index.json:

      dotnet nuget trust source NuGetTrust --source-url https://api.nuget.org/v3/index.json --owners "Nuget;Microsoft"
    
  • Hapus penanda tangan tepercaya bernama NuGet dari file nuget.config tertentu:

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