Udostępnij za pośrednictwem


Porady: Porównywanie oświadczeń

Infrastruktura modelu tożsamości w programie Windows Communication Foundation (WCF) służy do przeprowadzania sprawdzania autoryzacji. W związku z tym typowym zadaniem jest porównanie oświadczeń w kontekście autoryzacji z oświadczeniami wymaganymi do wykonania żądanej akcji lub uzyskania dostępu do żądanego zasobu. W tym temacie opisano sposób porównywania oświadczeń, w tym wbudowanych i niestandardowych typów oświadczeń. Aby uzyskać więcej informacji na temat infrastruktury modelu tożsamości, zobacz Zarządzanie oświadczeniami i autoryzacją za pomocą modelu tożsamości.

Porównanie oświadczeń obejmuje porównanie trzech części oświadczenia (typ, prawo i zasób) względem tych samych części w innym oświadczeniu, aby sprawdzić, czy są one równe. Zobacz poniższy przykład.

Claim c1 = Claim.CreateNameClaim("someone");
Claim c2 = Claim.CreateNameClaim("someone");
Dim c1 As Claim = Claim.CreateNameClaim("someone")
Dim c2 As Claim = Claim.CreateNameClaim("someone")

Oba oświadczenia mają typ Nameoświadczenia , prawo PossessPropertyod , i zasób ciągu "ktoś". Ponieważ wszystkie trzy części roszczenia są równe, same roszczenia są równe.

Wbudowane typy oświadczeń są porównywane przy użyciu Equals metody . Kod porównania specyficzny dla oświadczenia jest używany w razie potrzeby. Na przykład, biorąc pod uwagę następujące dwa oświadczenia głównej nazwy użytkownika (UPN), kod porównania w metodzie zwraca truewartość , przy założeniuEquals, że example\someone identyfikuje tego samego użytkownika domeny co someone@example.com.

Claim c1 = Claim.CreateUpnClaim("someone@example.com");
Claim c2 = Claim.CreateUpnClaim("example\\someone");
Dim c1 As Claim = Claim.CreateUpnClaim("someone@example.com")
Dim c2 As Claim = Claim.CreateUpnClaim("example\someone")

Niestandardowe typy oświadczeń można również porównać przy użyciu Equals metody . Jednak w przypadkach, gdy typ zwracany przez Resource właściwość oświadczenia jest czymś innym niż typ pierwotny, zwraca true tylko wtedy, Equals gdy wartości zwracane przez Resource właściwości są równe zgodnie z Equals metodą. W przypadkach, gdy nie jest to odpowiednie, typ niestandardowy zwracany przez Resource właściwość powinien zastąpić Equals metody i GetHashCode do wykonania dowolnego niestandardowego przetwarzania jest konieczne.

Porównywanie wbudowanych oświadczeń

  1. Biorąc pod uwagę dwa wystąpienia Claim klasy, użyj Equals elementu , aby porównać, jak pokazano w poniższym kodzie.

    public bool CompareTwoClaims(Claim c1, Claim c2)
    {
        return c1.Equals(c2);
    }
    
    Public Function CompareTwoClaims(ByVal c1 As Claim, ByVal c2 As Claim) As Boolean
        Return c1.Equals(c2)
    End Function
    

Porównywanie oświadczeń niestandardowych z typami zasobów pierwotnych

  1. W przypadku oświadczeń niestandardowych z typami zasobów pierwotnych porównanie można wykonać w przypadku wbudowanych oświadczeń, jak pokazano w poniższym kodzie.

    public bool CompareTwoClaims(Claim c1, Claim c2)
    {
        return c1.Equals(c2);
    }
    
    Public Function CompareTwoClaims(ByVal c1 As Claim, _
    ByVal c2 As Claim) As Boolean
        Return c1.Equals(c2)
    
    End Function
    
  2. W przypadku oświadczeń niestandardowych z typami zasobów opartymi na strukturze lub klasie typ zasobu powinien zastąpić metodę Equals .

  3. Najpierw sprawdź, czy obj parametr to null, a jeśli tak, zwróć wartość false.

    if (obj == null) return false;
    
    If obj Is Nothing Then
        Return False
    
  4. Następne wywołanie ReferenceEquals i przekazanie this parametrów i obj jako. Jeśli zwraca truewartość , zwróć polecenie true.

    if (ReferenceEquals(this, obj)) return true;
    
    If ReferenceEquals(Me, obj) Then
        Return True
    
  5. Następna próba przypisania obj do zmiennej lokalnej typu klasy. Jeśli to się nie powiedzie, odwołanie to null. W takich przypadkach zwróć wartość false.

  6. Wykonaj porównanie niestandardowe niezbędne do poprawnego porównania bieżącego oświadczenia z podanym oświadczeniem.

Przykład

W poniższym przykładzie pokazano porównanie oświadczeń niestandardowych, w których zasób oświadczenia jest typem nietypowym.

using System;
using System.IdentityModel.Claims;

namespace Samples
{
    public sealed class MyResourceType
    {
        // private members
        private string text;
        private int number;

        // Constructors
        public MyResourceType()
        {
        }

        public MyResourceType(string text, int number)
        {
            this.text = text;
            this.number = number;
        }

        // Public properties
        public string Text { get { return this.text; } }
        public int Number { get { return this.number; } }

        // Override Object.Equals to perform specific comparison
        public override bool Equals(Object obj)
        {
            // If the object we're being asked to compare ourselves to is null
            // then return false
            if (obj == null)
                return false;

            // If the object we're being asked to compare ourselves to is us
            // then return true
            if (ReferenceEquals(this, obj))
                return true;

            // Try to convert the object we're being asked to compare ourselves to
            // into an instance of MyResourceType
            MyResourceType rhs = obj as MyResourceType;

            // If the object we're being asked to compare ourselves to
            // isn't an instance of MyResourceType then return false
            if (rhs == null)
                return false;

            // Return true if our members are the same as those of the object
            // we're being asked to compare ourselves to. Otherwise return false
            return (this.text == rhs.text && this.number == rhs.number);
        }

        public override int GetHashCode()
        {
            return (this.text.GetHashCode() ^ this.number.GetHashCode());
        }
    }

    class Program
    {
        public static void Main()
        {
            // Create two claims
            Claim c1 = new Claim("http://example.org/claims/mycustomclaim",
                new MyResourceType("Martin", 38), Rights.PossessProperty);
            Claim c2 = new Claim("http://example.org/claims/mycustomclaim",
                new MyResourceType("Martin", 38), Rights.PossessProperty);

            // Compare the claims
            if (c1.Equals(c2))
                Console.WriteLine("Claims are equal");
            else
                Console.WriteLine("Claims are not equal");
        }
    }
}
Imports System.IdentityModel.Claims
Imports System.Security.Permissions

NotInheritable Public Class MyResourceType
    ' private members
    Private textValue As String
    Private numberValue As Integer


    ' Constructors
    Public Sub New()

    End Sub

    Public Sub New(ByVal textVal As String, ByVal numberValue As Integer)
        Me.textValue = textVal
        Me.numberValue = numberValue

    End Sub

    ' Public properties

    Public ReadOnly Property Text() As String
        Get
            Return Me.textValue
        End Get
    End Property

    Public ReadOnly Property Number() As Integer
        Get
            Return Me.numberValue
        End Get
    End Property
    ' Override Object.Equals to perform a specific comparison.
    Public Overrides Function Equals(ByVal obj As [Object]) As Boolean
        ' If the object being compared to is null then return false.
        If obj Is Nothing Then
            Return False
        End If
        ' If the object we are being asked to compare ourselves to is us
        ' then return true.
        If ReferenceEquals(Me, obj) Then
            Return True
        End If
        ' Try to convert the object we are being asked to compare ourselves to
        ' into an instance of MyResourceType.
        Dim rhs As MyResourceType = CType(obj, MyResourceType)

        ' If the object being compared to is not an instance of 
        ' MyResourceType then return false.
        If rhs Is Nothing Then
            Return False
        End If
        ' Return true if members are the same as those of the object
        ' being asked to compare to; otherwise, return false.
        Return Me.textValue = rhs.textValue AndAlso Me.numberValue = rhs.numberValue

    End Function

    Public Overrides Function GetHashCode() As Integer
        Return Me.textValue.GetHashCode() ^ Me.numberValue.GetHashCode()

    End Function
End Class
Class Program

    Public Shared Sub Main()
        ' Create two claims.
        Dim c1 As New Claim("http://example.org/claims/mycustomclaim", _
           New MyResourceType("Martin", 38), Rights.PossessProperty)
        Dim c2 As New Claim("http://example.org/claims/mycustomclaim", _
           New MyResourceType("Martin", 38), Rights.PossessProperty)

        ' Compare the claims.
        If c1.Equals(c2) Then
            Console.WriteLine("Claims are equal")
        Else
            Console.WriteLine("Claims are not equal")
        End If

    End Sub
End Class

Zobacz też