Como: Comparar reclamações

Artigo
03/02/2024

A infraestrutura do Modelo de Identidade no Windows Communication Foundation (WCF) é usada para executar a verificação de autorização. Como tal, uma tarefa comum é comparar as declarações no contexto de autorização com as declarações necessárias para executar a ação solicitada ou acessar o recurso solicitado. Este tópico descreve como comparar declarações, incluindo tipos de declaração internos e personalizados. Para obter mais informações sobre a infraestrutura do Modelo de Identidade, consulte Gerenciando declarações e autorização com o Modelo de Identidade.

A comparação de declarações envolve a comparação das três partes de uma reivindicação (tipo, direito e recurso) com as mesmas partes em outra declaração para ver se elas são iguais. Veja o seguinte exemplo.

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

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

Ambas as declarações têm um tipo de reivindicação de Name, um direito de PossessProperty, e um recurso da cadeia de caracteres "alguém". Uma vez que as três partes do pedido são iguais, os próprios créditos são iguais.

Os tipos de declaração internos são comparados usando o Equals método. Sempre que necessário, é utilizado um código de comparação específico da declaração. Por exemplo, dadas as duas declarações UPN (nome principal do usuário) a seguir, o Equals código de comparação no método retorna true, supondo que example\someone identifique o mesmo usuário de domínio como 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")

Os tipos de declaração personalizados também podem ser comparados usando o Equals método. No entanto, nos casos em que o Resource tipo retornado pela propriedade da declaração é algo diferente de um tipo primitivo, os Equals retornos true somente se os valores retornados pelas Resource propriedades forem iguais de acordo com o Equals método. Nos casos em que isso não é apropriado, o Resource tipo personalizado retornado pela propriedade deve substituir os Equals métodos e GetHashCode para executar qualquer processamento personalizado necessário.

Comparando declarações incorporadas

Dadas duas instâncias da Claim classe, use o Equals para fazer a comparação, conforme mostrado no código a seguir.

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

Comparando declarações personalizadas com tipos de recursos primitivos

Para declarações personalizadas com tipos de recursos primitivos, a comparação pode ser executada como para declarações internas, conforme mostrado no código a seguir.

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

Para declarações personalizadas com tipos de recursos baseados em estrutura ou classe, o tipo de recurso deve substituir o Equals método.
Primeiro, verifique se o obj parâmetro é nulle, em caso afirmativo, retorne.false
```
if (obj == null) return false;
```
```
If obj Is Nothing Then
    Return False
```
Próxima chamada ReferenceEquals e passe this e obj como parâmetros. Se ele retornar true, então retorne true.
```
if (ReferenceEquals(this, obj)) return true;
```
```
If ReferenceEquals(Me, obj) Then
    Return True
```
Em seguida, tente atribuir obj a uma variável local do tipo de classe. Se isso falhar, a referência é null. Nesses casos, devolva false.
Execute a comparação personalizada necessária para comparar corretamente a declaração atual com a declaração fornecida.

Exemplo

O exemplo a seguir mostra uma comparação de declarações personalizadas em que o recurso de declaração é um tipo não primitivo.

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

Partilhar via

Como: Comparar reclamações

Comparando declarações incorporadas

Comparando declarações personalizadas com tipos de recursos primitivos

Exemplo

Consulte também

Recursos adicionais