SemaphoreSecurity Sınıf

Tanım

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

Devralma

Object

ObjectSecurity

CommonObjectSecurity

NativeObjectSecurity

SemaphoreSecurity

Öznitelikler

SecurityCriticalAttribute ComVisibleAttribute

Örnekler

Aşağıdaki kod örneği, kurallar ve Deny kurallar arasındaki Allow ayrımı gösterir ve uyumlu kurallardaki hakların birleşimini gösterir. Örnek bir SemaphoreSecurity nesne oluşturur, geçerli kullanıcı için çeşitli haklara izin veren ve reddeden kurallar ekler ve sonuçta elde edilen kural çiftini görüntüler. Örnek daha sonra geçerli kullanıcı için yeni haklara izin verir ve yeni hakların mevcut Allow kuralla birleştirildiğini gösteren sonucu görüntüler.

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

Açıklamalar

Nesnesi SemaphoreSecurity , adlandırılmış sistem semaforu için erişim haklarını belirtir ve ayrıca erişim girişimlerinin nasıl denetlenip denetlenmeyişini belirtir. Semafora erişim hakları kural olarak ifade edilir ve her erişim kuralı bir SemaphoreAccessRule nesne tarafından temsil edilir. Her denetim kuralı bir SemaphoreAuditRule nesneyle temsil edilir.

Bu, güvenliği sağlanabilir her nesnenin güvenli nesneye erişimi denetleyen en fazla bir isteğe bağlı erişim denetim listesine (DACL) ve hangi erişim denemelerinin denetlendiğini belirten en fazla bir sistem erişim denetim listesine (SACL) sahip olduğu temel Windows güvenlik sistemini yansıtır. DACL ve SACL, kullanıcılar ve gruplar için erişim ve denetimi belirten erişim denetimi girdilerinin (ACE) sıralı listeleridir. Bir SemaphoreAccessRule veya SemaphoreAuditRule nesnesi birden fazla ACE'i temsil edebilir.

SemaphoreSecurity, SemaphoreAccessRuleve sınıfları, ACL'lerin SemaphoreAuditRule ve ACL'lerin uygulama ayrıntılarını gizler. On yedi farklı ACE türünü ve devralmayı ve erişim haklarının yayılmasını doğru şekilde korumanın karmaşıklığını yoksaymanıza olanak sağlar. Bu nesneler, aşağıdaki yaygın erişim denetimi hatalarını önlemek için de tasarlanmıştır:

• Null DACL ile bir güvenlik tanımlayıcısı oluşturma. DACL'ye null başvuru, herhangi bir kullanıcının bir nesneye erişim kuralları eklemesine olanak tanır ve potansiyel olarak bir hizmet reddi saldırısı oluşturur. Yeni SemaphoreSecurity bir nesne her zaman tüm kullanıcılar için tüm erişimi reddeden boş bir DACL ile başlar.

• ACL'lerin kurallı sıralamasını ihlal etme. DACL'deki ACE listesi kurallı sırada tutulmazsa, kullanıcılara yanlışlıkla güvenli nesneye erişim verilebilir. Örneğin, reddedilen erişim hakları her zaman izin verilen erişim hakları öncesinde görünmelidir. SemaphoreSecurity nesneleri dahili olarak doğru sırayı korur.

• Yalnızca kaynak yöneticisi denetimi altında olması gereken güvenlik tanımlayıcısı bayraklarını düzenleme.

• ACE bayraklarının geçersiz bileşimleri oluşturuluyor.

• Devralınan ACL'leri düzenleme. Devralma ve yayma, erişim ve denetim kurallarında yaptığınız değişikliklere yanıt olarak kaynak yöneticisi tarafından işlenir.

• ACL'lere anlamsız ACL'ler ekleme.

.NET güvenlik nesneleri tarafından desteklenmeyen tek özellikler, uygulama geliştiricilerinin çoğunluğu tarafından kaçınılması gereken tehlikeli etkinliklerdir, örneğin:

• Normalde kaynak yöneticisi tarafından gerçekleştirilen düşük düzeyli görevler.

• Kurallı sıralamayı korumayan yollarla erişim denetimi girdileri ekleme veya kaldırma.

Adlandırılmış semafor için Windows erişim denetimi güvenliğini değiştirmek için nesnesini almak SemaphoreSecurity üzere yöntemini kullanınSemaphore.GetAccessControl. Kuralları ekleyip kaldırarak güvenlik nesnesini değiştirin ve ardından yöntemini kullanarak Semaphore.SetAccessControl yeniden ekleyin.

Erişim denetimi güvenliğini bir semafordan diğerine kopyalamak için yöntemini kullanarak Semaphore.GetAccessControl ilk semafor için erişim ve denetim kurallarını temsil eden bir SemaphoreSecurity nesne alın, ardından yöntemini veya nesneyi kabul eden bir SemaphoreSecurity oluşturucuyu kullanarak Semaphore.SetAccessControl bu kuralları ikinci semafora atayın.

Güvenlik tanımlayıcısı tanım diline (SDDL) yatırımları olan kullanıcılar, adlandırılmış semafor için erişim kuralları ayarlamak için yöntemini ve GetSecurityDescriptorSddlForm SDDL biçiminde erişim kurallarını temsil eden bir dize elde etmek için yöntemini kullanabilirSetSecurityDescriptorSddlForm. Bu, yeni geliştirme için önerilmez.

Oluşturucular

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

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