ServiceAuthorizationManager Classe

Definição

Fornece verificação de acesso de autorização para operações de serviço.Provides authorization access checking for service operations.

public ref class ServiceAuthorizationManager
public class ServiceAuthorizationManager
type ServiceAuthorizationManager = class
Public Class ServiceAuthorizationManager
Herança
ServiceAuthorizationManager

Exemplos

O exemplo a seguir mostra uma classe MyServiceAuthorizationManager chamada que herda ServiceAuthorizationManager de e substitui o CheckAccessCore método.The following example shows a class named MyServiceAuthorizationManager that inherits from the ServiceAuthorizationManager and overrides the CheckAccessCore method.

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;
    
    // Iterate through the various claim sets 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://www.contoso.com/claims/allowedoperation".
          foreach (Claim c in cs.FindClaims("http://www.contoso.com/claims/allowedoperation", Rights.PossessProperty))
        {
          // 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
        
        ' 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://www.contoso.com/claims/allowedoperation".
                Dim c As Claim
                For Each c In  cs.FindClaims("http://www.contoso.com/claims/allowedoperation", _
                     Rights.PossessProperty)
                    ' 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 this point is reached, return false to deny access.
        Return False
    
    End Function 
End Class 

Comentários

Essa classe é responsável pela avaliação de todas as políticas (regras que definem o que um usuário tem permissão para fazer), comparando as políticas a declarações feitas por AuthorizationContext um cliente ServiceSecurityContext, definindo o resultado para o e fornecendo a decisão de autorização se para permitir ou negar acesso a uma determinada operação de serviço para um chamador.This class is responsible for evaluating all policies (rules that define what a user is allowed to do), comparing the policies to claims made by a client, setting the resulting AuthorizationContext to the ServiceSecurityContext, and providing the authorization decision whether to allow or deny access for a given service operation for a caller.

O CheckAccessCore método é chamado pela infraestrutura do Windows Communication Foundation (WCF) sempre que uma tentativa de acessar um recurso é feita.The CheckAccessCore method is called by the Windows Communication Foundation (WCF) infrastructure each time an attempt to access a resource is made. O método retorna true ou false para permitir ou negar acesso, respectivamente.The method returns true or false to allow or deny access, respectively.

O ServiceAuthorizationManager faz parte da infraestrutura domodelo de identidade do WCF.The ServiceAuthorizationManager is part of the WCFIdentity Model infrastructure. O modelo de identidade permite que você crie políticas de autorização personalizadas e esquemas de autorização personalizados.The Identity Model enables you to create custom authorization policies and custom authorization schemes. Para obter mais informações sobre como o modelo de identidade funciona, consulte Gerenciando declarações e autorização com o modelo de identidade.For more information about how the Identity Model works, see Managing Claims and Authorization with the Identity Model.

Autorização personalizadaCustom Authorization

Essa classe não executa nenhuma autorização e permite que os usuários acessem todas as operações de serviço.This class does not perform any authorization and allows users to access all service operations. Para fornecer uma autorização mais restritiva, você deve criar um Gerenciador de autorização personalizado que verifica políticas personalizadas.To provide more restrictive authorization, you must create a custom authorization manager that checks custom policies. Para fazer isso, herde dessa classe e substitua o CheckAccessCore método.To do this, inherit from this class and override the CheckAccessCore method. Especifique a instância da classe derivada por meio da ServiceAuthorizationManager propriedade.Specify the instance of the derived class through the ServiceAuthorizationManager property.

No CheckAccessCore, o aplicativo pode usar o OperationContext objeto para acessar a identidade do chamadorServiceSecurityContext().In CheckAccessCore, the application can use the OperationContext object to access the caller identity (ServiceSecurityContext).

Ao obter a IncomingMessageHeaders Propriedade, que retorna um MessageHeaders objeto, o aplicativo pode acessar o serviço (To) e a operação (Action).By getting the IncomingMessageHeaders property, which returns a MessageHeaders object, the application can access the service (To), and the operation (Action).

Ao obter a RequestContext Propriedade, que retorna um RequestContext objeto, o aplicativo pode acessar toda a mensagem de solicitaçãoRequestMessage() e executar a decisão de autorização de forma adequada.By getting the RequestContext property, which returns a RequestContext object, the application can access the entire request message (RequestMessage) and perform the authorization decision accordingly.

Para obter um exemplo, consulte Crie um Gerenciador de autorização personalizado para umserviço.For an example, see How to: Create a Custom Authorization Manager for a Service.

Para criar políticas de autorização personalizadas, implemente a IAuthorizationPolicy classe.To create custom authorization policies, implement the IAuthorizationPolicy class. Para obter um exemplo, consulte Crie uma políticade autorização personalizada.For an example, see How to: Create a Custom Authorization Policy.

Para criar uma declaração personalizada, use a Claim classe.To create a custom claim, use the Claim class. Para obter um exemplo, consulte Crie uma declaraçãopersonalizada.For an example, see How to: Create a Custom Claim. Para comparar as declarações personalizadas, você deve comparar as declarações, conforme mostrado em como: Compare asdeclarações.To compare custom claims, you must compare claims, as shown in How to: Compare Claims.

Para obter mais informações, consulte autorização personalizada.For more information, see Custom Authorization.

Você pode definir o tipo de um Gerenciador de autorização personalizado usando <a> uniautorização em um arquivo de configuração de aplicativo cliente.You can set the type of a custom authorization manager using the <serviceAuthorization> in a client application configuration file.

Construtores

ServiceAuthorizationManager()

Inicializa uma nova instância da classe ServiceAuthorizationManager.Initializes a new instance of the ServiceAuthorizationManager class.

Métodos

CheckAccess(OperationContext)

Verifica a autorização para o contexto de operação fornecido.Checks authorization for the given operation context.

CheckAccess(OperationContext, Message)

Verifica a autorização para o contexto de operação fornecido quando o acesso a uma mensagem é necessário.Checks authorization for the given operation context when access to a message is required.

CheckAccessCore(OperationContext)

Verifica a autorização para um determinado contexto de operação com base na avaliação de política padrão.Checks authorization for the given operation context based on default policy evaluation.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetAuthorizationPolicies(OperationContext)

Obtém o conjunto de políticas que participam de avaliação de políticas.Gets the set of policies that participate in policy evaluation.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também