安全 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,buildTransitivebuildMultitargeting除非analyzers显式选择退出,否则资产将被自动插入(如此在生成期间自动执行)。

只要不需要引用包中的生成或编译器扩展逻辑(甚至更好,只要需要生成逻辑)IncludeAssets即可使用ExcludeAssets。

请确保熟悉 NuGet 团队的当前文档和指南。 PackageReference请参阅项目文件中的文档作为此问题的权威来源。

了解并查看生成开始脚本/过程

生成逻辑可能会受到命令行参数或环境变量的影响,尤其是可能导致插件注入(例如自定义记录器)或生成逻辑(例如,在内 MSBuildUserExtensionsPath生成脚本)的生成逻辑。 确保知道哪些命令行参数和环境变量应用于 MSBuild 进程。 这样,就可以更好地了解生成逻辑的受影响方式。

使用专用用户帐户和会话运行生成

请勿在同一系统上使用的帐户下运行,以便以前运行未知进程或脚本,包括不同的生成。 尤其是在同一用户帐户下不相关的生成可能在不完全受信任且未知的源上运行。

MSBuild 可以从用户配置文件的各个位置(特别是 MSBuild SDK 自动包括 MSBuildUserExtensionsPath 位置中的生成逻辑),也可以从环境变量可注入的位置(可以使用同名的 MSBuild 属性进行自定义 MSBuildUserExtensionsPath )。此类属性没有默认值,因此可以从具有相同名称的环境变量中获取该值。

注释

作为实现详细信息,MSBuild 通过命名管道和互斥体查找并与其持久进程通信。 在Windows,这些命名管道和互斥体共享计算机范围的命名空间。 因此,另一个本地帐户下的进程可以占用这些名称,并阻止生成创建它们。 这种情况仅涉及可用性(拒绝服务)。 OS 访问控制仍会阻止另一个帐户读取或更改生成。 首选信任所有本地帐户的计算机,或隔离的会话、容器或 VM。