如何：创建自定义授权策略

项目
09/12/2008

Windows Communication Foundation (WCF) 中的标识模型基础结构支持基于声明的授权模型。声明从令牌中提取，并可以选择由自定义授权策略进行处理，然后放入 AuthorizationContext 中，之后进行检查以做出授权决定。可以使用自定义策略将声明从传入令牌转换成应用程序需要的声明。这样，可以将应用程序层从 WCF 支持的不同令牌类型所提供的不同声明的详细信息中隔离出来。本主题演示如何实现自定义授权策略和如何将该策略添加到服务所使用的策略集中。

实现自定义授权策略

定义一个从 IAuthorizationPolicy 中派生的新类。
实现只读 Id 属性，方法是在该类的构造函数中生成唯一字符串并在访问此属性时返回该字符串。
通过返回表示策略颁发者的 ClaimSet，实现只读 Issuer 属性。它可能是表示应用程序的 ClaimSet，也可能是内置的 ClaimSet（例如，由静态 System 属性返回的 ClaimSet）。
按照下面过程中的说明，实现 Evaluate 方法。

实现 Evaluate 方法

需要向此方法传递两个参数：EvaluationContext 类的一个实例和一个对象引用。
如果自定义授权策略添加 ClaimSet 实例，而不考虑 EvaluationContext 的当前内容，则通过调用 AddClaimSet 方法添加每个 ClaimSet，并从 Evaluate 方法返回 true。返回 true 可向授权基础结构指示授权策略已执行其工作，不需要重新调用。
如果自定义授权策略仅在 EvaluationContext 中已经存在特定的声明时才添加声明集，则通过检查由 ClaimSet 属性返回的 ClaimSets 实例，查找这些声明。如果声明已存在，则通过调用 AddClaimSet 方法添加新声明集，如果不再需要添加其他声明集，则返回 true，向授权基础结构指示授权策略已完成其工作。如果声明不存在，则返回 false，指示如果其他授权策略向 EvaluationContext 添加更多声明集，则应该重新调用授权策略。
对于更为复杂的处理方案，可以使用 Evaluate 方法的第二个参数来存储一个状态变量，在对 Evaluate 方法的每个后续调用过程中，授权基础结构均将传回该变量以便进行特定的评估。

通过配置指定自定义授权策略

在 serviceAuthorization 元素的 authorizationPolicies 元素的 add 元素的 policyType 属性中指定自定义授权策略的类型。

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

通过代码指定自定义授权策略

创建 IAuthorizationPolicy 的一个 List。
创建自定义授权策略的一个实例。
将该授权策略实例添加到列表中。
对每个自定义授权策略重复步骤 2 和 3。
将列表的一个只读版本分配给 ExternalAuthorizationPolicies 属性。

示例

下面的示例演示完整的 IAuthorizationPolicy 实现。

另请参见

参考

ServiceAuthorizationManager

其他资源

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