dotnet nuget add client-cert

本文適用於:✔️.NET Core 3.1.400 SDK 及後續版本

Name

dotnet nuget add client-cert - 為 NuGet 套件來源新增用戶端憑證設定。

Synopsis

dotnet nuget add client-cert --package-source <SOURCE_NAME>
    --path <CERTIFICATE_PATH> [--password <PASSWORD>]
    [--store-password-in-clear-text] --configfile <FILE> [-f|--force]

dotnet nuget add client-cert --package-source <SOURCE_NAME>
    --find-value <VALUE> [--find-by <FIND_TYPE>]
    [--store-location <LOCATION>] [--store-name <STORE_NAME>]
    [--configfile <FILE>] [-f|--force]

dotnet nuget add client-cert -h|--help

Description

這個 dotnet nuget add client-cert 指令會在你的 NuGet 設定檔區塊中新增一個客戶端憑證設定 clientCertificates 。 使用用戶端憑證來驗證需要用戶端憑證認證的 HTTPS 套件來源。

首先,用 dotnet nuget add source 配置套件來源。 接著,將憑證與來源名稱關聯,而非網址。 選擇一個證書來源:

  • 檔案: 使用 --path 來指定一個包含憑證及其私鑰的 PKCS #12(.pfx 或 .p12)檔案。 請指定 --configfile 何時從檔案新增憑證。
  • 憑證儲存: 請使用 --find-value 憑證商店選擇憑證。 預設情況下,NuGet 會依照目前使用者My個人()商店的指紋來搜尋。

不要將檔案選項(--path和--password)與儲存選項(--store-location、--store-name--find-by和--find-value)合併。 憑證儲存庫的可用性取決於你的作業系統。

每個套件來源只能有一個用戶端憑證設定。 如果來源已有設定,指令會失敗。 要更改現有設定,請使用 dotnet nuget update client-cert。

除非你特別指定 --force,NuGet 會先檢查它能找到並載入憑證,然後才儲存設定。 這個指令不會測試與套件來源的認證。

選項

  • --configfile <FILE>

    要使用的 NuGet 組態檔 (nuget.config)。 若已指定,僅會使用此檔案中的設定。 若未指定,則將使用當前目錄中組態檔的階層。 如需詳細資訊,請參閱常見的 NuGet 組態。

    新增檔案憑證時必須。

  • --find-by <FIND_TYPE>

    憑證儲存搜尋方法。 預設為 Thumbprint。 數值不區分大小寫。 使用不含FindBy前綴的 X.509 尋得型。 例如,使用 SubjectName,而不是 FindBySubjectName。

    請使用以下其中一個值:Thumbprint, SubjectName, KeyUsageExtensionCertificatePolicySubjectDistinguishedNameTemplateNameIssuerNameIssuerDistinguishedNameSerialNumberApplicationPolicy。SubjectKeyIdentifier

  • --find-value <VALUE>

    在憑證儲存庫中搜尋的值,例如憑證的拇指或主題名稱。 憑證儲存配置所必需。

  • -f|--force

    即使 NuGet 找不到或載入憑證,也能保存設定檔。 使用此選項在憑證尚未開放前設定。 這個選項不會停用 HTTPS 伺服器的憑證驗證。

  • -?|-h|--help

    輸出有關如何使用命令的說明。

  • -s|--package-source <SOURCE_NAME>

    要與憑證關聯的套件來源名稱,依 packageSources 照你的 NuGet 設定章節定義。 Required. 請指定來源名稱,而非網址。

  • --password <PASSWORD>

    如果需要,請提供憑證檔案的密碼。 只能用檔案設定。 預設情況下,NuGet 會在儲存密碼前加密密碼。

    Note

    密碼加密僅支援 Windows。 只有同一台電腦上的同一個使用者才能解密密碼。

  • --path <CERTIFICATE_PATH>

    通往憑證檔案的路徑。 檔案配置所需。

    要選擇特定檔案,請使用絕對路徑。 對於相對路徑,NuGet 會先檢查目前的工作目錄。 如果檔案不在,NuGet 會檢查相對於包含 NuGet 設定檔的目錄的路徑。

  • --store-location <LOCATION>

    憑證儲存地點: CurrentUser 或 LocalMachine。 預設為 CurrentUser。

  • --store-name <STORE_NAME>

    證書商店名稱。 公認的值為 AddressBook、 AuthRoot、 CertificateAuthorityTrustedPublisherDisallowedMyRootTrustedPeople和 。 預設為 My個人憑證儲存庫。

  • --store-password-in-clear-text

    儲存憑證檔案密碼時沒有加密。 若要在非 Windows 平台儲存密碼,請用 .--password

    Warning

    盡量避免使用明文密碼。 限制存取包含密碼的設定檔,且不要將密碼或私鑰提交給原始碼控制。

Examples

在執行這些範例之前,先設定一個命名 Contoso 為 的 nuget.config 套件來源,並取得該來源的用戶端憑證。

  • 從沒有密碼的檔案新增憑證:

    dotnet nuget add client-cert --package-source Contoso --path .\client.pfx --configfile .\nuget.config
    
  • 在 Windows 上新增一個有密碼保護的憑證檔案。 請用檔案的密碼替換 <CERTIFICATE_PASSWORD> :

    dotnet nuget add client-cert --package-source Contoso --path .\client.pfx --password <CERTIFICATE_PASSWORD> --configfile .\nuget.config
    
  • 從目前使用者的個人商店新增憑證。 請用證書的指紋替換 <CERTIFICATE_THUMBPRINT> :

    dotnet nuget add client-cert --package-source Contoso --find-value <CERTIFICATE_THUMBPRINT> --configfile .\nuget.config
    
  • 從目前使用者的個人商店依主題名稱新增憑證:

    dotnet nuget add client-cert --package-source Contoso --store-location CurrentUser --store-name My --find-by SubjectName --find-value "Contoso NuGet client" --configfile .\nuget.config
    

每個範例都會為同一來源添加一個配置。 在嘗試其他範例之前,先移除現有的設定。

也請參閱