ServiceSecurityContext Třída

Definice

Obor názvů:

System.ServiceModel

Sestavení:

System.ServiceModel.dll, System.ServiceModel.Primitives.dll

Balíček:

System.ServiceModel.Primitives v10.0.652802

Zdroj:

ServiceSecurityContext.cs

Představuje kontext zabezpečení vzdálené strany. V klientovi představuje identitu služby a ve službě představuje identitu klienta.

public ref class ServiceSecurityContext

public class ServiceSecurityContext

type ServiceSecurityContext = class

Public Class ServiceSecurityContext

Dědičnost

Object

ServiceSecurityContext

Příklady

Následující příklad používá ServiceSecurityContext třídu k poskytnutí informací o aktuálním kontextu zabezpečení. Kód vytvoří instanci StreamWriter třídy pro zápis informací do souboru.

// When this method runs, the caller must be an authenticated user
// and the ServiceSecurityContext is not a null instance.
public double Add(double n1, double n2)
{
    // Write data from the ServiceSecurityContext to a file using the StreamWriter class.
    using (StreamWriter sw = new StreamWriter(@"c:\ServiceSecurityContextInfo.txt"))
    {
        // Write the primary identity and Windows identity. The primary identity is derived from
        // the credentials used to authenticate the user. The Windows identity may be a null string.
        sw.WriteLine("PrimaryIdentity: {0}", ServiceSecurityContext.Current.PrimaryIdentity.Name);
        sw.WriteLine("WindowsIdentity: {0}", ServiceSecurityContext.Current.WindowsIdentity.Name);

        // Write the claimsets in the authorization context. By default, there is only one claimset
        // provided by the system.
        foreach (ClaimSet claimset in ServiceSecurityContext.Current.AuthorizationContext.ClaimSets)
        {
            foreach (Claim claim in claimset)
            {
                // Write out each claim type, claim value, and the right. There are two
                // possible values for the right: "identity" and "possessproperty".
                sw.WriteLine("Claim Type: {0}, Resource: {1} Right: {2}",
                    claim.ClaimType,
                    claim.Resource.ToString(),
                    claim.Right);
                sw.WriteLine();
            }
        }
    }
    return n1 + n2;
}

' When this method runs, the caller must be an authenticated user and the ServiceSecurityContext 
' is not a null instance. 
Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Add
    ' Write data from the ServiceSecurityContext to a file using the StreamWriter class.
    Dim sw As New StreamWriter("c:\ServiceSecurityContextInfo.txt")
    Try
        ' Write the primary identity and Windows identity. The primary identity is derived from 
        ' the credentials used to authenticate the user. The Windows identity may be a null string.
        sw.WriteLine("PrimaryIdentity: {0}", ServiceSecurityContext.Current.PrimaryIdentity.Name)
        sw.WriteLine("WindowsIdentity: {0}", ServiceSecurityContext.Current.WindowsIdentity.Name)

        ' Write the claimsets in the authorization context. By default, there is only one claimset
        ' provided by the system. 
        Dim claimset As ClaimSet
        For Each claimset In ServiceSecurityContext.Current.AuthorizationContext.ClaimSets
            Dim claim As Claim
            For Each claim In claimset
                ' Write out each claim type, claim value, and the right. There are two
                ' possible values for the right: "identity" and "possessproperty". 
                sw.WriteLine("Claim Type: {0}, Resource: {1} Right: {2}", _
                claim.ClaimType, _
                claim.Resource.ToString(), _
                claim.Right)
                sw.WriteLine()
            Next claim
        Next claimset
    Finally
        sw.Dispose()
    End Try
    Return n1 + n2
End Function

Následující příklad ukazuje implementaci CheckAccessCore metody, která používá ServiceSecurityContext k analýze sady deklarací identity.

public class MyServiceAuthorizationManager : ServiceAuthorizationManager
{
    protected override bool CheckAccessCore(OperationContext operationContext)
    {
        // Extract the action URI from the OperationContext. Match this against the claims
        // in the AuthorizationContext.
        string action = operationContext.RequestContext.RequestMessage.Headers.Action;
        Console.WriteLine("action: {0}", action);

        // Iterate through the various claimsets in the AuthorizationContext.
        foreach(ClaimSet cs in operationContext.ServiceSecurityContext.AuthorizationContext.ClaimSets)
        {
            // Examine only those claim sets issued by System.
            if (cs.Issuer == ClaimSet.System)
            {
                // Iterate through claims of type "http://example.org/claims/allowedoperation".
                foreach (Claim c in cs.FindClaims("http://example.org/claims/allowedoperation",
                    Rights.PossessProperty))
                {
                    // Write the Claim resource to the console.
                    Console.WriteLine("resource: {0}", c.Resource.ToString());

                    // If the Claim resource matches the action URI then return true to allow access.
                    if (action == c.Resource.ToString())
                        return true;
                }
            }
        }

        // If this point is reached, return false to deny access.
         return false;
    }
}

Public Class MyServiceAuthorizationManager
    Inherits ServiceAuthorizationManager
    
    Protected Overrides Function CheckAccessCore(ByVal operationContext As OperationContext) As Boolean 
        ' Extract the action URI from the OperationContext. Match this against the claims
        ' in the AuthorizationContext.
        Dim action As String = operationContext.RequestContext.RequestMessage.Headers.Action
        Console.WriteLine("action: {0}", action)
        
        ' Iterate through the various claimsets in the authorizationcontext.
        Dim cs As ClaimSet
        For Each cs In  operationContext.ServiceSecurityContext.AuthorizationContext.ClaimSets
            ' Examine only those claim sets issued by System.
            If cs.Issuer Is ClaimSet.System Then
                ' Iterate through claims of type "http://example.org/claims/allowedoperation".
                Dim c As Claim
                For Each c In  cs.FindClaims("http://example.org/claims/allowedoperation", _
                        Rights.PossessProperty)
                    ' Write the Claim resource to the console.
                    Console.WriteLine("resource: {0}", c.Resource.ToString())
                    
                    ' If the Claim resource matches the action URI then return true to allow access.
                    If action = c.Resource.ToString() Then
                        Return True
                    End If
                Next c
            End If
        Next cs 
        ' If we get here, return false, denying access.
        Return False
    
    End Function 
End Class

Poznámky

Data jsou součástí SecurityMessageProperty zprávy.

Tato třída slouží k získání informací o kontextu vzdáleného zabezpečení za běhu. Kontext zabezpečení se vytvoří, když se klient úspěšně ověří a autorizuje pro přístup k metodě. Pokud je zpráva úspěšně ověřena a autorizována, informace o zabezpečení z klienta a pro aktuální instanci služby lze získat z instance této třídy.

Můžete načíst instanci ServiceSecurityContext z Current vlastnosti OperationContext třídy nebo ji použít z metody operace služby, jak je znázorněno v následujícím příkladu.

Analýza sady deklarací identity

Běžným použitím třídy je načtení aktuální sady deklarací identity pro účely identifikace nebo autorizace klienta při přístupu k metodě. Třída ClaimSet obsahuje kolekci Claim objektů a každou z nich je možné analyzovat a určit, zda je k dispozici konkrétní deklarace identity. Pokud je zadaná deklarace identity zadaná, je možné udělit autorizaci. Tato funkce je poskytována přepsáním CheckAccessCore metody ServiceAuthorizationManager třídy. Úplný příklad najdete v tématu Zásady autorizace.

Režim souborů cookie a IsAuthenticated

Mějte na paměti, IsAuthenticated že za určitých okolností vrátí vlastnost IIdentity rozhraní true , i když je vzdálený klient ověřen jako anonymní uživatel. (Vlastnost PrimaryIdentity vrátí implementaci IIdentity rozhraní.) Aby k tomu mohlo dojít, musí být splněny následující okolnosti:

• Služba používá ověřování systému Windows.

• Služba umožňuje anonymní přihlášení.

• Vazba je <customBinding>.

• Vlastní vazba obsahuje <security> prvek.

• Element <security> obsahuje <secureConversationBootstrap> s atributem nastaveným requireSecurityContextCancellation na false.

Konstruktory

Name	Description
ServiceSecurityContext(AuthorizationContext, ReadOnlyCollection<IAuthorizationPolicy>)	Inicializuje novou instanci ServiceSecurityContext třídy se zadanými parametry autorizace a kolekcí zásad.
ServiceSecurityContext(AuthorizationContext)	Inicializuje novou instanci ServiceSecurityContext třídy se zadanými parametry autorizace.
ServiceSecurityContext(ReadOnlyCollection<IAuthorizationPolicy>)	Inicializuje novou instanci ServiceSecurityContext třídy s kolekcí zásad objektu.

Vlastnosti

Name	Description
Anonymous	Vrátí instanci ServiceSecurityContext třídy, která obsahuje prázdnou kolekci deklarací identity, identit a dalších kontextových dat, která se obvykle používají k reprezentaci anonymní strany.
AuthorizationContext	Získá autorizační informace pro instanci této třídy. Obsahuje AuthorizationContext kolekci, kterou ClaimSet může aplikace interrogovat a načíst informace strany.
AuthorizationPolicies	Získá kolekci zásad přidružených k instanci této třídy.
IsAnonymous	Získá hodnotu, která označuje, zda aktuální klient zadal přihlašovací údaje ke službě.
PrimaryIdentity	Získá primární identitu přidruženou k aktuálnímu nastavení.

Viz také

• Current
• OperationContext
• Claim
• ClaimSet
• ServiceAuthorizationManager
• Postupy: Prozkoumání kontextu zabezpečení
• Zásady autorizace
• Zabezpečení služeb
• Správa deklarací identity a autorizace pomocí modelu identit