HostSecurityManager

.NET Framework クラス ライブラリ リファレンス

HostSecurityManager クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

アプリケーション ドメインのセキュリティ動作の制御およびカスタマイズを実行できるようにします。

名前空間: System.Security
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class HostSecurityManager

Visual Basic (使用法)

Dim instance As HostSecurityManager

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class HostSecurityManager

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class HostSecurityManager

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class HostSecurityManager

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class HostSecurityManager

解説

新しい AppDomain を作成すると、共通言語ランタイムによって AppDomainManager に HostSecurityManager が存在するかどうかが照会されます。これは、AppDomain に対するセキュリティ決定を行う際に考慮されます。ホストのプロバイダには、HostSecurityManager クラスを継承するホスト セキュリティ マネージャを実装する必要があります。

継承時の注意 HostSecurityManager の一部のメンバは、暗黙的または明示的にアセンブリが読み込まれるたびに呼び出されます。DomainPolicy プロパティの get アクセサ、ProvideAssemblyEvidence メソッド、および ProvideAppDomainEvidence メソッドでは、アセンブリを読み込まないでください。アセンブリを読み込むと、HostSecurityManager のメンバが再帰的に呼び出されるためです。循環参照を避けるには、HostSecurityManager から派生したクラスのコンストラクタで、暗黙的または明示的にアセンブリの読み込みを実行できるクラスのインスタンスを新しく作成します。

使用例

HostSecurityManager の非常に単純な実装を次のコード例に示します。

Visual Basic

' To replace the default security manager with MySecurityManager, add
 the 
' assembly to the GAC and call MySecurityManager in the
' custom implementation of the AppDomainManager.
Imports System
Imports System.Collections
Imports System.Net
Imports System.Reflection
Imports System.Security
Imports System.Security.Permissions
Imports System.Security.Policy
Imports System.Security.Principal
Imports System.Threading
Imports System.Runtime.InteropServices
Imports System.Runtime.Hosting

<Assembly: System.Security.AllowPartiallyTrustedCallersAttribute()> 
<Serializable()> _
<SecurityPermissionAttribute(SecurityAction.Demand, Flags:=SecurityPermissionFlag.Infrastructure)>
 _
Public Class MySecurityManager
    Inherits HostSecurityManager

    Public Sub New()
        Console.WriteLine(" Creating MySecurityManager.")

    End Sub 'New

    Private myDomainPolicy As PolicyLevel =
 Nothing

    Public Overrides ReadOnly
 Property DomainPolicy() As PolicyLevel
        Get
            If AppDomain.CurrentDomain.FriendlyName = "DefaultDomain"
 OrElse AppDomain.CurrentDomain.FriendlyName = "Compilation
 Domain" Then
                Return Nothing
            End If
            If myDomainPolicy Is Nothing
 Then
                myDomainPolicy = CreateAppDomainPolicy()
            End If
            Return myDomainPolicy
        End Get
    End Property

    Private hostFlags As HostSecurityManagerOptions
 = HostSecurityManagerOptions.HostDetermineApplicationTrust Or
 HostSecurityManagerOptions.HostAssemblyEvidence

    Public Overrides ReadOnly
 Property Flags() As HostSecurityManagerOptions
        Get
            Return hostFlags
        End Get
    End Property

    Public Overrides Function
 ProvideAssemblyEvidence(ByVal loadedAssembly As
 [Assembly], ByVal evidence As Evidence) As Evidence
        Console.WriteLine("Provide assembly evidence for: "
 + IIf(loadedAssembly Is Nothing, "Unknown",
 loadedAssembly.ToString()) + ".") 'TODO: For performance reasons this should be changed to nested IF statements
        If evidence Is Nothing
 Then
            Return Nothing
        End If
        evidence.AddAssembly(New CustomEvidenceType())
        Return evidence

    End Function 'ProvideAssemblyEvidence

    Public Overrides Function
 ProvideAppDomainEvidence(ByVal evidence As
 Evidence) As Evidence
        Console.WriteLine("Provide evidence for the "
 + AppDomain.CurrentDomain.FriendlyName + " AppDomain.")
        If evidence Is Nothing
 Then
            Return Nothing
        End If
        evidence.AddHost(New CustomEvidenceType())
        Return evidence

    End Function 'ProvideAppDomainEvidence

    <SecurityPermissionAttribute(SecurityAction.Demand, Execution:=True), SecurityPermissionAttribute(SecurityAction.Assert,
 Unrestricted:=True)> _
    Public Overrides Function
 DetermineApplicationTrust(ByVal applicationEvidence As
 Evidence, ByVal activatorEvidence As Evidence, ByVal context As TrustManagerContext) As
 ApplicationTrust
        If applicationEvidence Is Nothing
 Then
            Throw New ArgumentNullException("applicationEvidence")
        End If
        ' Get the activation context from the application evidence.
        ' This HostSecurityManager does not examine the activator evidence
        ' nor is it concerned with the TrustManagerContext;
        ' it simply grants the requested grant in the application manifest.
        Dim enumerator As IEnumerator = applicationEvidence.GetHostEnumerator()
        Dim activationArgs As ActivationArguments
 = Nothing
        While enumerator.MoveNext()
            activationArgs = enumerator.Current '
            If Not (activationArgs Is
 Nothing) Then
                Exit While
            End If
        End While
        If activationArgs Is Nothing
 Then
            Return Nothing
        End If
        Dim activationContext As ActivationContext
 = activationArgs.ActivationContext
        If activationContext Is Nothing
 Then
            Return Nothing
        End If
        Dim trust As New
 ApplicationTrust(activationContext.Identity)
        Dim asi As New ApplicationSecurityInfo(activationContext)
        trust.DefaultGrantSet = New PolicyStatement(asi.DefaultRequestSet,
 PolicyStatementAttribute.Nothing)
        trust.IsApplicationTrustedToRun = True
        Return trust

    End Function 'DetermineApplicationTrust
    Private Shared localIntranet As
 NamedPermissionSet

    Private Shared Function
 CreateAppDomainPolicy() As PolicyLevel
        Console.WriteLine("CreateAppDomainPolicy called.")
        Dim pLevel As PolicyLevel = PolicyLevel.CreateAppDomainLevel()
        ' The root code group of the policy level combines all
        ' permissions of its children.
        Dim rootCodeGroup As UnionCodeGroup
        Dim ps As New PermissionSet(PermissionState.None)
        ps.AddPermission(New SecurityPermission(SecurityPermissionFlag.Execution))
        rootCodeGroup = New UnionCodeGroup(New
 AllMembershipCondition(), New PolicyStatement(ps, PolicyStatementAttribute.Nothing))

        ' The following code limits all code on this machine to local
 intranet permissions
        ' when running in this application domain.
        FindNamedPermissionSet("LocalIntranet")
        Dim virtualIntranet As New
 UnionCodeGroup(New ZoneMembershipCondition(SecurityZone.MyComputer),
 New PolicyStatement(localIntranet, PolicyStatementAttribute.Nothing))
        virtualIntranet.Name = "Virtual Intranet"
        ' Add the code groups to the policy level.
        rootCodeGroup.AddChild(virtualIntranet)
        pLevel.RootCodeGroup = rootCodeGroup
        Return pLevel

    End Function 'CreateAppDomainPolicy


    Private Shared Sub FindNamedPermissionSet(ByVal
 name As String)
        Dim policyEnumerator As IEnumerator
 = SecurityManager.PolicyHierarchy()

        While policyEnumerator.MoveNext()
            Dim currentLevel As PolicyLevel
 = CType(policyEnumerator.Current, PolicyLevel)

            If currentLevel.Label = "Machine"
 Then
                Dim namedPermissions As IList
 = currentLevel.NamedPermissionSets
                Dim namedPermission As IEnumerator
 = namedPermissions.GetEnumerator()

                While namedPermission.MoveNext()
                    If CType(namedPermission.Current, NamedPermissionSet).Name
 = name Then
                        Console.WriteLine("Named permission set
 " + CType(namedPermission.Current, NamedPermissionSet).Name + "
 found.")
                        ' Save the LocalIntranet permissions set for
 later use.
                        localIntranet = CType(namedPermission.Current, NamedPermissionSet)
                    End If
                End While
            End If
        End While

    End Sub 'FindNamedPermissionSet
End Class 'MySecurityManager
<Serializable()> _
Public Class CustomEvidenceType

    Public Sub New()

    End Sub 'New

    Public Overrides Function
 ToString() As String
        Return "CustomEvidenceType"

    End Function 'ToString
End Class 'CustomEvidenceType

C#

// To replace the default security manager with MySecurityManager, add
 the 
// assembly to the GAC and call MySecurityManager in the
// custom implementation of the AppDomainManager.

using System;
using System.Collections;
using System.Net;
using System.Reflection;
using System.Security;
using System.Security.Permissions;
using System.Security.Policy;
using System.Security.Principal;
using System.Threading;
using System.Runtime.InteropServices;
using System.Runtime.Hosting;

[assembly: System.Security.AllowPartiallyTrustedCallersAttribute()]
namespace MyNamespace
{
    [Serializable()]
       [SecurityPermissionAttribute(SecurityAction.Demand, Flags=SecurityPermissionFlag.Infrastructure)]
    public class MySecurityManager : HostSecurityManager
    {
        public MySecurityManager()
        {
            Console.WriteLine(" Creating MySecurityManager.");
        }

        private PolicyLevel myDomainPolicy = null;
        public override PolicyLevel DomainPolicy
        {
            get
            {
                if (AppDomain.CurrentDomain.FriendlyName == "DefaultDomain"
 ||
                    AppDomain.CurrentDomain.FriendlyName == "Compilation Domain")
                    return null;

                if (myDomainPolicy == null)
                    myDomainPolicy = CreateAppDomainPolicy();
                return myDomainPolicy;
            }
        }

        private HostSecurityManagerOptions hostFlags = HostSecurityManagerOptions.HostDetermineApplicationTrust
 |
                                                   HostSecurityManagerOptions.HostAssemblyEvidence;
        public override HostSecurityManagerOptions Flags
        {
            get
            {
                return hostFlags;
            }
        }

        public override Evidence ProvideAssemblyEvidence(Assembly
 loadedAssembly, Evidence evidence)
        {
            Console.WriteLine("Provide assembly evidence for:
 " + (loadedAssembly == null ? "Unknown" : loadedAssembly.ToString())
 + ".");
            if (evidence == null)
                return null;

            evidence.AddAssembly(new CustomEvidenceType());
            return evidence;
        }
        public override Evidence ProvideAppDomainEvidence(Evidence
 evidence)
        {
            Console.WriteLine("Provide evidence for the "
 + AppDomain.CurrentDomain.FriendlyName + " AppDomain." );
            if (evidence == null)
                return null;

            evidence.AddHost(new CustomEvidenceType());
            return evidence;
        }

        [SecurityPermissionAttribute(SecurityAction.Demand, Execution = true)]
        [SecurityPermissionAttribute(SecurityAction.Assert, Unrestricted = true)]
        public override ApplicationTrust DetermineApplicationTrust(Evidence
 applicationEvidence, Evidence activatorEvidence, TrustManagerContext context)
        {
            if (applicationEvidence == null)
                throw new ArgumentNullException("applicationEvidence");

            // Get the activation context from the application evidence.
            // This HostSecurityManager does not examine the activator
 evidence
            // nor is it concerned with the TrustManagerContext;
            // it simply grants the requested grant in the application
 manifest.

            IEnumerator enumerator = applicationEvidence.GetHostEnumerator();
            ActivationArguments activationArgs = null;
            while (enumerator.MoveNext())
            {
                activationArgs = enumerator.Current as ActivationArguments;
                if (activationArgs != null)
                    break;
            }

            if (activationArgs == null)
                return null;

            ActivationContext activationContext = activationArgs.ActivationContext;
            if (activationContext == null)
                return null;

            ApplicationTrust trust = new ApplicationTrust(activationContext.Identity);
            ApplicationSecurityInfo asi = new ApplicationSecurityInfo(activationContext);
            trust.DefaultGrantSet = new PolicyStatement(asi.DefaultRequestSet,
 PolicyStatementAttribute.Nothing);
            trust.IsApplicationTrustedToRun = true;
            return trust;
        }

        private static NamedPermissionSet localIntranet;
        private static PolicyLevel CreateAppDomainPolicy()
        {
            Console.WriteLine("CreateAppDomainPolicy called.");
            PolicyLevel pLevel = PolicyLevel.CreateAppDomainLevel();
            // The root code group of the policy level combines all
            // permissions of its children.
            UnionCodeGroup rootCodeGroup;
            PermissionSet ps = new PermissionSet(PermissionState.None);
            ps.AddPermission(new SecurityPermission(SecurityPermissionFlag.Execution));
            rootCodeGroup = new UnionCodeGroup(new
 AllMembershipCondition(),
                new PolicyStatement(ps, PolicyStatementAttribute.Nothing));

            // The following code limits all code on this machine to
 local intranet permissions
            // when running in this application domain.
            FindNamedPermissionSet("LocalIntranet");
            UnionCodeGroup virtualIntranet = new UnionCodeGroup(
                new ZoneMembershipCondition(SecurityZone.MyComputer)
,
                new PolicyStatement(localIntranet,
                PolicyStatementAttribute.Nothing));
            virtualIntranet.Name = "Virtual Intranet";
            // Add the code groups to the policy level.
            rootCodeGroup.AddChild(virtualIntranet);
            pLevel.RootCodeGroup = rootCodeGroup;
            return pLevel;
        }

        private static void
 FindNamedPermissionSet(string name)
        {
            IEnumerator policyEnumerator = SecurityManager.PolicyHierarchy();

            while (policyEnumerator.MoveNext())
            {
                PolicyLevel currentLevel = (PolicyLevel)policyEnumerator.Current;

                if (currentLevel.Label == "Machine")
                {
                    IList namedPermissions = currentLevel.NamedPermissionSets;
                    IEnumerator namedPermission = namedPermissions.GetEnumerator();

                    while (namedPermission.MoveNext())
                    {
                        if (((NamedPermissionSet)namedPermission.Current).Name
 == name)
                        {
                            Console.WriteLine("Named permission set
 " +
                                ((NamedPermissionSet)namedPermission.Current).Name
 + " found.");
                            // Save the LocalIntranet permissions set
 for later use.
                            localIntranet = ((NamedPermissionSet)namedPermission.Current);
                        }
                    }
                }
            }
        }
    }
    [Serializable()]
    public class CustomEvidenceType
    {
        public CustomEvidenceType() { }

        public override string ToString()
        {
            return "CustomEvidenceType";
        }
    }
}

.NET Framework のセキュリティ

• SecurityPermission  (インフラストラクチャ コードを操作するために必要なアクセス許可)。要求値 : SecurityAction.LinkDemand; アクセス許可値 : SecurityPermissionFlag.Infrastructure
• SecurityPermission  (インフラストラクチャ コードを操作するために必要なアクセス許可)。要求値 : SecurityAction.InheritanceDemand; アクセス許可値 : SecurityPermissionFlag.Infrastructure

継承階層

System.Object
  System.Security.HostSecurityManager

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HostSecurityManager メンバ
System.Security 名前空間

HostSecurityManager コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

HostSecurityManager クラスの新しいインスタンスを初期化します。

名前空間: System.Security
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New HostSecurityManager

C#

public HostSecurityManager ()

C++

public:
HostSecurityManager ()

J#

public HostSecurityManager ()

JScript

public function HostSecurityManager ()

解説

継承時の注意 このコンストラクタで、明示的または暗黙的にアセンブリを読み込むことができるクラスのインスタンスを作成します。DomainPolicy プロパティの get アクセサ、ProvideAssemblyEvidence メソッド、ProvideAppDomainEvidence メソッドは、アセンブリが読み込まれるたびに呼び出されます。これ以降、アセンブリが読み込まれると循環参照が発生します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HostSecurityManager クラス
HostSecurityManager メンバ
System.Security 名前空間

HostSecurityManager プロパティ

パブリック プロパティ

	名前	説明
	DomainPolicy	派生クラスでオーバーライドされると、現在のアプリケーション ドメインのセキュリティ ポリシーを取得します。
	Flags	ホストにとって重要なセキュリティ ポリシー コンポーネントを表すフラグを取得します。

参照

関連項目

HostSecurityManager クラス
System.Security 名前空間

HostSecurityManager メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	DetermineApplicationTrust	アプリケーションを実行するかどうかを決定します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ProvideAppDomainEvidence	読み込まれるアセンブリに対するアプリケーション ドメインの証拠を提供します。
	ProvideAssemblyEvidence	読み込まれるアセンブリに対するアセンブリの証拠を提供します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ResolvePolicy	指定した証拠に基づいて、コードに与えるアクセス許可を決定します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

HostSecurityManager クラス
System.Security 名前空間

HostSecurityManager メンバ

アプリケーション ドメインのセキュリティ動作の制御およびカスタマイズを実行できるようにします。

HostSecurityManager データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	HostSecurityManager	HostSecurityManager クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	DomainPolicy	派生クラスでオーバーライドされると、現在のアプリケーション ドメインのセキュリティ ポリシーを取得します。
	Flags	ホストにとって重要なセキュリティ ポリシー コンポーネントを表すフラグを取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	DetermineApplicationTrust	アプリケーションを実行するかどうかを決定します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ProvideAppDomainEvidence	読み込まれるアセンブリに対するアプリケーション ドメインの証拠を提供します。
	ProvideAssemblyEvidence	読み込まれるアセンブリに対するアセンブリの証拠を提供します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ResolvePolicy	指定した証拠に基づいて、コードに与えるアクセス許可を決定します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

HostSecurityManager クラス
System.Security 名前空間