RDL サンドボックスの有効化と無効化

[アーティクル]
03/06/2017

RDL (レポート定義言語) サンドボックス機能を使用すると、複数のテナントが 1 つのレポートサーバー Web ファームを使用している環境で、個々のテナントによる特定の種類のリソースの使用を検出および制限できるようになります。このような例として、複数のテナントまたは複数の企業によって使用される単一のレポートサーバー Web ファームを管理するホスティングサービスのシナリオがあります。レポートサーバー管理者は、次の目的を達成するためにこの機能を有効にできます。

外部リソースのサイズを制限する。外部リソースには、画像、.xslt ファイル、およびマップデータが含まれます。
レポートのパブリッシュ時に、式のテキストで使用される型およびメンバーを制限する。
レポートの処理時に、テキストの長さおよび式の戻り値のサイズを制限する。

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 式内で許可されるメンバーの一覧です。
許可	RDL 式で許可される型または型のセットです。
Namespace	Allow の属性の 1 つであり、Value に適用される 1 つ以上の型を含む名前空間です。このプロパティでは、大文字と小文字が区別されません。
`AllowNew`	Allow のブール属性であり、RDL 式内または RDL の <Class> 要素内でその型の新しいインスタンスを作成できるかどうかを制御します。注: が有効になっている場合 `RDLSandboxing` 、の設定 `AllowNew`に関係なく、RDL 式で新しい配列を作成することはできません。
Value	Allow に対する値であり、RDL 式で許可される型の名前を示します。値が * の場合は、名前空間内のすべての型が許可されることを意味します。このプロパティでは、大文字と小文字が区別されません。
[メンバー]	<Types> 要素に含まれる型の一覧に対する、RDL 式で許可されないメンバー名の一覧です。
Deny	RDL 式で許可されないメンバーの名前です。このプロパティでは、大文字と小文字が区別されません。注: メンバーに対して Deny が指定されている場合、この名前を持つすべての型のメンバーがすべて許可されません。

RDL サンドボックスが有効なときの式の操作

式で使用されるリソースの管理を容易にするために、RDL サンドボックス機能を次のような方法で変更できます。

式に使用する文字数を制限する。
式から返される結果のサイズを制限する。
式での使用を許可する特定の型の一覧を指定する。
式での使用を許可された型の一覧に対して、制限するメンバーの一覧を名前で指定する。
RDL サンドボックス機能では、承認する型の一覧と拒否するメンバーの一覧を作成できます。承認する型の一覧を許可一覧と呼びます。拒否するメンバーの一覧をブロック一覧と呼びます。

Note

レポート定義では、式のリファレンスの各インスタンスの型をコンピューターが知ることはできません。ブロック一覧にメンバーを追加すると、許可一覧に含まれるすべての型について、その名前を持つすべてのメンバーが拒否されます。

RDL 式の結果は、実行時に検証されます。 RDL 式は、レポートのパブリッシュ時にレポート定義で検証されます。レポートサーバーのトレースログで、違反がないかどうかを確認できます。詳細については、「 Report Server Service Trace Log」を参照してください。

型の操作

許可一覧に型を追加することで、RDL 式にアクセスする次のエントリポイントを制御できます。

型の静的メンバー
Visual Basic New メソッド。
レポート定義の <Classes> 要素。
許可一覧に含まれる型に対してブロック一覧に追加したメンバー

許可一覧では、次のエントリポイントは制御されません。

レポートデータセット。クエリから返されるレポートデータセット内のフィールドは、任意の有効な RDL 型を含むことができます。
レポートパラメーター。ユーザーから提供されるパラメーターの値は、任意の有効な RDL 型を含むことができます。
ブロック一覧に含まれていない、有効な型のメンバー。既定では、許可一覧に含まれるすべての型のすべてのメンバーが有効になっています。ブロック一覧にメンバー名を追加すると、許可一覧に含まれるすべての型について、その名前を持つすべてのメンバーが拒否されます。

1 つの型のメンバーを有効にして、別の型では同じ名前のメンバーを拒否するには、次の手順を実行する必要があります。

そのメンバー名に対して <Deny> 要素を追加します。
有効にするメンバーに対して、カスタムアセンブリのクラスに異なる名前のプロキシメンバーを作成します。
その新しいクラスを許可一覧に追加します。

許可一覧に Visual Basic .NET Framework の関数を追加するには、Microsoft.VisualBasic 名前空間の対応する型を許可一覧に追加します。

許可一覧に Visual Basic .NET Framework の型キーワードを追加するには、対応する CLR 型を許可一覧に追加します。たとえば、Visual Basic .NET Framework キーワード (keyword)Integerを使用するには、RDLSandboxing 要素に次の< XML フラグメントを>追加します。

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

許可一覧にジェネリック型または Visual Basic .NET Framework の null 許容型を追加するには、次のようにする必要があります。

ジェネリック型または Visual Basic .NET Framework の null 許容型に対してプロキシ型を作成します。
そのプロキシ型を許可一覧に追加します。

カスタムアセンブリから許可一覧に型を追加しても、アセンブリに対して暗黙に実行権限が付与されることはありません。コードアクセスセキュリティファイルを具体的に変更して、アセンブリに実行権限を提供する必要があります。詳細については、「 Reporting Services のコードアクセスセキュリティ」を参照してください。

メンバーの <拒否> リストの管理

許可一覧に新しい型を追加するときには、次に示す場合に、メンバーのブロック一覧の更新が必要となります。

新しい型を導入するバージョンでカスタムアセンブリを更新する場合。
許可一覧に含まれる型にメンバーを追加する場合。
レポートサーバー上で .NET Framework を更新する場合。
レポートサーバーを Reporting Services の新しいバージョンにアップグレードする場合。
RDL 型に新しいメンバーが追加された可能性があるため、新しい RDL スキーマを処理できるようにレポートサーバーを更新する場合

演算子と New の操作

既定では、を除く NewVisual Basic .NET Framework言語演算子は常に許可されます。演算子はNew、Allow> 要素の<AllowNew 属性によって制御されます。既定のコレクションアクセサー演算子や Visual Basic .NET Framework などのキャストマクロCIntなど、その他の言語演算子!は常に許可されます。

カスタム演算子を含め、ブロック一覧への演算子の追加はサポートされていません。特定の型に対して演算子を除外するには、次の手順を実行する必要があります。

除外する演算子を実装しないプロキシ型を作成します。
そのプロキシ型を許可一覧に追加します。

RDL 式に新しい配列を作成するには、定義するクラスのメソッドで配列を作成し、そのクラスを許可一覧に追加します。

RDL 式に新しい配列を作成するには、次の手順を実行する必要があります。

新しいクラスを定義し、そのクラスのメソッドで配列を作成します。
このクラスを許可一覧に追加します。

参照

RSReportServer 構成ファイル
 レポートサーバーサービスのトレースログ

次の方法で共有