大网数据广告活动
.NET 与 C# 开发

安全透明代码,级别 1

· 52CE 我爱测

透明度可帮助开发人员编写更安全的 .NET Framework 库来向部分信任的代码公开功能。 .NET Framework 2.0 版中引入了 1 级透明度,此透明度主要仅供 Microsoft 内部使用。 从.NET Framework 4 开始,你可以使用2 级透明度。 但是,已保留 1 级透明度,以便可以确定必须使用以前的安全规则运行的旧代码。

Caution: 代码访问安全性和部分受信任的代码

.NET Framework 提供一种机制,对在相同应用程序中运行的不同代码强制实施不同的信任级别,该机制称为代码访问安全性 (CAS)。 .NET Framework 中的代码访问安全性不应用作基于代码来源或其他标识方面强制实施安全边界的一种机制。 我们正在更新相应指南以反映代码访问安全性,并且将不支持把安全透明代码用作部分受信任的代码(尤其是未知来源的代码)的安全边界。 建议在未实施其他安全措施的情况下,不要加载和执行未知来源的代码。

此策略适用于 .NET Framework 的所有版本,但不适用于 Silverlight 中所含的 .NET Framework。

透明度可帮助开发人员编写更安全的 .NET Framework 库来向部分信任的代码公开功能。 .NET Framework 2.0 版中引入了 1 级透明度,此透明度主要仅供 Microsoft 内部使用。 从.NET Framework 4 开始,你可以使用2 级透明度。 但是,已保留 1 级透明度,以便可以确定必须使用以前的安全规则运行的旧代码。

Important: 应仅出于兼容性目的而指定 1 级透明度;也就是说,仅为使用 .NET Framework 3.5 或以前的版本(使用 xref:System.Security.AllowPartiallyTrustedCallersAttribute 或不使用透明度模型)开发的代码指定 1 级透明度。 例如,对允许从部分信任的调用方 (APTCA) 调用的 .NET Framework 2.0 程序集使用 1 级透明度。 对于针对.NET Framework 4 开发的代码,始终使用 2 级透明度。

本主题包含以下各节:

1 级透明度模型

使用 1 级透明度时,你会使用一种安全模型,该模型将代码分成三类方法:安全透明的方法、安全可靠关键的方法和安全关键的方法。

可将整个程序集、程序集中的某些类或类中的某些方法标记为安全透明。 安全透明的代码不能提升特权。 此限制会造成三个后果:

在执行期间,公共语言运行时 (CLR) 会强制执行这些规则。 安全透明的代码会将其调用的代码的所有安全需求全部传递回调用方。 流过安全透明代码的要求不能提升特权。 如果低信任应用程序调用安全透明的代码并导致对高特权的要求,该要求将流回低信任代码并失败。 由于安全透明的代码不能执行断言操作,因此该代码不能停止该要求。 从完全信任代码中调用相同的安全透明代码将使要求成功。

安全关键与安全透明相反。 安全关键代码以完全信任模式执行,可以执行所有特权操作。 安全可靠关键代码是特权代码,并经过全面的安全审核,已确认它不允许部分信任的调用方使用它们无权访问的资源。

必须显式应用透明度。 通常,处理数据操作和逻辑的大部分代码都可以标记为安全透明,而执行特权提升的少量代码则标记为安全关键或安全可靠关键。

Important: 1 级透明度限于程序集范围,不能跨程序集实施。 1 级透明度主要在 Microsoft 内部出于安全审核的目的使用。 1 级程序集中的安全关键类型和成员可由其他程序集中的安全透明代码访问。 在所有 1 级安全关键类型和成员中,都必须执行针对完全信任的链接要求。 对于安全可靠关键类型或成员所访问的受保护资源,该类型和成员还必须确认调用方拥有访问这些资源的权限。

为了向后兼容 .NET Framework 的早期版本,所有未用透明度特性批注的成员都被视为安全可靠关键成员。 所有未进行此类批注的类型都被视为是透明的。 没有用于验证透明度的静态分析规则。 因此,你可能需要在运行时调试透明度错误。

透明度特性

下表介绍可用于批注代码透明度的三个特性。

特性 描述
xref:System.Security.SecurityTransparentAttribute 只允许在程序集级别上应用。 将程序集中的所有类型和成员都标识为安全透明。 程序集不能包含任何安全关键代码。
xref:System.Security.SecurityCriticalAttribute 不带 xref:System.Security.SecurityCriticalAttribute.Scope* 属性在程序集级别使用时,默认将程序集中的所有代码都标识为安全透明的代码,但会指出程序集可能包含安全关键代码。 在类级别使用时,将类或方法标识为安全关键,但不会如此标识类的成员。 若要使所有成员都成为安全关键成员,请将 xref:System.Security.SecurityCriticalAttribute.Scope* 属性设置为 xref:System.Security.SecurityCriticalScope.Everything。 在成员级别使用时,特性仅应用于相应的成员。 标识为安全关键的类或成员可以执行特权提升。 重要提示: 在 1 级透明度中,当从程序集外部调用安全关键类型和成员时,该类型或成员被视为是安全可靠关键的。 应该通过针对完全信任的链接要求来保护安全关键类型和成员,以避免未经授权的特权提升。
xref:System.Security.SecuritySafeCriticalAttribute 标识可以由程序集中的安全透明代码访问的安全关键代码。 否则,安全透明的代码将不能访问同一程序集中的私有或内部安全关键成员。 执行此操作将影响安全关键代码,并且可能会引起意外的特权提升。 安全可靠关键代码应该经过严格的安全审核。 注意: 安全可靠关键类型和成员必须验证调用方的权限,以确定调用方是否有权访问受保护的资源。

xref:System.Security.SecuritySafeCriticalAttribute 特性使得安全透明的代码可以访问同一程序集中的安全关键成员。 将程序集中的安全透明代码和安全关键代码视为两个程序集中的代码。 安全透明的代码将不能查看安全关键代码的私有或内部成员。 此外,通常会对安全关键代码进行审核,以核查对其公共接口的访问权限。 你不希望可在程序集外访问私有或内部状态,而希望将该状态保持隔离。 xref:System.Security.SecuritySafeCriticalAttribute 特性可在安全透明代码和安全关键代码之间保持状态隔离,同时允许在必要时替代该隔离。 安全透明的代码不能访问私有或内部安全关键代码,除非这些成员已标记有 xref:System.Security.SecuritySafeCriticalAttribute. 在应用 xref:System.Security.SecuritySafeCriticalAttribute 之前,将该成员视为公共公开的成员对其进行审核。

程序集范围的批注

下表描述在程序集级别使用安全特性所产生的作用。

Assembly 特性 程序集状态
部分信任的程序集上无特性 所有类型和成员都是透明的。
完全信任的程序集上无特性(对于全局程序集缓存中的程序集,或者在 AppDomain 中标识为完全信任的程序集) 所有类型都是透明的,所有成员都是安全可靠关键的。
SecurityTransparent 所有类型和成员都是透明的。
SecurityCritical(SecurityCriticalScope.Everything) 所有类型和成员都是安全关键的。
SecurityCritical 所有代码默认都是透明的。 但是,各个类型和成员可以有其他特性。

安全透明度示例

若要使用 .NET Framework 2.0 透明度规则(1 级透明度),请使用下面的程序集批注:

[assembly: SecurityRules(SecurityRuleSet.Level1)]  

如果要使整个程序集透明以指示该程序集不包含任何关键代码并且不以任何方式提升特权,则可通过以下特性显式增加程序集的透明度:

[assembly: SecurityTransparent]  

如果要在同一程序集中混合关键代码和透明代码,则可首先用 xref:System.Security.SecurityCriticalAttribute 特性标记该程序集,以指示该程序集可以包含关键代码,如下所示:

[assembly: SecurityCritical]  

如果要执行安全关键操作,则必须用另一个 xref:System.Security.SecurityCriticalAttribute 特性显式标记将执行关键操作的代码,如下面的代码示例中所示:

[assembly: SecurityCritical]  
Public class A  
{  
    [SecurityCritical]  
    private void Critical()  
    {  
        // critical  
    }  
  
    public int SomeProperty  
    {  
        get {/* transparent */ }  
        set {/* transparent */ }  
    }  
}  
public class B  
{      
    internal string SomeOtherProperty  
    {  
        get { /* transparent */ }  
        set { /* transparent */ }  
    }  
}  

除 Critical 方法显式标记为安全关键之外,前面的代码都是透明的。 即使使用程序集级别的 xref:System.Security.SecurityCriticalAttribute 特性,透明度也是默认设置。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 mairaw)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。