NetCodeGroup Klass

Definition

public ref class NetCodeGroup sealed : System::Security::Policy::CodeGroup

public sealed class NetCodeGroup : System.Security.Policy.CodeGroup

[System.Serializable]
public sealed class NetCodeGroup : System.Security.Policy.CodeGroup

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class NetCodeGroup : System.Security.Policy.CodeGroup

type NetCodeGroup = class
    inherit CodeGroup

[<System.Serializable>]
type NetCodeGroup = class
    inherit CodeGroup

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type NetCodeGroup = class
    inherit CodeGroup

Public NotInheritable Class NetCodeGroup
Inherits CodeGroup

Arv

Object

CodeGroup

NetCodeGroup

Attribut

SerializableAttribute ComVisibleAttribute

Exempel

Följande kodexempel visar hur du skapar och NetCodeGroup lägger till CodeConnectAccess objekt för kod som laddas ned med hjälp av HTTP-schemat.

static void SetNetCodeGroupAccess()
{
    String^ userPolicyLevel = "User";
    // Locate the User policy level.
    PolicyLevel^ level = nullptr;
    System::Collections::IEnumerator^ ph = 
        System::Security::SecurityManager::PolicyHierarchy();
    while(ph->MoveNext())
    {
        level = (PolicyLevel^)ph->Current;
        if (level->Label == userPolicyLevel)
        {
            break;       
        }
    }
    if (level->Label != userPolicyLevel)
        throw gcnew ApplicationException("Could not find User policy level.");

    IMembershipCondition^ membership =
        gcnew UrlMembershipCondition("http://www.contoso.com/*");
    NetCodeGroup^ codeGroup = gcnew NetCodeGroup(membership);
    // Delete default settings.
    codeGroup->ResetConnectAccess();
    // Create an object that represents access to the FTP scheme and 
    // default port.
    CodeConnectAccess^ CodeAccessFtp = 
        gcnew CodeConnectAccess(Uri::UriSchemeFtp, 
        CodeConnectAccess::DefaultPort);
    // Create an object that represents access to the HTTPS scheme 
    // and default port.
    CodeConnectAccess^ CodeAccessHttps = 
        gcnew CodeConnectAccess(Uri::UriSchemeHttps, 
        CodeConnectAccess::DefaultPort);
    // Create an object that represents access to the origin 
    // scheme and port.
    CodeConnectAccess^ CodeAccessOrigin = 
        CodeConnectAccess::CreateOriginSchemeAccess
        (CodeConnectAccess::OriginPort);
    // Add connection access objects to the NetCodeGroup object.
    codeGroup->AddConnectAccess(Uri::UriSchemeHttp, CodeAccessFtp);
    codeGroup->AddConnectAccess(Uri::UriSchemeHttp, CodeAccessHttps);
    codeGroup->AddConnectAccess(Uri::UriSchemeHttp, CodeAccessOrigin);
    // Provide name and description information for caspol.exe tool.
    codeGroup->Name = "ContosoHttpCodeGroup";
    codeGroup->Description = "Code originating from contoso.com can" +
        " connect back using the FTP or HTTPS.";
    // Add the code group to the User policy's root node.
    level->RootCodeGroup->AddChild(codeGroup);
    // Save the changes to the policy level.
    System::Security::SecurityManager::SavePolicy();
}

public static void SetNetCodeGroupAccess()
{
    const string userPolicyLevel = "User";
    // Locate the User policy level.
    PolicyLevel level = null;
    System.Collections.IEnumerator ph =
        System.Security.SecurityManager.PolicyHierarchy();
    while(ph.MoveNext())
    {
        level = (PolicyLevel)ph.Current;
        if( level.Label == userPolicyLevel )
        {
            break;
        }
    }
    if (level.Label != userPolicyLevel)
        throw new ApplicationException("Could not find User policy level.");

    IMembershipCondition membership =
        new UrlMembershipCondition(@"http://www.contoso.com/*");
    NetCodeGroup codeGroup = new NetCodeGroup(membership);
    // Delete default settings.
    codeGroup.ResetConnectAccess();
    // Create an object that represents access to the FTP scheme and default port.
    CodeConnectAccess a1 = new CodeConnectAccess(Uri.UriSchemeFtp, CodeConnectAccess.DefaultPort);
    // Create an object that represents access to the HTTPS scheme and default port.
    CodeConnectAccess a2 = new CodeConnectAccess(Uri.UriSchemeHttps, CodeConnectAccess.DefaultPort);
    // Create an object that represents access to the origin scheme and port.
    CodeConnectAccess a3 = CodeConnectAccess.CreateOriginSchemeAccess(CodeConnectAccess.OriginPort);
    // Add connection access objects to the NetCodeGroup object.
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a1);
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a2);
    codeGroup.AddConnectAccess(Uri.UriSchemeHttp, a3);
    // Provide name and description information for caspol.exe tool.
    codeGroup.Name = "ContosoHttpCodeGroup";
    codeGroup.Description = "Code originating from contoso.com can connect back using the FTP or HTTPS.";
    // Add the code group to the User policy's root node.
    level.RootCodeGroup.AddChild(codeGroup);
    // Save the changes to the policy level.
    System.Security.SecurityManager.SavePolicy();
}

Kommentarer

Kodgrupper är byggstenarna i säkerhetsprincipen för kodåtkomst. Varje principnivå består av en rotkodsgrupp som kan ha en eller flera underordnade kodgrupper. Varje underordnad kodgrupp kan ha egna underordnade kodgrupper. Det här beteendet sträcker sig till valfritt antal nivåer och bildar ett träd. Varje kodgrupp har ett medlemskapsvillkor som avgör om en viss sammansättning tillhör gruppen, baserat på bevisen för den sammansättningen. Endast kodgrupper vars medlemskapsvillkor matchar en viss sammansättning, tillsammans med deras underordnade kodgrupper, tillämpar säkerhetsprincip för kodåtkomst.

NetCodeGroup har samma kopplingssemantik som UnionCodeGroupför . Den utgör en union av objekten i PolicyStatement alla matchande underordnade kodgrupper och den PolicyStatement genererar från indatabeviset Url . Returnerar dock NetCodeGroup en behörighet som innehåller en dynamiskt beräknad WebPermission behörighet som ger åtkomst till den plats som koden körs från. UnionCodeGroup Returnerar helt enkelt en statisk behörighetsuppsättning.

När en NetCodeGroup skapas innehåller den standardreglerna för anslutningsåtkomst som visas i följande tabell.

Du kan styra schemat och porten som koden tillåts använda när du ansluter tillbaka till ursprungsplatsen genom att skicka ett CodeConnectAccess objekt med lämpliga Scheme värden och Port egenskapsvärden till AddConnectAccess metoden. Du kan skapa en anslutningsåtkomstregel som gäller när ursprungsschemat inte finns i beviset eller inte identifieras genom att AbsentOriginScheme ange ("") som schema. Du kan också skapa en anslutningsåtkomstregel som gäller när det inte finns någon anslutningsåtkomstregel med ett matchande schema genom att AnyOtherOriginScheme ange ("*") som schema.