Cómo: Crear una directiva de autorización personalizada

La infraestructura del modelo de identidad en Windows Communication Foundation (WCF) admite un modelo de autorización basado en una notificación. Las notificaciones se extraen de los tokens, procesados opcionalmente por la directiva de autorización personalizada. Después se colocan en un AuthorizationContext que se puede examinar a continuación para tomar las decisiones de autorización. Se puede utilizar una directiva personalizada para transformar las notificaciones de tokens entrantes en notificaciones esperadas por la aplicación. De esta manera, el nivel de aplicación se puede aislar de los detalles en las distintas notificaciones servidas por los distintos tokens que WCF admite. En este tema se muestra cómo implementar una directiva de autorización personalizada y cómo agregarla a la colección de directivas utilizada por un servicio.

Para implementar una directiva de autorización personalizada

1. Defina una nueva clase que derive de IAuthorizationPolicy.

2. Implemente la propiedad Id de sólo lectura generando una cadena única en el constructor para la clase y devolviendo esa cadena cada vez que se tenga acceso a la propiedad.

3. Implemente la propiedad Issuer de sólo lectura devolviendo un ClaimSet que representa el emisor de la directiva. Éste podría ser ClaimSet, que representa la aplicación o un ClaimSet integrado (por ejemplo, el ClaimSet devuelto por la propiedad System estática.

4. Implemente el método Evaluate tal y como se ha descrito en el procedimiento siguiente.

Para implementar el método de evaluación

1. Dos parámetros se pasan a este método: una instancia de la clase EvaluationContext y una referencia de objeto.

2. Si la directiva de autorización personalizada agrega las instancias ClaimSet sin tener en cuenta el contenido actual de EvaluationContext, a continuación, agregue ClaimSet llamando al método AddClaimSet y devuelva true desde el método Evaluate. Devolver true indica a la infraestructura de la autorización que la directiva de autorización ha realizado su trabajo y no necesita ser llamada de nuevo.

3. Si la directiva de autorización personalizada agrega conjuntos de notificaciones sólo si algunas notificaciones están presentes en EvaluationContext, después búsquelas examinando las instancias ClaimSet devueltas por la propiedad ClaimSets. Si las notificaciones están presentes, añada los nuevos conjuntos de notificaciones llamando al método AddClaimSet y, si no se van a agregar más conjuntos de notificaciones, devuelva true, indicando a la infraestructura de autorización que la directiva de autorización ha completado su trabajo. Si las notificaciones no están presentes, devuelva false, indicando que se debería llamar a la directiva de autorización de nuevo si otras directivas de autorización agregan más conjuntos de notificaciones a EvaluationContext.

4. En escenarios de procesamiento más complejos, el segundo parámetro del método Evaluate se utiliza para almacenar una variable de estado que la infraestructura de autorización devolverá durante cada llamada posterior realizada al método Evaluate para una evaluación determinada.

Para especificar una directiva de autorización personalizada mediante la configuración

1. Especifique el tipo de la directiva de autorización personalizada en el atributo policyType en el elemento add correspondiente al elemento authorizationPolicies del elemento serviceAuthorization.

   <configuration>
    <system.serviceModel>
     <behaviors>
       <serviceAuthorization serviceAuthorizationManagerType=
                 "Samples.MyServiceAuthorizationManager" >
         <authorizationPolicies>       
           <add policyType="Samples.MyAuthorizationPolicy"
         </authorizationPolicies>
       </serviceAuthorization>
     </behaviors>
    </system.serviceModel>
   </configuration>
   

Para especificar una directiva de autorización personalizada mediante código

1. Cree un List de IAuthorizationPolicy.

2. Cree una instancia de la directiva de autorización personalizada.

3. Agregue la instancia de la directiva de autorización a la lista.

4. Repita los pasos 2 y 3 para cada directiva de autorización personalizada.

5. Asigne una versión de sólo lectura de la lista a la propiedad ExternalAuthorizationPolicies.

Ejemplo

En el siguiente ejemplo se muestra una implementación de IAuthorizationPolicy completa.

Consulte también

Referencia

ServiceAuthorizationManager

Otros recursos

How To: Compare Claims
How To: Create a Custom AuthorizationManager on a Service
Authorization Policy Sample