安全 MSBuild 使用最佳實務

MSBuild 高度可自訂且可擴充(詳情請參見 自訂你的建置 ),因此應特別注意環境與建置的正確配置。

限制對安裝地點的寫入存取

將 MSBuild(無論是使用 Visual Studio、.NET SDK 或獨立軟體)安裝到只有受信任使用者有寫入權限的位置。

你可以透過修改或新增放置在 MSBuild 執行檔旁邊的各種二進位和 XML 檔案,以及 MSBuild 執行檔的子資料夾來更改建置邏輯。 因此,只有受信任的使用者才應該被允許寫入該資料夾。

只在你熟悉且已複習過的資源上執行建構

只在你完全信任的來源上執行 MSBuild(用於建置和還原專案,也可以用 Visual Studio 開啟專案)。

MSBuild 邏輯可以在建置腳本檔案中擴充,包括你的專案檔案,因此未知建置邏輯應假設能在建置環境中執行任意程式碼。

請在經過驗證的專用地點執行你的建置

MSBuild 可以自動包含你專案或解決方案資料夾中的邏輯,以及任何父資料夾直到硬碟根目錄的邏輯。 這包括 .user 檔案、 [before|after].{solution}.targets 檔案、 Directory.Build.[props|targets|rsp] 檔案及其他。

確保只有授權使用者或帳號能寫入你建置相關檔案的位置,以及階層結構中任何資料夾,直到硬碟根目錄。

為了避免不小心包含 Directory.Build.[props|targets|rsp],你可以在來源根目錄中包含此類檔案。 該檔案可以是空的 MSBuild Project 元素。

了解並審查引用的包裹與原始訂閱源

建置邏輯可由 NuGet 套件自動擴充。 這些邏輯會在還原時執行,並包含在你的建置或編譯執行中。 務必熟悉 NuGet 套件的資產類型 及其在建置、編譯和執行時的角色。 具體來說, build這些 、 buildTransitive和 buildMultitargetinganalyzers 資產會自動插入(因此在建構過程中自動執行),除非它們被明確選擇退出。

ExcludeAssets只要不需要引用套件的建置或編譯器擴充邏輯(甚至更好,如果你想要的話,只IncludeAssets明確需要建置邏輯)。

務必熟悉 NuGet 團隊的最新文件與指引。 請參考 PackageReference 專案檔案中的 文件作為此問題的權威來源。

了解並檢視建構起始腳本/流程

建置邏輯可能受到命令列參數或環境變數的影響,尤其是那些可能導致外掛(例如自訂記錄器)或建置邏輯(例如建置腳本) MSBuildUserExtensionsPath注入的變數。 確保你知道 MSBuild 程序會套用哪些命令列參數和環境變數。 這樣你就能更了解建構邏輯會受到什麼影響。

使用專用的使用者帳號和會話來執行你的建置

不要用一個可能在同一系統上執行未知程序或腳本的帳號,包括不同的版本。 尤其是如果同一使用者帳號下無關的建置可能運行在不完全信任且不熟悉的來源上。

MSBuild 可以從使用者設定檔的不同位置取得邏輯(特別是 MSBuild SDK 自動包含位於 MSBuildUserExtensionsPath 位置的建置邏輯),或從可由環境變數注入的地點取得邏輯(你可以用同名的 MSBuild 屬性自訂 MSBuildUserExtensionsPath )。這個屬性沒有預設值,因此可以從同名的環境變數來源。

備註

作為實作細節,MSBuild 透過命名管線與互斥組織定位並與其持久程序通訊。 在 Windows 上,這些命名管線與互斥體共用一個全機器的命名空間。 所以,另一個本地帳號下的程序可以佔用這些名稱,阻止你的建構建立它們。 這種情況僅屬於可用性(拒絕服務)問題。 作業系統的存取控制仍然阻止其他帳號讀取或修改建置。 建議使用所有本地帳號都受信任的機器,或是隔離的會話、容器或虛擬機。