安全透明代码不应断言

更新:2007 年 11 月

TypeName

SecurityTransparentCodeShouldNotAssert

CheckId

CA2128

类别

Microsoft.Security

是否重大更改

原因

标为 SecurityTransparentAttribute 的代码未被授予足够的权限进行断言。

规则说明

此规则分析完全透明或混合透明/关键的程序集中的所有方法和类型,并标记 Assert 的任何声明性或命令性用法。

在运行时,从透明代码中对 Assert 进行任何调用都会导致引发 SecurityException。此种情况在完全透明的程序集以及混合透明/关键程序集(其中的某个方法或类型被声明为透明,但包括声明性或命令性 Assert)中都会发生这种情况。

.NET Framework 2.0 引入了一个称为“透明度”的功能。各个方法、字段、接口、类和类型都可以是透明或关键的。

不允许透明代码提升安全特权。因此,授予透明代码或其请求的任何权限都会自动通过该代码传递给调用方或主机应用程序域。提升的示例包括 Assert、LinkDemand、SuppressUnmanagedCode 和unsafe代码。

如何修复冲突

若要解决此问题,请将调用 Assert 的代码标记为 SecurityCritical,或者移除该 Assert。

何时禁止显示警告

不要禁止显示此规则发出的消息。

示例

当 Assert 方法引发 SecurityException 时,如果 SecurityTestClass 透明,此代码将失败。

using System;
using System.Security.Permissions;

namespace SecurityTestClassLibrary
{
    public class SecurityTestClass
    {
        // SecurityTransparent
        void SecurityTransparentMethod()
        {
            new FileIOPermission(PermissionState.Unrestricted).Assert();

            // perform I/O operations under Assert
        }
    }
}

一个方法是对 [SecurityTransparentMethod] 进行代码评审,如果 [SecurityTransparentMethod] 被视为可以安全提升,可以用 [SecurityCritical] 标记 [SecurityTransparentMethod]。这要求必须对 [SecurityTransparentMethod] 以及发生在 [SecurityTransparentMethod] 中 Assert 下的任何调出执行详细完整的、不包含错误的安全审核:

using System;
using System.Security.Permissions;

namespace SecurityTestClassLibrary
{
    public class SecurityTestClass
    {
        [System.Security.SecurityCritical]
        void SecurityCriticalMethod()
        {
            new FileIOPermission(PermissionState.Unrestricted).Assert();

            // perform I/O operations under Assert
        }
    }
}

另一个方法是从代码中移除 Assert,并使任何后续的文件 I/O 权限请求通过 [SecurityTransparentMethod] 流向调用方 - 从而发生安全检查。在此种情况下,一般不需要安全审核,因为权限请求将流向调用方和/或应用程序域。权限请求通过安全策略、宿主环境以及代码源权限授予进行严格的控制。

请参见

其他资源

安全警告