本文適用於:✔️.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 平台儲存密碼,請用 .
--passwordWarning
盡量避免使用明文密碼。 限制存取包含密碼的設定檔,且不要將密碼或私鑰提交給原始碼控制。
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
每個範例都會為同一來源添加一個配置。 在嘗試其他範例之前,先移除現有的設定。