SemaphoreSecurity Klasse

Definition

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

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

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

[System.Runtime.InteropServices.ComVisible(false)]
public sealed class SemaphoreSecurity : System.Security.AccessControl.NativeObjectSecurity

type SemaphoreSecurity = class
    inherit NativeObjectSecurity

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

[<System.Runtime.InteropServices.ComVisible(false)>]
type SemaphoreSecurity = class
    inherit NativeObjectSecurity

Public NotInheritable Class SemaphoreSecurity
Inherits NativeObjectSecurity

Vererbung

Object

ObjectSecurity

CommonObjectSecurity

NativeObjectSecurity

SemaphoreSecurity

Attribute

SecurityCriticalAttribute ComVisibleAttribute

Beispiele

Das folgende Codebeispiel veranschaulicht die Trennung zwischen Allow Regeln und Deny Regeln und zeigt die Kombination von Rechten in kompatiblen Regeln. Das Beispiel erstellt ein SemaphoreSecurity -Objekt, fügt Regeln hinzu, die verschiedene Rechte für den aktuellen Benutzer zulassen und verweigern, und zeigt das resultierende Regelpaar an. Das Beispiel lässt dann neue Rechte für den aktuellen Benutzer zu und zeigt das Ergebnis an, das zeigt, dass die neuen Rechte mit der vorhandenen Allow Regel zusammengeführt werden.

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.
        SemaphoreSecurity mSec = new SemaphoreSecurity();

        // Add a rule that grants the current user the 
        // right to enter or release the semaphore.
        SemaphoreAccessRule rule = new SemaphoreAccessRule(user, 
            SemaphoreRights.Synchronize | SemaphoreRights.Modify, 
            AccessControlType.Allow);
        mSec.AddAccessRule(rule);

        // Add a rule that denies the current user the 
        // right to change permissions on the semaphore.
        rule = new SemaphoreAccessRule(user, 
            SemaphoreRights.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 semaphore. This rule
        // is merged with the existing Allow rule.
        rule = new SemaphoreAccessRule(user, 
            SemaphoreRights.ReadPermissions, 
            AccessControlType.Allow);
        mSec.AddAccessRule(rule);

        ShowSecurity(mSec);
    }

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

        foreach(SemaphoreAccessRule 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.SemaphoreRights);
            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 SemaphoreSecurity()

        ' Add a rule that grants the current user the 
        ' right to enter or release the semaphore.
        Dim rule As New SemaphoreAccessRule(user, _
            SemaphoreRights.Synchronize _
            Or SemaphoreRights.Modify, _
            AccessControlType.Allow)
        mSec.AddAccessRule(rule)

        ' Add a rule that denies the current user the 
        ' right to change permissions on the semaphore.
        rule = New SemaphoreAccessRule(user, _
            SemaphoreRights.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 semaphore. This 
        ' rule is merged with the existing Allow rule.
        rule = New SemaphoreAccessRule(user, _
            SemaphoreRights.ReadPermissions, _
            AccessControlType.Allow)
        mSec.AddAccessRule(rule)

        ShowSecurity(mSec)

    End Sub 

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

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

            Console.WriteLine("        User: {0}", ar.IdentityReference)
            Console.WriteLine("        Type: {0}", ar.AccessControlType)
            Console.WriteLine("      Rights: {0}", ar.SemaphoreRights)
            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

Hinweise

Ein SemaphoreSecurity -Objekt gibt Zugriffsrechte für einen benannten System-Semaphor an und gibt außerdem an, wie Zugriffsversuche überwacht werden. Die Zugriffsrechte für den Semaphor werden als Regeln ausgedrückt, wobei jede Zugriffsregel durch ein SemaphoreAccessRule Objekt dargestellt wird. Jede Überwachungsregel wird durch ein SemaphoreAuditRule -Objekt dargestellt.

Dies spiegelt das zugrunde liegende Windows-Sicherheitssystem wider, in dem jedes sicherungsfähige Objekt über höchstens eine diskretionäre Zugriffssteuerungsliste (DACL) verfügt, die den Zugriff auf das geschützte Objekt steuert, und höchstens eine Systemzugriffssteuerungsliste (SACL), die angibt, welche Zugriffsversuche überwacht werden. Die DACL und SACL sind geordnete Listen von Zugriffssteuerungseinträgen (ACE), die den Zugriff und die Überwachung für Benutzer und Gruppen angeben. Ein SemaphoreAccessRule - oder SemaphoreAuditRule -Objekt kann mehrere ACE darstellen.

Die SemaphoreSecurityKlassen , SemaphoreAccessRuleund SemaphoreAuditRule blenden die Implementierungsdetails von ACLs und ACEs aus. Sie ermöglichen es Ihnen, die siebzehn verschiedenen ACE-Typen und die Komplexität der ordnungsgemäßen Aufrechterhaltung der Vererbung und Weitergabe von Zugriffsrechten zu ignorieren. Diese Objekte sind auch so konzipiert, dass sie die folgenden häufigen Zugriffssteuerungsfehler verhindern:

• Erstellen eines Sicherheitsdeskriptors mit einer NULL-DACL. Ein NULL-Verweis auf eine DACL ermöglicht jedem Benutzer das Hinzufügen von Zugriffsregeln zu einem Objekt, wodurch möglicherweise ein Denial-of-Service-Angriff erstellt wird. Ein neues SemaphoreSecurity Objekt beginnt immer mit einer leeren DACL, die allen Benutzern den zugriff verweigert.

• Verletzung der kanonischen Reihenfolge von ACEs. Wenn die ACE-Liste in der DACL nicht in der kanonischen Reihenfolge beibehalten wird, erhalten Benutzer möglicherweise versehentlich Zugriff auf das gesicherte Objekt. Beispielsweise müssen verweigerte Zugriffsrechte immer vor zulässigen Zugriffsrechten angezeigt werden. SemaphoreSecurity -Objekte behalten intern die richtige Reihenfolge bei.

• Bearbeiten von Sicherheitsbeschreibungsflags, die sich nur unter Ressourcen-Manager-Kontrolle befinden sollten.

• Erstellen ungültiger Kombinationen von ACE-Flags.

• Ändern geerbter ACEs. Vererbung und Weitergabe werden vom Ressourcen-Manager als Reaktion auf Änderungen verarbeitet, die Sie an Zugriffs- und Überwachungsregeln vornehmen.

• Fügen Sie bedeutungslose ACEs in ACLs ein.

Die einzigen Funktionen, die von den .NET-Sicherheitsobjekten nicht unterstützt werden, sind gefährliche Aktivitäten, die von der Mehrheit der Anwendungsentwickler vermieden werden sollten, z. B. die folgenden:

• Aufgaben auf niedriger Ebene, die normalerweise vom Ressourcenmanager ausgeführt werden.

• Hinzufügen oder Entfernen von Zugriffssteuerungseinträgen auf eine Weise, die die kanonische Reihenfolge nicht beibehält.

Um die Windows-Zugriffssteuerungssicherheit für einen benannten Semaphor zu ändern, verwenden Sie die Semaphore.GetAccessControl -Methode, um das SemaphoreSecurity Objekt abzurufen. Ändern Sie das Sicherheitsobjekt, indem Sie Regeln hinzufügen und entfernen, und verwenden Sie dann die Semaphore.SetAccessControl -Methode, um es erneut anzufügen.

Um die Zugriffssteuerungssicherheit von einem Semaphor in einen anderen zu kopieren, verwenden Sie die Semaphore.GetAccessControl -Methode, um ein SemaphoreSecurity Objekt abzurufen, das die Zugriffs- und Überwachungsregeln für das erste Semaphor darstellt. Verwenden Sie dann die Semaphore.SetAccessControl Methode oder einen Konstruktor, der ein SemaphoreSecurity Objekt akzeptiert, um diese Regeln dem zweiten Semaphor zuzuweisen.

Benutzer mit einer Investition in die Sicherheitsdeskriptordefinitionssprache (SDDL) können die SetSecurityDescriptorSddlForm -Methode verwenden, um Zugriffsregeln für ein benanntes Semaphor festzulegen, und die GetSecurityDescriptorSddlForm -Methode, um eine Zeichenfolge abzurufen, die die Zugriffsregeln im SDDL-Format darstellt. Dies wird für neue Entwicklungen nicht empfohlen.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• SemaphoreAccessRule
• SemaphoreAuditRule
• SemaphoreRights
• GetAccessControl()
• SetAccessControl(SemaphoreSecurity)