信頼される管理プロバイダー <trustedProviders>
- 概要
- 互換性
- セットアップ
- 方法
- 構成
- サンプル コード
※本ページに挿入されている画像をクリックすると、画像全体が別ウィンドウで表示されます。
概要
<management>
要素の <trustedProviders>
要素は、IIS マネージャーおよび管理サービス (WMSVC) によって信頼される管理プロバイダーを構成します。
サイトまたはアプリケーションのプロバイダーを呼び出す前に、.NET ユーザーおよび .NET の役割の機能は、構成されたプロバイダーが信頼されるかどうかを確認します。信頼されていない場合、allowUntrustedProviders 属性の設定によって、信頼されていないプロバイダーの実行を許可するかどうかが決定されます。信頼されていないプロバイダーが許可されず、そのプロバイダーが信頼されるプロバイダーのコレクションにない場合、そのプロバイダーは実行を許可されません。
互換性
IIS 7.0 | IIS 6.0 | |
---|---|---|
説明 | <management> の <trustedProviders> は IIS 7.0 で新たに導入された要素です。 |
なし |
セットアップ
IIS 7.0 の既定のインストールには、"管理サービス" 役割サービスは含まれません。この役割サービスをインストールするには、次の手順を実行します。
Windows Server 2008
タスク バーの [スタート] ボタンをクリックし、[管理ツール] をポイントして [サーバー マネージャー] をクリックします。
[サーバー マネージャー] のツリー表示で、[役割] を展開して [Web サーバー (IIS)] をクリックします。
[Web サーバー (IIS)] ウィンドウで、[役割サービス] セクションまでスクロールして [役割サービスの追加] をクリックします。
役割サービスの追加ウィザードの [役割サービスの選択] ページで、[管理サービス] を選択して、[次へ] をクリックします。
[インストール オプションの確認] ページで [インストール] をクリックします。
[結果] ページで [閉じる] をクリックします。
Windows Vista
タスク バーの [スタート] ボタンをクリックし、[コントロール パネル] をクリックします。
[コントロール パネル] の [プログラムと機能] をクリックして、[Windows の機能の有効化または無効化] をクリックします。
[Internet Information Services]、[Web 管理ツール] の順に展開します。
[IIS 管理サービス] を選択して、[OK] をクリックします。
方法
IIS 7.0 には、<trustedProviders>
要素を構成するためのユーザー インターフェイスはありません。<trustedProviders>
要素をプログラムによって構成する方法の例については、このドキュメントの「サンプル コード」セクションを参照してください。
構成
属性
属性 | 説明 |
---|---|
allowUntrustedProviders |
オプションの Boolean 属性。 信頼されていないプロバイダーの実行が可能かどうかを指定します。 重要 : この値を true に変更すると、信頼されていないコードをサーバー上で実行することが許可されます。よって、セキュリティ上の理由からこれは推奨されません。この設定を行なうのではなく、プロバイダーを必ずテストして、安全であると判断された場合のみ、そのプロバイダーを信頼されるプロバイダー コレクションに追加するようにしてください。 既定値は false です。 |
子要素
要素 | 説明 |
---|---|
add |
オプションの要素。 IIS マネージャーおよび管理サービス (WMSVC) による実行が信頼されるプロバイダーのコレクションに、プロバイダーを追加します。 |
構成サンプル
次の既定の <trustedProviders>
要素は、"管理サービス" 役割サービスをインストールすると、IIS 7.0 のルート Administration.config ファイルに構成されます。
<trustedProviders allowUntrustedProviders="false">
<add type="System.Web.Security.SqlMembershipProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
<add type="System.Web.Security.SqlRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
<add type="System.Web.Security.WindowsTokenRoleProvider, System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
</trustedProviders>
サンプル コード
注 : ここでは、.NET グローバル アセンブリ キャッシュ (GAC) に保存されているマネージ コード アセンブリを使用した例を紹介しています。これらの例で示すコードを使用して独自のアセンブリを展開するには、事前に GAC からアセンブリ情報を取得する必要があります。それには、次の手順を実行します。
- Windows エクスプローラーで C:\Windows\assembly パスを開きます。C: は使用しているオペレーティング システムのドライブに置き換えてください。
- アセンブリを見つけます。
- アセンブリを右クリックして [プロパティ] をクリックします。
- [カルチャ] の値をコピーします (例 : Neutral)。
- [バージョン] の番号をコピーします (例 : 1.0.0.0)。
- [公開キー トークン] の値をコピーします (例 : f0e1d2c3b4a59687)。
- [キャンセル] をクリックします。
次のコード サンプルは、信頼される管理プロバイダーのコレクションに、Contoso.Provider という名前のプロバイダーを追加します。
AppCmd.exe
注 : AppCmd.exe を使用して <system.webServer/Management>
の設定を構成することはできません。
C#
using System;
using System.Text;
using Microsoft.Web.Administration;
internal static class Sample
{
private static void Main()
{
using (ServerManager serverManager = new ServerManager())
{
Configuration config = serverManager.GetAdministrationConfiguration();
ConfigurationSection trustedProvidersSection = config.GetSection("system.webServer/management/trustedProviders");
ConfigurationElementCollection trustedProvidersCollection = trustedProvidersSection.GetCollection();
ConfigurationElement addElement = trustedProvidersCollection.CreateElement("add");
addElement["type"] = @"Contoso.Provider, System.Web, Version=1.0.0.0, Culture=neutral, PublicKeyToken=f0e1d2c3b4a59687";
trustedProvidersCollection.Add(addElement);
serverManager.CommitChanges();
}
}
}
VB.NET
Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample
Sub Main()
Dim serverManager As ServerManager = New ServerManager
Dim config As Configuration = serverManager.GetAdministrationConfiguration
Dim trustedProvidersSection As ConfigurationSection = config.GetSection("system.webServer/management/trustedProviders")
Dim trustedProvidersCollection As ConfigurationElementCollection = trustedProvidersSection.GetCollection
Dim addElement As ConfigurationElement = trustedProvidersCollection.CreateElement("add")
addElement("type") = "Contoso.Provider, System.Web, Version=1.0.0.0, Culture=neutral, PublicKeyToken=f0e1d2c3b4a59687"
trustedProvidersCollection.Add(addElement)
serverManager.CommitChanges()
End Sub
End Module
JavaScript
var adminManager = new ActiveXObject("Microsoft.ApplicationHost.WritableAdminManager");
adminManager.CommitPath = "MACHINE/WEBROOT";
adminManager.SetMetadata("pathMapper", "AdministrationConfig");
var trustedProvidersSection = adminManager.GetAdminSection("system.webServer/management/trustedProviders", "MACHINE/WEBROOT");
var trustedProvidersCollection = trustedProvidersSection.Collection;
var addElement = trustedProvidersCollection.CreateNewElement("add");
addElement.Properties.Item("type").Value = "Contoso.Provider, System.Web, Version=1.0.0.0, Culture=neutral, PublicKeyToken=f0e1d2c3b4a59687";
trustedProvidersCollection.AddElement(addElement);
adminManager.CommitChanges();
VBScript
Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT"
adminManager.SetMetadata "pathMapper", "AdministrationConfig"
Set trustedProvidersSection = adminManager.GetAdminSection("system.webServer/management/trustedProviders", "MACHINE/WEBROOT")
Set trustedProvidersCollection = trustedProvidersSection.Collection
Set addElement = trustedProvidersCollection.CreateNewElement("add")
addElement.Properties.Item("type").Value = "Contoso.Provider, System.Web, Version=1.0.0.0, Culture=neutral, PublicKeyToken=f0e1d2c3b4a59687"
trustedProvidersCollection.AddElement(addElement)
adminManager.CommitChanges()