EventWaitHandleSecurity Classe

Définition

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

Héritage

Object

ObjectSecurity

CommonObjectSecurity

NativeObjectSecurity

EventWaitHandleSecurity

Attributs

SecurityCriticalAttribute

Exemples

L’exemple de code suivant illustre la séparation entre Allow les règles et Deny les règles, et montre la combinaison de droits dans des règles compatibles. L’exemple crée un EventWaitHandleSecurity objet, ajoute des règles qui autorisent et refusent différents droits pour l’utilisateur actuel, et affiche la paire de règles résultante. L’exemple autorise ensuite de nouveaux droits pour l’utilisateur actuel et affiche le résultat, montrant que les nouveaux droits sont fusionnés avec la règle existante 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

Remarques

Un EventWaitHandleSecurity objet spécifie les droits d’accès pour un handle d’attente système nommé et spécifie également la façon dont les tentatives d’accès sont auditées. Les droits d’accès au handle d’attente sont exprimés sous forme de règles, chaque règle d’accès étant représentée par un EventWaitHandleAccessRule objet . Chaque règle d’audit est représentée par un EventWaitHandleAuditRule objet .

Cela reflète le système de sécurité Windows sous-jacent, dans lequel chaque objet sécurisable a au plus une liste de contrôle d’accès discrétionnaire (DACL) qui contrôle l’accès à l’objet sécurisé, et au plus une liste de contrôle d’accès système (SACL) qui spécifie les tentatives d’accès auditées. Les listes DACL et SACL sont des listes ordonnées d’entrées de contrôle d’accès (ACE) qui spécifient l’accès et l’audit pour les utilisateurs et les groupes. Un EventWaitHandleAccessRule objet ou EventWaitHandleAuditRule peut représenter plusieurs ACE.

Les EventWaitHandleSecurityclasses , EventWaitHandleAccessRuleet EventWaitHandleAuditRule masquent les détails d’implémentation des listes de contrôle d’accès et des ACL. Ils vous permettent d’ignorer les dix-sept types ACE différents et la complexité de la gestion correcte de l’héritage et de la propagation des droits d’accès. Ces objets sont également conçus pour éviter les erreurs courantes de contrôle d’accès suivantes :

• Création d’un descripteur de sécurité avec un DACL Null. Une référence Null à une liste de contrôle d’accès permet à tout utilisateur d’ajouter des règles d’accès à un objet, ce qui peut entraîner une attaque par déni de service. Un nouvel EventWaitHandleSecurity objet commence toujours par une liste DACL vide, qui refuse tout accès à tous les utilisateurs.

• Violation de l’ordre canonique des AE. Si la liste ACE dans la liste DACL n’est pas conservée dans l’ordre canonique, les utilisateurs peuvent avoir par inadvertance l’accès à l’objet sécurisé. Par exemple, les droits d’accès refusés doivent toujours apparaître avant les droits d’accès autorisés. EventWaitHandleSecurity les objets conservent l’ordre correct en interne.

• Manipulation des indicateurs de descripteur de sécurité, qui doivent être sous contrôle resource manager uniquement.

• Création de combinaisons non valides d’indicateurs ACE.

• Manipulation des AE hérités. L’héritage et la propagation sont gérés par le gestionnaire de ressources, en réponse aux modifications que vous apportez aux règles d’accès et d’audit.

• Insertion d’ACL sans signification dans des listes de contrôle d’accès.

Les seules fonctionnalités non prises en charge par les objets de sécurité .NET sont des activités dangereuses qui doivent être évitées par la majorité des développeurs d’applications, telles que les suivantes :

• Tâches de bas niveau qui sont normalement effectuées par le gestionnaire de ressources.

• Ajout ou suppression d’entrées de contrôle d’accès d’une manière qui ne conserve pas l’ordre canonique.

Pour modifier la sécurité du contrôle d’accès Windows pour un handle d’attente nommé, utilisez la EventWaitHandle.GetAccessControl méthode pour obtenir l’objet EventWaitHandleSecurity . Modifiez l’objet de sécurité en ajoutant et en supprimant des règles, puis utilisez la EventWaitHandle.SetAccessControl méthode pour le rattacher.

Pour copier la sécurité du contrôle d’accès d’un handle d’attente vers un autre, utilisez la EventWaitHandle.GetAccessControl méthode pour obtenir un objet représentant les règles d’accès EventWaitHandleSecurity et d’audit du premier handle d’attente, puis utilisez la EventWaitHandle.SetAccessControl méthode ou un constructeur qui accepte un EventWaitHandleSecurity objet pour affecter ces règles au deuxième handle d’attente.

Les utilisateurs ayant investi dans le langage de définition de descripteur de sécurité (SDDL) peuvent utiliser la SetSecurityDescriptorSddlForm méthode pour définir des règles d’accès pour un handle d’attente nommé et la GetSecurityDescriptorSddlForm méthode pour obtenir une chaîne qui représente les règles d’accès au format SDDL. Cela n’est pas recommandé pour le nouveau développement.

Constructeurs

Propriétés

Méthodes

S’applique à

Voir aussi

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