EventWaitHandleSecurity Classe

Definição

public ref class EventWaitHandleSecurity sealed : System::Security::AccessControl::NativeObjectSecurity

public sealed class EventWaitHandleSecurity : System.Security.AccessControl.NativeObjectSecurity

[System.Security.SecurityCritical]
public sealed class EventWaitHandleSecurity : System.Security.AccessControl.NativeObjectSecurity

type EventWaitHandleSecurity = class
    inherit NativeObjectSecurity

[<System.Security.SecurityCritical>]
type EventWaitHandleSecurity = class
    inherit NativeObjectSecurity

Public NotInheritable Class EventWaitHandleSecurity
Inherits NativeObjectSecurity

Herança

Object

ObjectSecurity

CommonObjectSecurity

NativeObjectSecurity

EventWaitHandleSecurity

Atributos

SecurityCriticalAttribute

Exemplos

O exemplo de código a seguir demonstra a separação entre Allow regras e Deny regras e mostra a combinação de direitos em regras compatíveis. O exemplo cria um EventWaitHandleSecurity objeto, adiciona regras que permitem e negam vários direitos para o usuário atual e exibe o par de regras resultante. Em seguida, o exemplo permite novos direitos para o usuário atual e exibe o resultado, mostrando que os novos direitos são mesclados com a regra existente Allow .

using System;
using System.Threading;
using System.Security.AccessControl;
using System.Security.Principal;

public class Example
{
    public static void Main()
    {
        // Create a string representing the current user.
        string user = Environment.UserDomainName + "\\" + 
            Environment.UserName;

        // Create a security object that grants no access.
        EventWaitHandleSecurity mSec = new EventWaitHandleSecurity();

        // Add a rule that grants the current user the 
        // right to wait on or signal the event.
        EventWaitHandleAccessRule rule = new EventWaitHandleAccessRule(user, 
            EventWaitHandleRights.Synchronize | EventWaitHandleRights.Modify, 
            AccessControlType.Allow);
        mSec.AddAccessRule(rule);

        // Add a rule that denies the current user the 
        // right to change permissions on the event.
        rule = new EventWaitHandleAccessRule(user, 
            EventWaitHandleRights.ChangePermissions, 
            AccessControlType.Deny);
        mSec.AddAccessRule(rule);

        // Display the rules in the security object.
        ShowSecurity(mSec);

        // Add a rule that allows the current user the 
        // right to read permissions on the event. This rule
        // is merged with the existing Allow rule.
        rule = new EventWaitHandleAccessRule(user, 
            EventWaitHandleRights.ReadPermissions, 
            AccessControlType.Allow);
        mSec.AddAccessRule(rule);

        ShowSecurity(mSec);
    }

    private static void ShowSecurity(EventWaitHandleSecurity security)
    {
        Console.WriteLine("\r\nCurrent access rules:\r\n");

        foreach(EventWaitHandleAccessRule ar in 
            security.GetAccessRules(true, true, typeof(NTAccount)))
        {
            Console.WriteLine("        User: {0}", ar.IdentityReference);
            Console.WriteLine("        Type: {0}", ar.AccessControlType);
            Console.WriteLine("      Rights: {0}", ar.EventWaitHandleRights);
            Console.WriteLine();
        }
    }
}

/*This code example produces output similar to following:

Current access rules:

        User: TestDomain\TestUser
        Type: Deny
      Rights: ChangePermissions

        User: TestDomain\TestUser
        Type: Allow
      Rights: Modify, Synchronize


Current access rules:

        User: TestDomain\TestUser
        Type: Deny
      Rights: ChangePermissions

        User: TestDomain\TestUser
        Type: Allow
      Rights: Modify, ReadPermissions, Synchronize
 */

Imports System.Threading
Imports System.Security.AccessControl
Imports System.Security.Principal

Public Class Example

    Public Shared Sub Main()

        ' Create a string representing the current user.
        Dim user As String = Environment.UserDomainName _ 
            & "\" & Environment.UserName

        ' Create a security object that grants no access.
        Dim mSec As New EventWaitHandleSecurity()

        ' Add a rule that grants the current user the 
        ' right to wait on or signal the event.
        Dim rule As New EventWaitHandleAccessRule(user, _
            EventWaitHandleRights.Synchronize _
            Or EventWaitHandleRights.Modify, _
            AccessControlType.Allow)
        mSec.AddAccessRule(rule)

        ' Add a rule that denies the current user the 
        ' right to change permissions on the event.
        rule = New EventWaitHandleAccessRule(user, _
            EventWaitHandleRights.ChangePermissions, _
            AccessControlType.Deny)
        mSec.AddAccessRule(rule)

        ' Display the rules in the security object.
        ShowSecurity(mSec)

        ' Add a rule that allows the current user the 
        ' right to read permissions on the event. This rule
        ' is merged with the existing Allow rule.
        rule = New EventWaitHandleAccessRule(user, _
            EventWaitHandleRights.ReadPermissions, _
            AccessControlType.Allow)
        mSec.AddAccessRule(rule)

        ShowSecurity(mSec)

    End Sub 

    Private Shared Sub ShowSecurity(ByVal security As EventWaitHandleSecurity)
        Console.WriteLine(vbCrLf & "Current access rules:" & vbCrLf)

        For Each ar As EventWaitHandleAccessRule In _
            security.GetAccessRules(True, True, GetType(NTAccount))

            Console.WriteLine("        User: {0}", ar.IdentityReference)
            Console.WriteLine("        Type: {0}", ar.AccessControlType)
            Console.WriteLine("      Rights: {0}", ar.EventWaitHandleRights)
            Console.WriteLine()
        Next

    End Sub
End Class 

'This code example produces output similar to following:
'
'Current access rules:
'
'        User: TestDomain\TestUser
'        Type: Deny
'      Rights: ChangePermissions
'
'        User: TestDomain\TestUser
'        Type: Allow
'      Rights: Modify, Synchronize
'
'
'Current access rules:
'
'        User: TestDomain\TestUser
'        Type: Deny
'      Rights: ChangePermissions
'
'        User: TestDomain\TestUser
'        Type: Allow
'      Rights: Modify, ReadPermissions, Synchronize

Comentários

Um EventWaitHandleSecurity objeto especifica os direitos de acesso para um identificador de espera do sistema nomeado e também especifica a maneira como as tentativas de acesso são auditadas. Os direitos de acesso ao identificador de espera são expressos como regras, com cada regra de acesso representada por um EventWaitHandleAccessRule objeto . Cada regra de auditoria é representada por um EventWaitHandleAuditRule objeto .

Isso espelha o sistema de segurança subjacente do Windows, no qual cada objeto protegível tem no máximo uma DACL (lista de controle de acesso discricionário) que controla o acesso ao objeto protegido e, no máximo, uma SACL (lista de controle de acesso do sistema) que especifica quais tentativas de acesso são auditadas. O DACL e o SACL são listas ordenadas de ACE (entradas de controle de acesso) que especificam acesso e auditoria para usuários e grupos. Um EventWaitHandleAccessRule objeto ou EventWaitHandleAuditRule pode representar mais de um ACE.

As EventWaitHandleSecurityclasses , EventWaitHandleAccessRulee EventWaitHandleAuditRule ocultam os detalhes de implementação de ACLs e ACEs. Eles permitem que você ignore os dezessete tipos de ACE diferentes e a complexidade de manter corretamente a herança e a propagação de direitos de acesso. Esses objetos também são projetados para evitar os seguintes erros comuns de controle de acesso:

• Criando um descritor de segurança com uma DACL nula. Uma referência nula a um DACL permite que qualquer usuário adicione regras de acesso a um objeto, potencialmente criando um ataque de negação de serviço. Um novo EventWaitHandleSecurity objeto sempre começa com um DACL vazio, que nega todo o acesso para todos os usuários.

• Violando a ordenação canônica de ACEs. Se a lista ACE na DACL não for mantida na ordem canônica, os usuários poderão ter acesso inadvertidamente ao objeto protegido. Por exemplo, os direitos de acesso negados sempre devem aparecer antes dos direitos de acesso permitidos. EventWaitHandleSecurity os objetos mantêm a ordem correta internamente.

• Manipulando sinalizadores de descritor de segurança, que devem estar apenas sob controle do gerenciador de recursos.

• Criando combinações inválidas de sinalizadores ACE.

• Manipulando ACEs herdados. A herança e a propagação são tratadas pelo gerenciador de recursos, em resposta às alterações feitas nas regras de acesso e auditoria.

• Inserindo ACEs sem sentido em ACLs.

Os únicos recursos não compatíveis com os objetos de segurança do .NET são atividades perigosas que devem ser evitadas pela maioria dos desenvolvedores de aplicativos, como o seguinte:

• Tarefas de baixo nível que normalmente são executadas pelo gerenciador de recursos.

• Adicionar ou remover entradas de controle de acesso de maneiras que não mantêm a ordenação canônica.

Para modificar a segurança do controle de acesso do Windows para um identificador de espera nomeado, use o EventWaitHandle.GetAccessControl método para obter o EventWaitHandleSecurity objeto . Modifique o objeto de segurança adicionando e removendo regras e, em seguida, use o EventWaitHandle.SetAccessControl método para reanexá-lo.

Para copiar a segurança do controle de acesso de um identificador de espera para outro, use o EventWaitHandle.GetAccessControl método para obter um EventWaitHandleSecurity objeto que representa as regras de acesso e auditoria do primeiro identificador de espera e, em seguida, use o EventWaitHandle.SetAccessControl método , ou um construtor que aceita um EventWaitHandleSecurity objeto , para atribuir essas regras ao segundo identificador de espera.

Os usuários com um investimento na linguagem de definição de descritor de segurança (SDDL) podem usar o SetSecurityDescriptorSddlForm método para definir regras de acesso para um identificador de espera nomeado e o GetSecurityDescriptorSddlForm método para obter uma cadeia de caracteres que representa as regras de acesso no formato SDDL. Isso não é recomendado para o novo desenvolvimento.

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• EventWaitHandleAccessRule
• EventWaitHandleAuditRule
• EventWaitHandleRights
• GetAccessControl()
• SetAccessControl(EventWaitHandleSecurity)