大网数据广告活动
数据库与应用安全

在 SharePoint 集成模式下针对 Reporting Services 启用和禁用 RDL 沙盒

· 52CE 我爱测

通过 RDL(报表定义语言)沙盒处理功能,可以在多个租户使用报表服务器的单个 Web 场的情况下检测到和限制单个租户使用特定类型的资源。 相关的示例是宿主服务方案,在此方案中,您可能维护多个用户(并且可能是不同的公司)使用的报表服务器的单个 Web 场。 作为报表服务器管理员,您可以启用此功能以帮助实现以下目标:

适用对象: 是SQL Server Reporting Services (2016) 是SharePoint 否Power BI 报表服务器

对于与以前版本的 SQL Server 相关的内容,请参阅 SQL Server Reporting Services 2014。

通过 RDL(报表定义语言)沙盒处理功能,可以在多个租户使用报表服务器的单个 Web 场的情况下检测到和限制单个租户使用特定类型的资源。 相关的示例是宿主服务方案,在此方案中,您可能维护多个用户(并且可能是不同的公司)使用的报表服务器的单个 Web 场。 作为报表服务器管理员,您可以启用此功能以帮助实现以下目标:

  • 限制外部资源的大小。 外部资源包括图像、.xslt 文件和地图数据。

  • 在报表发布时,限制在表达式文本中使用的类型和成员。

  • 在报表处理时,限制文本长度和表达式返回值的大小。

Note: 自 SQL Server 2016 之后,不再提供 Reporting Services 与 SharePoint 的集成这一功能。

在启用 RDL 沙盒处理时,禁用以下功能:

  • 报表定义的 <Code> 元素中的自定义代码。

  • 用于 SQL Server 2005 Reporting Services (SSRS) 自定义报表项的 RDL 向后兼容模式。

  • 表达式中的命名参数。

本主题介绍 RSReportServer.Config 文件中 <RDLSandboxing> 元素内的各元素。 有关如何修改此文件的详细信息,请参阅修改 Reporting Services 配置文件 (RSreportserver.config)。 服务器跟踪日志记录与 RDL 沙盒处理功能相关的活动。 有关跟踪日志的详细信息,请参阅 报表服务器服务跟踪日志。

配置示例

下面的示例显示了 RSReportServer.Config 文件中 <RDLSandboxing> 元素的设置和示例值。

<RDLSandboxing>  
   <MaxExpressionLength>5000</MaxExpressionLength>  
   <MaxResourceSize>5000</MaxResourceSize>  
   <MaxStringResultLength>3000</MaxStringResultLength>  
   <MaxArrayResultLength>250</MaxArrayResultLength>  
   <Types>  
      <Allow Namespace=”System.Drawing” AllowNew=”True”>Bitmap</Allow>  
      <Allow Namespace=”TypeConverters.Custom” AllowNew=”True”>*</Allow>  
   </Types>  
   <Members>  
      <Deny>Format</Deny>  
      <Deny>StrDup</Deny>  
   </Members>  
</RDLSandboxing>  

配置设置

下表提供了有关配置设置的信息。 将按设置在配置文件中的显示顺序依次列出:

设置 描述
MaxExpressionLength RDL 表达式中允许的最大字符数。 默认值:1000
MaxResourceSize 外部资源允许的最大 KB 数。 默认值:100
MaxStringResultLength RDL 表达式的返回值中允许的最大字符数。 默认值:1000
MaxArrayResultLength RDL 表达式的数组返回值中允许的最大项数。 默认值:100
类型 在 RDL 表达式内允许的成员的列表。
Allow RDL 表达式中允许的一个类型或一组类型。
Namespace Allow 的属性,它是包含应用于 Value 的一个或多个类型的命名空间。 此属性不区分大小写。
AllowNew Allow 的布尔属性,控制是否允许在 RDL 表达式中或 RDL <Class> 元素中创建该类型的新实例。 在启用 RDLSandboxing 时,无论 AllowNew 的设置如何,都不能在 RDL 表达式中创建新数组。
ReplTest1 Allow 的值,作为在 RDL 表达式中要允许的类型的名称。 值 * 指示命名空间中的所有类型都是允许的。 此属性不区分大小写。
成员 对于在类型 <Types> 元素中包括的类型的列表,为在 RDL 表达式中不允许的成员名称的列表。
拒绝 在 RDL 表达式中不允许的成员的名称。 此属性不区分大小写。 在为某一成员指定了 Deny 后,不允许所有类型的具有此名称的所有成员。

当启用 RDL 沙盒处理时使用表达式

您可以修改 RDL 沙盒处理功能,以便通过以下方式管理表达式使用的资源:

  • 限制用于表达式的字符数。

  • 限制表达式所返回的结果的大小。

  • 允许可以在表达式中使用的类型的特定列表。

  • 对于可在表达式中使用的允许类型的列表,按名称限制成员的列表。

  • 通过 RDL 沙盒处理功能,您可以创建已批准类型的列表和拒绝的成员的列表。 已批准类型的列表称为允许列表。 拒绝的成员的列表称为阻止列表。

Note:
在报表定义中,计算机无法知道表达式引用的每个实例的类型。 在您将一个成员添加到该阻止列表时,即拒绝允许列表中所有类型的该名称的所有成员。

在运行时验证 RDL 表达式结果。 在发布报表时在报表定义中验证 RDL 表达式。 监控报表服务器跟踪日志以发现冲突。 有关详细信息,请参阅 Report Server Service Trace Log。

使用类型

在您将某一类型添加到允许列表中时,即控制用于访问 RDL 表达式的以下入口点:

  • 某一类型的静态成员。

  • Visual Basic New 方法。

  • 报表定义中的 <Classes> 元素。

  • 已为允许列表中的某一类型添加到阻止列表中的成员。

允许列表不控制以下入口点:

  • 报表数据集。 从查询返回的报表数据集中的字段可以包含任何有效的 RDL 类型。

  • 报表参数。 用户提供的参数值可以包含任何有效的 RDL 类型。

  • 未处于阻止列表中的已启用类型的成员。 默认情况下,启用允许列表中所有类型的所有成员。 在您将一个成员名称添加到该阻止列表时,即拒绝允许列表中所有类型的具有该名称的所有成员。

若要启用一种类型的成员,但拒绝其他类型的具有相同名称的成员,必须执行以下操作:

  • 为成员名称添加 <Deny> 元素。

  • 对于您想要启用的成员,为其创建一个代理成员,该成员在自定义程序集中的类上具有不同的名称。

  • 将该新类添加到允许列表中。

若要将 Visual Basic .NET Framework 函数添加到允许列表,请将来自 Microsoft.VisualBasic 命名空间的相应类型添加到该允许列表。

若要将 Visual Basic .NET Framework 类型关键字添加到允许列表,请将相应的 CLR 类型添加到该允许列表。 例如,若要使用 Visual Basic .NET Framework 关键字 Integer,请将以下 XML 片段添加到 <RDLSandboxing> 元素:

<Allow Namespace="System">Int32</Allow>  

若要将泛型或 Visual Basic .NET Framework 可以为 Null 类型添加到允许列表,必须执行以下操作:

  • 为泛型或 Visual Basic .NET Framework 可以为 Null 类型创建代理类型。

  • 向允许列表中添加该代理类型。

将一个类型从某一自定义程序集添加到允许列表并不隐式授予对该程序集的执行权限。 您必须专门修改代码访问安全文件,并对您的程序集提供执行权限。 有关详细信息,请参阅 Code Access Security in Reporting Services。

维护成员的 <Deny> 列表

在您将某一新类型添加到允许列表时,使用以下列表可以确定何时可能必须更新成员的阻止列表:

  • 在您使用引入新类型的版本更新自定义程序集时。

  • 在您向允许列表中的类型添加成员时。

  • 在您更新报表服务器上的 .NET Framework 时。

  • 在您将报表服务器升级到 Reporting Services的更高版本时。

  • 在您更新报表服务器以处理更高版本的 RDL 架构时,因为新成员可能已添加到 RDL 类型中。

使用运算符和 New

默认情况下,始终允许 Visual Basic New 以外的所有.NET Framework 语言运算符。 New 运算符由 <Allow> 元素上的 AllowNew 属性控制。 始终允许其他语言运算符(如默认集合取值函数运算符 !) 和 Visual Basic .NET Framework 转换宏(如 CInt)。

不支持将运算符添加到阻止列表(包括自定义运算符)。 要排除某一类型的运算符,必须执行以下操作:

  • 创建一个代理类型,它不实现您想要排除的运算符。

  • 向允许列表中添加该代理类型。

若要在 RDL 表达式中创建一个新数组,请在方法中对您定义的类创建该数组,并且将该类添加到允许列表。

若要在 RDL 表达式中创建一个新数组,必须执行以下操作:

  • 定义一个新类,并在方法中对该类创建数组。

  • 将该类添加到允许列表中。

另请参阅

RsReportServer.config 配置文件
报表服务器服务跟踪日志

更多疑问? 请访问 Reporting Services 论坛

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

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

资料来源与适用范围

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

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

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