dotnetup 如何驗證下載內容

Note

dotnetup 目前處於公開預覽階段。 其特性與行為可能會在正式上市前改變。

dotnetup在解壓縮之前驗證其下載的 .NET SDK 與執行階段。 驗證的類型取決於建置的來源。

已發佈組建

對於已發佈的建置,dotnetup 使用一條信任鏈,從已簽署的發佈清單開始:

  1. dotnetup下載.NET的發行清單。 這些資訊清單包括發行索引,以及每個頻道的 releases.json 檔案。
  2. dotnetup 驗證每個清單的分離代碼簽名(.p7s 檔案)。 如果簽章遺失或無效,指令就會失敗。
  3. 已驗證的清單包含每個封存檔的 SHA-512 雜湊值。
  4. dotnetup 下載檔案庫,並將其 SHA-512 雜湊值與清單中的雜湊值比較。 如果雜湊值不匹配,指令就會失敗,而且 dotnetup 不會解壓縮封存檔。

因為簽署清單會固定每個檔案庫的雜湊值,dotnetup 不會驗證每個檔案庫的獨立簽名。

簽名驗證也會在線上查詢憑證撤銷狀態。 允許存取所需的憑證撤銷端點。 若網路阻擋這些檢查,驗證就會失敗,並停止安裝,即使簽章有效。

資訊清單到期

發行資訊清單包含有效期限。 dotnetup 檢查清單是否已過期,即使其簽名和歸檔雜湊值有效。 同時也會檢查清單是否在到期前簽署。

系統時鐘錯誤或清單過期可能導致驗證失敗。 如需復原指引,請參閱 「版本資訊清單已過期」。

信任的憑證

對於清單簽名及其時間戳,則 dotnetup 使用工具內建的受信任根憑證。 它不會把作業系統信任儲存庫中的憑證加入那些受信任的根憑證。

將憑證加入作業系統的信任儲存庫,並不會讓 dotnetup 信任來自該憑證鏈的發佈資訊清單簽章。 簽名必須符合 dotnetup 的驗證政策,並鏈結至隨附的受信任根憑證。

每日與未列出的預先發行組建

每日版本和未在簽署發行清單中的預發布版本,則來自不同的訂閱源。 這些建置有 SHA-512 雜湊檔,但沒有程式碼簽章。 對於這些建置,dotnetup 只會驗證 SHA-512 雜湊值。

dotnetup 在您安裝時會使用此路徑:

  • 一個每日頻道,例如 daily 或 10.0-daily。
  • 不在發行資訊清單中的完全指定預發布版本,例如 10.0.100-preview.4.25216.37。

安裝開始前, dotnetup 會顯示以下警告:

⚠ Daily builds are not code-signed. Only the SHA-512 hash is verified.

欲了解更多每日建置資訊,請參閱 使用預覽與每日建置。

封鎖未簽名下載

管理員可以阻止安裝未經程式碼簽署的建置檔。 此政策生效時,dotnetup 仍會安裝已發佈版本,但每日版及未公開的預發布版本會安裝失敗。

Windows 作業系統

在 HKLM\SOFTWARE\Policies\Microsoft\dotnet\Dotnetup 下建立 BlockUnsignedDownloads 註冊表值,類型為 REG_DWORD,且其值為非零。 例如,在提高權限的 PowerShell 工作階段中執行以下命令:

$key = 'HKLM:\SOFTWARE\Policies\Microsoft\dotnet\Dotnetup'
New-Item -Path $key -Force | Out-Null
New-ItemProperty -Path $key -Name 'BlockUnsignedDownloads' -PropertyType DWord -Value 1 -Force | Out-Null

要清除政策,請刪除該值或將其設為 0。

Linux 與 macOS

建立 /etc/dotnet/dnup-block-unsigned-downloads 檔案。 檔案內容並不重要。 例如:

sudo mkdir -p /etc/dotnet
sudo touch /etc/dotnet/dnup-block-unsigned-downloads

要清除原則設定,請刪除該檔案。

已遭封鎖的安裝

當該政策阻擋安裝時, dotnetup 會顯示類似以下訊息的錯誤:

An IT policy on this machine requires code-signed downloads. Installing daily or unsigned prerelease builds of SDK <version> is blocked. Choose a released version, or have an administrator clear the policy ...

若要繼續,請安裝已發布的版本,或請管理員清除該原則。

dotnetup 執行檔

下載 get-dotnetup 腳本會用 SHA-512 校驗檔驗證已下載的 dotnetup 執行檔。 欲了解更多資訊,請參閱 開始使用 dotnetup。

dotnetup self update 同時驗證下載執行檔的 SHA-512 校驗碼。 在 Windows 上,若已安裝的執行檔已採用 Authenticode 簽署,則該替換檔也必須具有採用由 Microsoft 信任的根憑證之 Authenticode 簽章。 其他平台和未簽署的 Windows 安裝則依賴校驗碼。

自我更新目前使用未簽名的 blob feed,而非先前描述的已簽署 .NET 發佈清單。 未簽名下載政策也會阻擋此來源的自我更新。

替換後,dotnetup 會使用 --version 執行新的執行檔,並檢查其版本是否與已解析的發行版本相符。 若此檢查失敗,dotnetup 嘗試還原先前的執行檔。 這個啟動檢查並不會驗證該下載項目。

也請參閱