ZoneIdentityPermission Class
Assembly: mscorlib (in mscorlib.dll)
'Declaration <SerializableAttribute> _ <ComVisibleAttribute(True)> _ Public NotInheritable Class ZoneIdentityPermission Inherits CodeAccessPermission 'Usage Dim instance As ZoneIdentityPermission
/** @attribute SerializableAttribute() */ /** @attribute ComVisibleAttribute(true) */ public final class ZoneIdentityPermission extends CodeAccessPermission
SerializableAttribute ComVisibleAttribute(true) public final class ZoneIdentityPermission extends CodeAccessPermission
This permission can determine whether calling code is from a certain zone. Zones are configured according to the Microsoft Internet Explorer options, and are mapped from URL by Internet Explorer's IInternetSecurityManager and related APIs. Only exact zone matches are defined for the permission; a URL can only belong to one zone.
-
Local intranet zone: The Local intranet zone is used for content located on a company's intranet. Because the servers are within a company's firewall, content on the intranet is assigned a higher level of trust.
-
Trusted sites zone: The Trusted sites zone is used for content located on Web sites that are considered more reputable or trustworthy than other sites on the Internet. Users can use this zone to assign a higher level of trust to specific Internet sites. The URLs of these trusted Web sites need to be mapped into this zone by the user. By default, sites in the Trusted sites zone receive no higher trust than those in the Internet zone. A user or company needs to change the level of trust granted to this zone if they want the sites it contains to be given a higher level of trust.
-
Internet zone: The Internet zone is used for the Web sites on the Internet that do not belong to another zone. The default settings allow code downloaded from these sites only minimal access to resources on the user's computer. Web sites that are not mapped into other zones automatically fall into this zone.
-
Restricted sites zone: The Restricted sites zone is used for Web sites that contain content that could cause, or could have previously caused, problems when downloaded. This zone could be used to prevent code downloaded from these sites from running on the user's computer. The URLs of these untrusted Web sites need to be mapped into this zone by the user.
-
Local Machine zone: The Local Machine zone is an implicit zone that is used for content that exists on the user's computer. The content found on the user's computer, except for content cached by Internet Explorer on the local system, is treated with a very high level of trust.
Note |
|---|
| In the .NET Framework versions 1.0 and 1.1, identity permissions cannot have an Unrestricted permission state value. In the .NET Framework version 2.0, identity permissions can have any permission state value. This means that in version 2.0, identity permissions have the same behavior as permissions that implement the IUnrestrictedPermission interface. For information on executing version 2.0 applications with version 1.1 CAS policy, see <legacyV1CASPolicy> Element. |
Imports System Imports System.Security Imports System.Security.Permissions Imports Microsoft.VisualBasic Module Module1 Public Class ZoneIdentityDemo ' IsSubsetOf determines whether the current permission is a subset of the specified permission. Private Function IsSubsetOfDemo() As Boolean Dim returnValue As Boolean = True Dim zone1, zone2 As SecurityZone Dim zoneIdPerm1, zoneIdPerm2 As ZoneIdentityPermission Dim zoneGen1 As New zoneGenerator() Dim zoneGen2 As New zoneGenerator() zoneGen1.ResetIndex() While zoneGen1.CreateZone(zone1) zoneIdPerm1 = New ZoneIdentityPermission(zone1) zoneGen2.ResetIndex() Console.WriteLine("********************************************************" & ControlChars.Cr) While zoneGen2.CreateZone(zone2) zoneIdPerm2 = New ZoneIdentityPermission(zone2) Try If zoneIdPerm1.IsSubsetOf(zoneIdPerm2) Then Console.WriteLine((zoneIdPerm1.SecurityZone.ToString() & _ " is a subset of " & zoneIdPerm2.SecurityZone.ToString())) Else Console.WriteLine((zoneIdPerm1.SecurityZone.ToString() & _ " is not a subset of " & zoneIdPerm2.SecurityZone.ToString())) End If Catch e As Exception Console.WriteLine(("An exception was thrown for subset :" & _ zoneIdPerm1.ToString() & ControlChars.Cr & zoneIdPerm2.ToString() & _ ControlChars.Cr & e.ToString())) returnValue = False End Try ContinueWhile2: End While ContinueWhile1: End While Return returnValue End Function 'IsSubsetOfDemo ' Union creates a new permission that is the union of the current permission and the specified permission. Private Function UnionDemo() As Boolean Dim returnValue As Boolean = True Dim zone1, zone2 As SecurityZone Dim zoneIdPerm1, zoneIdPerm2 As ZoneIdentityPermission Dim zoneIdPerm3 As IPermission Dim zoneGen1 As New ZoneGenerator() Dim zoneGen2 As New ZoneGenerator() zoneGen1.ResetIndex() While zoneGen1.CreateZone(zone1) zoneIdPerm1 = New ZoneIdentityPermission(zone1) Console.WriteLine("**********************************************************" & ControlChars.Cr) zoneGen2.ResetIndex() Try While zoneGen2.CreateZone(zone2) zoneIdPerm2 = New ZoneIdentityPermission(zone2) zoneIdPerm3 = CType(zoneIdPerm1.Union(zoneIdPerm2), ZoneIdentityPermission) zoneIdPerm3 = zoneIdPerm1.Union(zoneIdPerm2) If zoneIdPerm3 Is Nothing Then Console.WriteLine(("The union of " & zone1.ToString() & " and " & _ zone2.ToString() & " is null.")) Else Console.WriteLine(("The union of " & zoneIdPerm1.SecurityZone.ToString() & " and " _ & zoneIdPerm2.SecurityZone.ToString() & " = " _ & CType(zoneIdPerm3, Object).SecurityZone.ToString())) End If ContinueWhile2: End While Catch e As Exception Console.WriteLine(e.Message) End Try ContinueWhile1: End While Return returnValue End Function 'UnionDemo ' Intersect creates and returns a new permission that is the intersection of the current ' permission and the permission specified. Private Function IntersectDemo() As Boolean Dim returnValue As Boolean = True Dim zone1, zone2 As SecurityZone Dim zoneIdPerm1, zoneIdPerm2, zoneIdPerm3 As ZoneIdentityPermission Dim zoneGen1 As New ZoneGenerator() Dim zoneGen2 As New ZoneGenerator() zoneGen1.ResetIndex() While zoneGen1.CreateZone(zone1) zoneIdPerm1 = New ZoneIdentityPermission(zone1) Console.WriteLine("**********************************************************" & ControlChars.Cr) zoneGen2.ResetIndex() While zoneGen2.CreateZone(zone2) zoneIdPerm2 = New ZoneIdentityPermission(zone2) zoneIdPerm3 = CType(zoneIdPerm1.Intersect(zoneIdPerm2), ZoneIdentityPermission) If Not (zoneIdPerm3 Is Nothing) Then Console.WriteLine(("The intersection of " & zone1.ToString() & " and " & _ zone2.ToString() & " = " & CType(zoneIdPerm3, Object).SecurityZone.ToString())) Else Console.WriteLine(("The intersection of " & zone1.ToString() & " and " & _ zone2.ToString() & " is null.")) End If ContinueWhile2: End While ContinueWhile1: End While Return returnValue End Function 'IntersectDemo 'Copy creates and returns an identical copy of the current permission. Private Function CopyDemo() As Boolean Dim returnValue As Boolean = True Dim zone1 As SecurityZone Dim zoneIdPerm1, zoneIdPerm2 As ZoneIdentityPermission Dim zoneGen1 As New ZoneGenerator() Dim zoneGen2 As New ZoneGenerator() zoneGen1.ResetIndex() While zoneGen1.CreateZone(zone1) zoneIdPerm1 = New ZoneIdentityPermission(zone1) zoneGen2.ResetIndex() Console.WriteLine("********************************************************" & ControlChars.Cr) Try zoneIdPerm2 = CType(zoneIdPerm1.Copy(), ZoneIdentityPermission) Console.WriteLine(("Result of copy = " & zoneIdPerm2.ToString())) Catch e As Exception Console.WriteLine(("Copy failed :" & zoneIdPerm1.ToString() & e.ToString())) GoTo ContinueWhile1 End Try ContinueWhile1: End While Return returnValue End Function 'CopyDemo ' ToXml creates an XML encoding of the permission and its current state; ' FromXml reconstructs a permission with the specified state from the XML encoding. Private Function ToFromXmlDemo() As Boolean Dim returnValue As Boolean = True Dim zone1 As SecurityZone Dim zoneIdPerm1, zoneIdPerm2 As ZoneIdentityPermission Dim zoneGen1 As New ZoneGenerator() Dim zoneGen2 As New ZoneGenerator() zoneGen1.ResetIndex() While zoneGen1.CreateZone(zone1) zoneIdPerm1 = New ZoneIdentityPermission(zone1) Console.WriteLine("********************************************************" & ControlChars.Cr) zoneGen2.ResetIndex() Try zoneIdPerm2 = New ZoneIdentityPermission(PermissionState.None) zoneIdPerm2.FromXml(zoneIdPerm1.ToXml()) Console.WriteLine(("Result of ToFromXml = " & zoneIdPerm2.ToString())) Catch e As Exception Console.WriteLine(("ToFromXml failed :" & zoneIdPerm1.ToString() & e.ToString())) GoTo ContinueWhile1 End Try ContinueWhile1: End While Return returnValue End Function 'ToFromXmlDemo ' Invoke all demos. Public Function RunDemo() As Boolean Dim returnCode As Boolean = True Dim tempReturnCode As Boolean ' Call the IsSubsetOf demo. If IsSubsetOfDemo() Then Console.Out.WriteLine("IsSubsetOf demo completed successfully.") tempReturnCode = True Else Console.Out.WriteLine("IsSubsetOf demo failed.") tempReturnCode = False End If returnCode = tempReturnCode And returnCode ' Call the Union demo. If UnionDemo() Then Console.Out.WriteLine("Union demo completed successfully.") tempReturnCode = True Else Console.Out.WriteLine("Union demo failed.") tempReturnCode = False End If returnCode = tempReturnCode And returnCode ' Call the Intersect demo. If IntersectDemo() Then Console.Out.WriteLine("Intersect demo completed successfully.") tempReturnCode = True Else Console.Out.WriteLine("Intersect demo failed.") tempReturnCode = False End If returnCode = tempReturnCode And returnCode ' Call the Copy demo. If CopyDemo() Then Console.Out.WriteLine("Copy demo completed successfully.") tempReturnCode = True Else Console.Out.WriteLine("Copy demo failed.") tempReturnCode = False End If returnCode = tempReturnCode And returnCode ' Call the ToFromXml demo. If ToFromXmlDemo() Then Console.Out.WriteLine("ToFromXml demo completed successfully.") tempReturnCode = True Else Console.Out.WriteLine("ToFromXml demo failed.") tempReturnCode = False End If returnCode = tempReturnCode And returnCode Return returnCode End Function ' Test harness. Public Overloads Shared Sub Main(ByVal args() As [String]) Try Dim democase As New ZoneIdentityDemo() Dim returnCode As Boolean = democase.RunDemo() If returnCode Then Console.Out.WriteLine("ZoneIdentityPermission demo completed successfully.") Console.Out.WriteLine("Press the Enter key to exit.") Dim consoleInput As String = Console.ReadLine() System.Environment.ExitCode = 100 Else Console.Out.WriteLine("ZoneIdentityPermission demo failed.") Console.Out.WriteLine("Press the Enter key to exit.") Dim consoleInput As String = Console.ReadLine() System.Environment.ExitCode = 101 End If Catch e As Exception Console.Out.WriteLine("ZoneIdentityPermission demo failed.") Console.WriteLine(e.ToString()) Console.Out.WriteLine("Press the Enter key to exit.") Dim consoleInput As String = Console.ReadLine() System.Environment.ExitCode = 101 End Try End Sub 'Main End Class 'ZoneIdentityDemo _ ' This class generates ZoneIdentityPermission objects. Friend Class ZoneGenerator Private myZone As SecurityZone() = {SecurityZone.NoZone, _ SecurityZone.Internet, _ SecurityZone.Intranet, _ SecurityZone.MyComputer, _ SecurityZone.Untrusted, _ SecurityZone.Trusted} Private zoneIndex As Integer = 0 Public Sub New() ResetIndex() End Sub 'New Public Sub ResetIndex() zoneIndex = 0 End Sub 'ResetIndex ' CreateZone creates ZoneIdentityPermission objects. Public Function CreateZone(ByRef zone As SecurityZone) As Boolean If zoneIndex >= myZone.Length Then zone = SecurityZone.NoZone zoneIndex = zoneIndex + 1 Return False End If zone = myZone(zoneIndex) zoneIndex = zoneIndex + 1 Return True End Function 'CreateZone ' End of ZoneGenerator. End Module
// This sample demonstrates the IsSubsetOf, Union, Intersect,
// Copy, ToXml and FromXml methods
// of the ZoneIdentityPermission class.
import System.*;
import System.Security.*;
import System.Security.Permissions .* ;
/** @assembly CLSCompliant(true)
*/
public class ZoneIdentityDemo
{
// IsSubsetOf determines whether the current permission
// is a subset of the specified permission.
private boolean IsSubsetOfDemo()
{
boolean returnValue = true;
SecurityZone zone1[] = new SecurityZone[1];
SecurityZone zone2[] = new SecurityZone[1];
ZoneIdentityPermission zoneIdPerm1[] = new ZoneIdentityPermission[1];
ZoneIdentityPermission zoneIdPerm2[] = new ZoneIdentityPermission[1];
ZoneGenerator zoneGen1 = new ZoneGenerator();
ZoneGenerator zoneGen2 = new ZoneGenerator();
zoneGen1.ResetIndex();
while (zoneGen1.CreateZone(zoneIdPerm1, zone1)) {
if (zoneIdPerm1[0] == null) {
continue;
}
zoneGen2.ResetIndex();
Console.WriteLine("****************************"
+ "****************************\n");
while (zoneGen2.CreateZone(zoneIdPerm2, zone2)) {
if (zoneIdPerm2[0] == null) {
continue;
}
try {
if (zoneIdPerm1[0].IsSubsetOf(zoneIdPerm2[0])) {
Console.WriteLine((zoneIdPerm1[0].get_SecurityZone()
+ " is a subset of "
+ zoneIdPerm2[0].get_SecurityZone()));
}
else {
Console.WriteLine((zoneIdPerm1[0].get_SecurityZone()
+ " is not a subset of " +
zoneIdPerm2[0].get_SecurityZone()));
}
}
catch (System.Exception e) {
Console.WriteLine(("An exception was thrown for subset :"
+ zoneIdPerm1[0] + "\n" + zoneIdPerm2[0] + "\n" + e));
returnValue = false;
}
}
}
return returnValue;
} //IsSubsetOfDemo
// Union creates a new permission that is the union of the
// current permission and the specified permission.
private boolean UnionDemo()
{
boolean returnValue = true;
SecurityZone zone1[] = new SecurityZone[1];
SecurityZone zone2[] = new SecurityZone[1];
ZoneIdentityPermission zoneIdPerm1[] = new ZoneIdentityPermission[1];
ZoneIdentityPermission zoneIdPerm2[] = new ZoneIdentityPermission[1];
IPermission zoneIdPerm3;
ZoneGenerator zoneGen1 = new ZoneGenerator();
ZoneGenerator zoneGen2 = new ZoneGenerator();
zoneGen1.ResetIndex();
while (zoneGen1.CreateZone(zoneIdPerm1, zone1)) {
if (zoneIdPerm1[0] == null) {
continue;
}
Console.WriteLine("***************************************"
+ "*******************\n");
zoneGen2.ResetIndex();
while (zoneGen2.CreateZone(zoneIdPerm2, zone2)) {
if (zoneIdPerm2[0] == null) {
continue;
}
zoneIdPerm3 = ((ZoneIdentityPermission)(zoneIdPerm1[0].
Union(zoneIdPerm2[0])));
zoneIdPerm3 = zoneIdPerm1[0].Union(zoneIdPerm2[0]);
if (zoneIdPerm3 == null) {
Console.WriteLine(("The union of " + zone1[0] + " and "
+ zone2[0] + " is null."));
}
else {
Console.WriteLine(("The union of " + zoneIdPerm1[0].
get_SecurityZone() + " and "
+ zoneIdPerm2[0].get_SecurityZone() + " = "
+ ((ZoneIdentityPermission)(zoneIdPerm3)).
get_SecurityZone().ToString()));
}
}
}
return returnValue;
} //UnionDemo
// Intersect creates and returns a new permission that
// is the intersection of the current
// permission and the permission specified.
private boolean IntersectDemo()
{
boolean returnValue = true;
SecurityZone zone1[] = new SecurityZone[1];
SecurityZone zone2[] = new SecurityZone[1];
ZoneIdentityPermission zoneIdPerm1[] = new ZoneIdentityPermission[1];
ZoneIdentityPermission zoneIdPerm2[] = new ZoneIdentityPermission[1];
ZoneIdentityPermission zoneIdPerm3 = null;
ZoneGenerator zoneGen1 = new ZoneGenerator();
ZoneGenerator zoneGen2 = new ZoneGenerator();
zoneGen1.ResetIndex();
while (zoneGen1.CreateZone(zoneIdPerm1, zone1)) {
if (zoneIdPerm1[0] == null) {
continue;
}
Console.WriteLine("**********************************"
+ "************************\n");
zoneGen2.ResetIndex();
while (zoneGen2.CreateZone(zoneIdPerm2, zone2)) {
if (zoneIdPerm2[0] == null) {
continue;
}
zoneIdPerm3 = ((ZoneIdentityPermission)(zoneIdPerm1[0].
Intersect(zoneIdPerm2[0])));
if (zoneIdPerm3 != null) {
Console.WriteLine(("The intersection of " + zone1[0]
+ " and " + zone2[0] + " = " +
((ZoneIdentityPermission)(zoneIdPerm3)).
get_SecurityZone().ToString()));
}
else {
Console.WriteLine(("The intersection of " + zone1[0]
+ " and " + zone2[0] + " is null."));
}
}
}
return returnValue;
} //IntersectDemo
//Copy creates and returns an identical copy of the current permission.
private boolean CopyDemo()
{
boolean returnValue = true;
SecurityZone zone1[] = new SecurityZone[1];
ZoneIdentityPermission zoneIdPerm1[] = new ZoneIdentityPermission[1];
ZoneIdentityPermission zoneIdPerm2 = null;
ZoneGenerator zoneGen1 = new ZoneGenerator();
ZoneGenerator zoneGen2 = new ZoneGenerator();
zoneGen1.ResetIndex();
while (zoneGen1.CreateZone(zoneIdPerm1, zone1)) {
if (zoneIdPerm1[0] == null) {
continue;
}
zoneGen2.ResetIndex();
Console.WriteLine("**********************************"
+ "**********************\n");
try {
zoneIdPerm2 = ((ZoneIdentityPermission)(zoneIdPerm1[0].Copy()));
Console.WriteLine(("Result of copy = "
+ zoneIdPerm2.ToString()));
}
catch (System.Exception e) {
Console.WriteLine(("Copy failed :"
+ zoneIdPerm1[0].ToString() + e));
continue;
}
}
return returnValue;
} //CopyDemo
// ToXml creates an XML encoding of the permission and its current state;
// FromXml reconstructs a permission with the specified
// state from the XML encoding.
private boolean ToFromXmlDemo()
{
boolean returnValue = true;
SecurityZone zone1[] = new SecurityZone[1];
ZoneIdentityPermission zoneIdPerm1[] = new
ZoneIdentityPermission[1];
ZoneIdentityPermission zoneIdPerm2 = null;
ZoneGenerator zoneGen1 = new ZoneGenerator();
ZoneGenerator zoneGen2 = new ZoneGenerator();
zoneGen1.ResetIndex();
while (zoneGen1.CreateZone(zoneIdPerm1, zone1)) {
if (zoneIdPerm1[0] == null) {
continue;
}
Console.WriteLine("*********************************"
+ "***********************\n");
zoneGen2.ResetIndex();
try {
zoneIdPerm2 = new ZoneIdentityPermission(PermissionState.None);
zoneIdPerm2.FromXml(zoneIdPerm1[0].ToXml());
Console.WriteLine(("Result of ToFromXml = "
+ zoneIdPerm2.ToString()));
}
catch (System.Exception e) {
Console.WriteLine(("ToFromXml failed :"
+ zoneIdPerm1[0].ToString() + e));
continue;
}
}
return returnValue;
} //ToFromXmlDemo
// Invoke all demos.
public boolean RunDemo()
{
boolean returnCode = true;
boolean tempReturnCode;
// Call the IsSubsetOf demo.
if (tempReturnCode = IsSubsetOfDemo()) {
Console.get_Out().WriteLine("IsSubsetOf demo "
+ "completed successfully.");
}
else {
Console.get_Out().WriteLine("IsSubsetOf demo failed.");
}
returnCode = tempReturnCode && returnCode;
// Call the Union demo.
if (tempReturnCode = UnionDemo()) {
Console.get_Out().WriteLine("Union demo completed successfully.");
}
else {
Console.get_Out().WriteLine("Union demo failed.");
}
returnCode = tempReturnCode && returnCode;
// Call the Intersect demo.
if (tempReturnCode = IntersectDemo()) {
Console.get_Out().WriteLine("Intersect demo "
+ " completed successfully.");
}
else {
Console.get_Out().WriteLine("Intersect demo failed.");
}
returnCode = tempReturnCode && returnCode;
// Call the Copy demo.
if (tempReturnCode = CopyDemo()) {
Console.get_Out().WriteLine("Copy demo completed successfully.");
}
else {
Console.get_Out().WriteLine("Copy demo failed.");
}
returnCode = tempReturnCode && returnCode;
// Call the ToFromXml demo.
if (tempReturnCode = ToFromXmlDemo()) {
Console.get_Out().WriteLine("ToFromXml demo "
+ "completed successfully.");
}
else {
Console.get_Out().WriteLine("ToFromXml demo failed.");
}
returnCode = tempReturnCode && returnCode;
return returnCode;
} //RunDemo
// Test harness.
public static void main(String[] args)
{
try {
ZoneIdentityDemo democase = new ZoneIdentityDemo();
boolean returnCode = democase.RunDemo();
if (returnCode) {
Console.get_Out().WriteLine("ZoneIdentityPermission"
+ " demo completed successfully.");
Console.get_Out().WriteLine("Press the Enter key to exit.");
String consoleInput = Console.ReadLine();
Environment.set_ExitCode(100);
}
else {
Console.get_Out().WriteLine("ZoneIdentityPermission"
+ " demo failed.");
Console.get_Out().WriteLine("Press the Enter key to exit.");
String consoleInput = Console.ReadLine();
Environment.set_ExitCode(101);
}
}
catch (System.Exception e) {
Console.get_Out().WriteLine("ZoneIdentityPermission demo failed.");
Console.WriteLine(e.ToString());
Console.get_Out().WriteLine("Press the Enter key to exit.");
String consoleInput = Console.ReadLine();
Environment.set_ExitCode(101);
}
} //main
} //ZoneIdentityDemo
// This class generates ZoneIdentityPermission objects.
class ZoneGenerator
{
private SecurityZone myZone[] = {
SecurityZone.NoZone, SecurityZone.Internet, SecurityZone.Intranet,
SecurityZone.MyComputer, SecurityZone.Untrusted, SecurityZone.Trusted };
private int zoneIndex = 0;
public ZoneGenerator()
{
ResetIndex();
} //ZoneGenerator
public void ResetIndex()
{
zoneIndex = 0;
} //ResetIndex
// CreateZone creates ZoneIdentityPermission objects.
public boolean CreateZone(ZoneIdentityPermission zonePerm[],
SecurityZone zone[])
{
if (zoneIndex >= myZone.length) {
zonePerm[0] = new ZoneIdentityPermission(PermissionState.None);
zone[0] = SecurityZone.NoZone;
zoneIndex++;
return false;
}
zone[0] = myZone[zoneIndex++];
try {
zonePerm[0] = new ZoneIdentityPermission(zone[0]);
return true;
}
catch (System.Exception e) {
Console.WriteLine(("Cannot create ZoneIdentityPermission: "
+ zone[0] + " " + e));
zonePerm[0] = new ZoneIdentityPermission(PermissionState.None);
zone[0] = SecurityZone.NoZone;
return true;
}
} //CreateZone
} //ZoneGenerator
System.Security.CodeAccessPermission
System.Security.Permissions.ZoneIdentityPermission
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
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.
Note