適用対象

• ASP.NET Version 2.0

概要

目次

このガイドの目的

• 中程度の信頼を使用する Web アプリケーションを開発する方法を学習する
• 部分的に信頼された Web アプリケーションに関する ASP.NET Version 2.0 における変更点を学習する
• 中程度の信用レベルを使用した場合の制限事項を学習する
• Web アプリケーションで中程度の信頼レベルを設定する
• 信頼レベルを修正してカスタム信頼レベルを作成する

はじめに

<trust level="Full|High|Medium|Low|Minimal" />

2.0 における変更点

• Version 2.0 より、.NET Framework Data Provider for SQL Server は完全な信頼を要求しなくなったため、中程度の信頼レベルでも SQL Server へのアクセスが可能です。
• Version 2.0 では、完全、高度、中程度の信頼において SmtpPermission が使用できます。これにより、アプリケーションからのメール送信が可能になります。
• Version 2.0 より、OLE DB のマネージ データ プロバイダは完全な信頼を要求しなくなっています。ただしデフォルトのままでは、中程度の信頼アプリケーションに OleDbPermission は付与されていません。部分的な信頼から OLE DB データ ソースにアクセスする場合は、アプリケーションに OleDbPermission を付与するカスタム信頼ポリシー ファイルを作成しなければいけません。詳細については、本ガイドで後述します。
• Version 1.1 では、イベント ログにアクセスする場合、コードに完全な信頼を付与する必要がありましたが、ASP.NET Version 2.0 ではその必要はありません。ただし、EventLogPermission を付与するにはカスタム信頼ポリシー ファイルを作成しなければいけません。詳細については、本ガイドで後述します。
• ASP.NET Version 2.0 より、SQL Server マネージ データ プロバイダは完全な信頼を要求しなくなりました。また中程度の信頼アプリケーションには SqlClientPermission が付与されているため、中程度の信頼アプリケーションは SQL Server データベースにアクセスできます。また中程度の信頼アプリケーションは、SQL Server からの通知の受信を可能にする SqlNotificationPermission (ASP.NET Version 2.0 より導入) を使用できます。

中程度の信頼について

• OleDbPermission を使用できない。つまり、ADO.NET のマネージ OLE DB データ プロバイダを使用してデータベースにアクセスできません。ただし、マネージ SQL Server プロバイダを使用すれば SQL Server データベースにアクセスできます。
• EventLogPermission を使用できない。つまり、Windows イベント ログにアクセスできません。
• ReflectionPermission を使用できない。つまり、リフレクションを使用できません。
• RegistryPermission を使用できない。つまり、レジストリにアクセスできません。
• WebPermission が制限される。つまり、アプリケーションは、<trust> 要素で定義したアドレスまたはアドレス範囲でしか通信できません。
• FileIOPermission が制限される。つまり、アプリケーションの仮想ディレクトリ階層にあるファイルにしかアクセスできません。アプリケーションには、アプリケーションの仮想ディレクトリ階層に対する、読み取り、書き込み、追加、および PathDiscovery 権限が付与されています。

ステップ概要

• ステップ 1. 中程度の信頼を設定する。
• ステップ 2. 信頼レベルをロックする。
• ステップ 3. 中程度の信頼をベースにした任意のカスタム ポリシーを作成する。

ステップ 1. 中程度の信頼を設定する

<trust level="Medium" originUrl="" />

注意    WebPermission などの一部の権限では、originUrl 属性を使用すれば、あらかじめ定義したアドレス一式へのコネクティビティを制限することができます。

<location allowOverride="true">
<system.web>
<securityPolicy>
<trustLevel name="Full" policyFile="internal" />
<trustLevel name="High" policyFile="web_hightrust.config" />
<trustLevel name="Medium" 
policyFile="web_mediumtrust.config" />
<trustLevel name="Low"  policyFile="web_lowtrust.config" />
<trustLevel name="Minimal" 
policyFile="web_minimaltrust.config" />  
</securityPolicy>
<trust level="Full" originUrl="" />
</system.web>
</location>

ステップ 2. 信頼レベルをロックする

<location allowOverride="false">
<system.web>
<securityPolicy>
<trustLevel name="Full" policyFile="internal" />
<trustLevel name="High" policyFile="web_hightrust.config" />
<trustLevel name="Medium"
policyFile="web_mediumtrust.config" />
<trustLevel name="Low"  
policyFile="web_lowtrust.config" />
<trustLevel name="Minimal" 
policyFile="web_minimaltrust.config" />  
</securityPolicy>
<trust level="Medium" originUrl="" />
</system.web>
</location>

ステップ 3. 中程度の信頼をベースにした任意のカスタム ポリシーを作成する

1. 「%windir%\Microsoft.NET\Framework\{Version}\CONFIG」 ディレクトリにある中程度の信頼ポリシー ファイル web_MediumTrust.config をコピーして、同じディレクトリ内に新しいポリシー ファイルを作成します。

   新しいポリシー ファイルに、中程度の信頼のバリエーションであることが分かるような名前を付けます。たとえば、customWeb_MediumTrust.config のような名前をつけるとよいでしょう。

2. 付与したい権限を追加します。下の例では、アプリケーションの仮想ディレクトリ階層の外にある、ある特定のディレクトリに対して読み取りアクセスを許可するよう、FileIOPermission を修正しています。

   <PermissionSet
   class="NamedPermissionSet"
   version="1"
   Name="ASP.Net">
   ...
   <IPermission
   class="FileIOPermission"
   version="1"
   Read="C:\SomeDir;$AppDir$"
   Write="$AppDir$"
   Append="$AppDir$"
   PathDiscovery="$AppDir$"
   />
   ...
   </PermissionSet>
   

3. マシンレベルの Web.config ファイルに新しいカスタム ポリシー レベルを作成します。ポリシー ファイルは、ステップ 1 で作成したポリシー ファイルの名前です。

   <securityPolicy>
   <trustLevel name="CustomMedium" 
   policyFile="customWeb_mediumtrust.config" />
   ...
   </securityPolicy>
   

4. 信頼レベルを "CustomMedium" に設定することで、アプリケーションが新しいカスタム ポリシー レベルで動作するよう設定します。セキュリティ ポリシーは、次の例のようになります。

   <system.web>
   <securityPolicy>
   <trustLevel name="CustomMedium"
   policyFile="customWeb_mediumtrust.config" />
   <trustLevel name="Full" policyFile="internal" />
   <trustLevel name="High" 
   policyFile="web_hightrust.config" />
   <trustLevel name="Medium" 
   policyFile="web_mediumtrust.config" />
   <trustLevel name="Low"  policyFile="web_lowtrust.config" />
   <trustLevel name="Minimal"
   policyFile="web_minimaltrust.config" />
   </securityPolicy>
   <trust level="CustomMedium" originUrl="" />
   </system.web>
   

OleDbPermission、EventLogPermission および FileIOPermission

• OleDbPermission
• EventLogPermision
• FileIOPermission

OleDbPermission

1. 前述の "中程度の信頼をベースにしたカスタム ポリシーを作成するには" の手順に従い、カスタム ポリシー ファイルを作成し、アプリケーションでカスタム信頼レベルを使用するための設定を行います。
2. 次の権限クラスを <SecurityClasses> セクションに追加します。

   <SecurityClass Name="OleDbPermission" 
   Description="System.Data.OleDb.OleDbPermission, System.Data, Version=2.0.0.0, 
   		Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
   

3. 以下の例のように、制限のない権限 OleDbPermission を "ASP.Net" という名前の権限セットに追加します。

   <PermissionSet
   class="NamedPermissionSet"
   version="1"
   Name="ASP.Net">
   ...
   <IPermission class="OleDbPermission" 
   version="1" 
   Unrestricted="true"/>
   ...
   </PermissionSet>
   

接続文字列をロック ダウンする

<IPermission class="OleDbPermission"
version="1">
<add ConnectionString=
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\data\w4w.mdb"
KeyRestrictions=""
KeyRestrictionBehavior="AllowOnly"/>
</IPermission>

• ConnectionString: この属性は許可された接続の接続文字列を指定します。
• KeyRestrictions: この属性は、追加の接続文字列パラメータを指定します。この属性に指定された値が接続文字列に追加されるか否かは、KeyRestrictionBehavior の値に依存します。接続文字列パラメータの指定には "parameterName=" という構文を用います。セミコロン (;) で区切ることで、複数のパラメータを指定することができます。
• KeyRestrictionBehavior: 値として、AllowOnly または PreventUsage のいずれかを設定できます。
  • AllowOnly を使用すると、KeyRestrictions 属性に指定された追加の接続文字列パラメータのみを ConnectionString に指定した接続文字列に追加することができます。
  • PreventUsage を使用すると、KeyRestrictions 属性に指定された接続文字列パラメータは ConnectionString に指定した接続文字列に追加されません。ただし、別の文字列パラメータを追加することができます。

EventLogPermission

1. 前述の "中程度の信頼をベースにしたカスタム ポリシーを作成するには" の手順に従い、カスタム ポリシー ファイルを作成し、アプリケーションでカスタム信頼レベルを使用するための設定を行います。
2. 次の権限クラスをカスタム ポリシー ファイルの <SecurityClasses> セクションに追加します。

   <SecurityClasses>
   ...
   <SecurityClass Name="EventLogPermission"
   Description="System.Diagnostics.EventLogPermission, System, Version=2.0.0.0, 
   		 Culture=neutral, PublicKeyToken=b77a5c561934e089" />
   ...
   </SecurityClasses>
   	
   

3. 次の EventLogPermission を "ASP.Net" という名前の権限セットに追加します。

   <PermissionSet
   class="NamedPermissionSet"
   version="1"
   Name="ASP.Net">
   ...
   <IPermission
   class="EventLogPermission"
   version="1">
   <Machine name="."
   access="Write"/>
   </IPermission>
   ...
   </PermissionSet>
   

注意   書き込み時は、access="administer" を設定し、部分的に信頼されたアプリケーションからのイベント ログへの書き込みを可能にしておかなければいけません。

イベント ソースを作成する

• キーの値を照会する権限
• キーの値を設定する権限
• サブキーを作成する権限
• サブキーを列挙する権限
• 通知
• 読み取り

注意   Windows イベント ログへのアクセスを有効にすることにより、別アプリケーションによる同一ログへのアクセスやイベントの干渉といったリスクを負うことになり、攻撃者の追跡等の負担が加わります。

FileIOPermission

<IPermission
class="FileIOPermission"
version="1"
Read="C:\SomeDir;$AppDir$"
Write="$AppDir$"
Append="$AppDir$"
PathDiscovery="$AppDir$"
/>

中程度の信頼を使用するための開発

• アプリケーションがアクセスする必要のあるリソースや、実行する必要のある特権的な操作についてはタイプを認識する。

  アプリケーションが必要としているコード アクセス セキュリティ権限はないかを把握しておく必要があります。権限要件の詳細については、How To: ASP.NET 2.0 でコード アクセス セキュリティを使用する方法 の "リソース アクセス許可の概要" および "特権付き操作の許可の概要" セクションを参照してください。

• 中程度の信頼で利用可能な権限を理解する。

  利用可能な権限を確認する一番よい方法は、「%windir%\Microsoft.NET\Framework\{Version}\CONFIG」 フォルダにある web_MediumTrust.config ファイルをオープンし、中身を検証することです。

• 開発環境とアプリケーションの Web.config ファイルを中程度の信頼を使用するよう設定する。

  この設定は、リクエストが失敗する権限や、解決しておく必要のある問題がすぐに分かるよう、開発の最初に行うようにしてください。

• 既存のアプリケーションについては、Permcalc ツールの使用を検討する。

  中程度の信頼で動作させたい既存のアプリケーションの場合は、Permcalc ツールの使用を検討してください。このツールを使用することで、アプリケーションが必要とする権限を正確に判断することができます。また、広範囲なテスティングを必ず実行し、アプリケーションから実行するすべてのコード パスが実行されることも検証しなければいけません。これらの確認作業を怠ると、実行時に予期せぬセキュリティ例外が発生することがあります。

• アンマネージ コードを呼び出している。
• レジストリにアクセスしている。
• イベント ログへの書き込みを行っている。
• SQL Server 以外のデータベースに接続している。
• リモート サーバー上の Web リソースにアクセスしている。
• アプリケーションの仮想ディレクトリ階層の外側にあるファイルにアクセスしている。

関連資料

• How To: ASP.NET 2.0 でコード アクセス セキュリティを使用する方法

ご意見、ご提案

• Wiki: Security Guidance Feedback ページ (英語): http://channel9.msdn.com/wiki/default.aspx/Channel9.SecurityGuidanceFeedback
• メール: secguide@microsoft.com (英語) までメールをお寄せください。

• 推奨事項に関する技術的な問題
• 実用性および利便性に関する問題

テクニカル サポート

コミュニティおよびニュースグループ

• MSDN Online 開発者向けニュースグループ: http://www.microsoft.com/japan/msdn/newsgroups/
• ASP.NET Forums (英語): http://forums.asp.net/

テスト、編集、リリースチーム

• テストチーム: Larry Brader, Microsoft Corporation; Nadupalli Venkata Surya Sateesh, Sivanthapatham Shanmugasundaram, Infosys Technologies Ltd.
• 編集チーム: Nelly Delgado, Microsoft Corporation; Sharon Smith, Linda Werner & Associates, Inc.; Tina Burden McGrayne, TinaTech Inc.
• リリース管理:Sanjeev Garg, Microsoft Corporation