【WCF】授权策略详解

时间:2023-03-09 00:19:41
【WCF】授权策略详解

所谓授权者,就是服务授予客户端是否具有调用某个服务操作的权限。

授权过程可以通过一系列授权策略来进行评估,即每个特定的授权策略都按照各自的需求,衡量一下调用方是否具备访问服务操作的权限。在默认情况下,服务的授权策略列表中,会存在一个UnconditionalPolicy授权策略,这个类型没有公开,它的定义如下:

    class UnconditionalPolicy : IAuthorizationPolicy, IDisposable
{
……
}

正因为这家伙定义为internal,故在我们的代码中是不能访问到的。这个类型是内部授权的评估过程,我们在开发中可以不理它,因为它在内部肯定会被使用的,你管不着它。

除了内部授权策略外,我们可以实现自己的授略策略类,以扩展WCF服务的授权功能。自定义授权策略的方法很简单,就是实现 IAuthorizationPolicy 接口。注意,使用这厮要引用 System.IdentityModel.dll 程序集,因为它是WIF的一部分。

IAuthorizationPolicy 的 Evaluate 方法

由于IAuthorizationPolicy接口派生自IAuthorizationComponent接口,两个接口加起来,我们的自定义类必须实现以下三个成员:

1、Id——这个属性是字符串值,只读。它表示一个唯一值,以区别于其他授权相关的组件类,对于这个属性,最好的办法就是返回一个GUID值,这样就可以保证唯一性了。

2、Issuer——一个声明集,即ClaimSet,它表示该授权策略的发布者。通常这个属性可以直接返回System或Windows,这两个值都是ClaimSet类的静态成员。这样返回比较简单,你如果不希望使用系统默认声明集,也可以自己组装一个,一个声明集里面包含N个Claim对象,一个Claim表示一个声明。声明这玩意儿怎么解释呢。你就把它理解为一个符号吧,这种符号由type、resource,right三元素组成,type是字符串,可以使用标准的类型,这些标准由System.IdentityModel.Claims.ClaimTypes 类的静态属性公开,你可以直接用,比如URI,E-mail,Name、国家(Country)、DNS等。其实你看到了,声明类型有点像联系人资料的字段;除了标准值,你也可以自己定义值,反正是字符串,你可以随便,比如city表示城市,age表示年龄,RP表示人品值,等等。right是权限,System.IdentityModel.Claims.Rights类的静态属性公开两个标准值,同样,它也是字符串,所以你也可以定义非标准的值,比如delete、add、new、save等等,反正是个字符串就行。而resource的数据类型为Object,即你可以引用任意值,但最好是可以序列化的实例,毕竟它最后是变成XML的,resource是附加内容,可选。

3、Evaluate方法——这个是核心,在这个方法里面你要对访问者进行评估。客户端经过服务的身份验证后,一般会产生一个Identity对象,这个标识是存放到一个字典数据中的,这个后面会给大伙说。注意这个方法返回的是布尔值,如果返回false,那么,一旦授权上下文发生变化,比如添加了安全实体、其他标识,或者其他的授权策略也进行评估时,都会触发这个方法被调用。返回true,表示此次评估一次性通过,后面如果授权上下文发生变化,也不再调用;如果返回false,比较危险,有可能导致循环调用,一般来说,处理完成后,应该返回true。

细节的东西我们先不管,我们先来学会如何自定义授权策略,并且把自定义的策略放进服务中。

下面咱们定义两个授权策略,这里只为了演示,所以Evaluate方法里面不做什么。

    class MyPolicyA : IAuthorizationPolicy
{
Guid mid = Guid.NewGuid();
public string Id
{
get
{
return mid.ToString();
}
} public ClaimSet Issuer
{
get
{
return ClaimSet.System;
}
} public bool Evaluate(EvaluationContext evaluationContext, ref object state)
{
Console.WriteLine($"进入 {nameof(MyPolicyA)} 的 {nameof(Evaluate)} 方法");
return false;
}
} class MyPolicyB : IAuthorizationPolicy
{
Guid id = Guid.NewGuid();
public string Id
{
get
{
return id.ToString();
}
} public ClaimSet Issuer
{
get
{
return ClaimSet.System;
}
} public bool Evaluate(EvaluationContext evaluationContext, ref object state)
{
Console.WriteLine($"进入 {nameof(MyPolicyB)} 的 {nameof(Evaluate)} 方法。");
return false;
}
}

这个看得懂吧,在Evaluate方法中加入了Console的输出,为了在运行时知道方法被执行,这里呢,我统一返回false。

然后,看看如何把自定义策略添加到服务中,ServiceHost类会向服务的Behavior列表添加一个ServiceAuthorizationBehavior,并且为了便于访问,还直接以Authorization属性公开。下面把刚刚定义的两个策略加入到服务中。

            List<IAuthorizationPolicy> authorlist = new List<IAuthorizationPolicy>();
authorlist.Add(new Coc.MyPolicyA());
authorlist.Add(new Coc.MyPolicyB());
host.Authorization.ExternalAuthorizationPolicies = authorlist.AsReadOnly();

一定要注意,身份验证和授权的两个单词很像,授权是Authorization单词。

如果你不想用代码来添加自定义授权策略,也可以用配置文件来完成。

    <behaviors>
<serviceBehaviors>
<behavior>
<serviceAuthorization>
<authorizationPolicies>
<clear/>
<add policyType="Coc.MyPolicyA, SomeApp771"/>
<add policyType="Coc.MyPolicyB, SomeApp771"/>
</authorizationPolicies>
</serviceAuthorization>
</behavior>
</serviceBehaviors>
</behaviors>

代码方式和配置文件方式,任选其一即可,不要两种都同时用上,记住!!在配置文件中,policyType除了指定自定义策略类的路径外,还得写上你的程序集的名字,上面例子中的SomeApp771就是程序集的名字,不然的话,运行时会跑到System.ServiceModel程序集里面去找,结果就会找不到类型而发生异常。

好,现在可以运行一下,试试看。

【WCF】授权策略详解

你都看到,每个Evaluate方法都被调用了两次,那是因为我们刚才让它返回false。

接下来,咱们把上面两个策略中的Evaluate方法都改一下,让它们都返回true。

        public bool Evaluate(EvaluationContext evaluationContext, ref object state)
{
Console.WriteLine($"进入 {nameof(MyPolicyA)} 的 {nameof(Evaluate)} 方法");
return true;
}

然后再运行,就会发现,方法只被执行了一次。

【WCF】授权策略详解

如果Evaluate方法返回true,那么后面就算授权上下文发生变化,也不再调用方法。

在评估上下文中添加声明

相信各位都注意到了,Evaluate方法有个 EvaluationContext 类型的参数,它是个抽象类,运行内部有实现类,但未对外公开,我们可以通过 EvaluationContext 实例来访问它,既然叫Context(上下文),因而它的实例在所有授权策略的评估过程中,都是共享同一个实例,故这个上下文实例会在各个策略中传递。

在Evaluate方法中,可以向 EvaluationContext 参数添加自定义声明集,即前面说过的ClaimSet,而声明集的标识是当前授权策略的实例,添加声明应调用以下方法:

void AddClaimSet(IAuthorizationPolicy policy, ClaimSet claimSet);

第一个参数就是当前策略实例。

下面给大伙演示一个授权策略评估示例,并向声明集列表中添加自定义声明。

    class CustPolicy : IAuthorizationPolicy
{
Guid id = Guid.NewGuid();
public string Id
{
get
{
return id.ToString();
}
} public ClaimSet Issuer
{
get
{
return ClaimSet.System;
}
}

public bool Evaluate(EvaluationContext evaluationContext, ref object state)
        {
            Console.WriteLine($"进入 {nameof(Evaluate)} 方法。");
            // 声明列表
            List<Claim> clist = new List<Claim>();
            clist.Add(new Claim("city", "广州", Rights.Identity));
            clist.Add(new Claim(ClaimTypes.Email, "sunset@163.com", "access"));
            // 实例化声明集
            ClaimSet clset = new DefaultClaimSet(clist);
            // 添加到上下文
            evaluationContext.AddClaimSet(this, clset);


return false;
        }

    }

声明集中放了两个声明,第一个的type用的自定义值city,resource是字符串“广州”,right用的是标准值;第二个声明的type用的是标准值,right是自定义值access。

然后,把它放到服务中。

      <serviceBehaviors>
<behavior>
<serviceAuthorization>
<authorizationPolicies>
<clear/>
<add policyType="Coc.CustPolicy, SomeApp771"/>
</authorizationPolicies>
</serviceAuthorization>
</behavior>
</serviceBehaviors>

由于Evaluate方法返回的是false,因此在运行后,你会看到以下恐怖的一幕。

【WCF】授权策略详解

EvaluationContext 类公开了一个属性,叫 Generation, 它是一个整数值,只要AddClaimSet方法被调用一次,Generation的值就会加1,可以看看.NET的源代码。

        public override void AddClaimSet(IAuthorizationPolicy policy, ClaimSet claimSet)
{
…… if (this.claimSets == null)
this.claimSets = new List<ClaimSet>(); this.claimSets.Add(claimSet);
++this.generation;
}

注意看最后一行,看到没,generation被 ++ 了,所以,每添加一次声明集,Generation就会增加1。

不信的话,可以把Evaluate方法做以下修改。

        public bool Evaluate(EvaluationContext evaluationContext, ref object state)
{
…… Console.WriteLine($"Generation = {evaluationContext.Generation}"); return false;
}

然后再运行,看看输出。

【WCF】授权策略详解

这个调用会一直循环,直到发生异常。为啥,因为在Evaluate方法中我们添加了声明集,而这个行为会导致Generation的值增加,从而使所有授权策略的Evaluate方法又被调用,如此不断循环下去。

但是,如果让Evaluate方法返回true,就不再死循环了,比如:

        public bool Evaluate(EvaluationContext evaluationContext, ref object state)
{
…… //return false;
return true;
}

好了,现在只调用一次就行了。

【WCF】授权策略详解

所以啊,只要评估通过,就应该返回true。

那么,为什么返回false会导致无限循环呢,我们再看.NET源代码,其中这么一段:

                object[] policyState = new object[authorizationPolicies.Count];
object done = new object(); int oldContextCount;
do
{
oldContextCount = evaluationContext.Generation; for (int i = ; i < authorizationPolicies.Count; i++)
{
if (policyState[i] == done)
continue; IAuthorizationPolicy policy = authorizationPolicies[i];
if (policy == null)
{
policyState[i] = done;
continue;
} if (policy.Evaluate(evaluationContext, ref policyState[i]))
{
policyState[i] = done; if (DiagnosticUtility.ShouldTraceVerbose)
{
TraceUtility.TraceEvent(TraceEventType.Verbose, TraceCode.AuthorizationPolicyEvaluated,
SR.GetString(SR.AuthorizationPolicyEvaluated, policy.Id));
}
}
} } while (oldContextCount < evaluationContext.Generation);

这段代码,你看不看得懂无所谓,重点是看里面的两套循环。最外层循环是个do...while,循环的退出条件是:evaluationContext的Generation属性的值不再增加,只要不++那就退出循环。刚刚我们说过,每调用一次AddClaimSet方法,generation的值就会++一回,所谓generation不再++,则表明AddClaimSet方法不再调用,而使它不被调用的方法是让Evaluate方法不被调用,只要Evaluate方法返回true就不会再被调用。

为什么呢,咱们看里面的for循环,如果Evaluate方法返回true,则让state的值设为done。

  if (policy.Evaluate(evaluationContext, ref policyState[i]))
{
policyState[i] = done; …………

而在for循环的每一轮执行中,先判断一下state是否为done,如果done了,就用continue;跳过。

                for (int i = ; i < authorizationPolicies.Count; i++)
{
if (policyState[i] == done)
continue;
…………

在for循环里面只要一continue,那么此轮循环就跳过了,这样后面的代码就不会执行,那么 Evaluate 方法就不再调用了。

正因为如此,在完成评估后,一定要让 Evaluate 方法返回 true。

自定义授权管理器

所谓自定义授权管理器,就是从 ServiceAuthorizationManager 类派生出一个类,并重写其 CheckAccessCore 方法,如果检查通过,允许调用者访问服务操作,就返回true,表示通过,如果不通过就返回false。

为什么要重写这个方法呢,你看看.NET源代码就明白了:

        protected virtual bool CheckAccessCore(OperationContext operationContext)
{
return true;
}

直接返回true,万能授权。

授权检查是以服务操作为单位的,即Operation,因为服务的每次调用,实际上你只能调用一个操作方法,因为WCF是基于消息的,跟HTTP一样,一问一答(当然也可以只问不答,比如单工模式),故授权是基于操作为单位的,CheckAccessCore方法就一个参数,OperationContext,这个东东是跟当前要调用的操作相关的信息。

下面我们来实现一下。

    class MyAuthorManager : ServiceAuthorizationManager
{
protected override bool CheckAccessCore(OperationContext operationContext)
{
ServiceSecurityContext sccontext = operationContext.ServiceSecurityContext;
// 检查声明集
foreach (ClaimSet clset in sccontext.AuthorizationContext.ClaimSets)
{
foreach (Claim c in clset.FindClaims("city", Rights.Identity))
{
if (c.Resource.ToString() == "佛山")
{
return true;
}
}
} return false;
}
}

其实这个授权检查会失败的,还记得吗,我们刚刚在自定义授权策略时,在Evaluate方法中,添加的声明集里面,其中有一个type为city,resource为“广州”,但是,你看看此处,我检测的值是“佛山”,所以,这个授权检测会返回false,表示授权不通过,想调用服务,没门!

接着,不要忘了,把刚定义的授权管理器类添加到授权的ServceBehavior中,下面是配置文件写法:

          <serviceAuthorization serviceAuthorizationManagerType="Coc.MyAuthorManager, SomeApp771">
<authorizationPolicies>
<clear/>
<add policyType="Coc.CustPolicy, SomeApp771"/>
</authorizationPolicies>
</serviceAuthorization>

实际上,就是指定一下serviceAuthorizationManagerType的值就可以了,注意要写上程序集名称。

好,现在,调用一下服务,你就会收到一个异常——“拒绝访问”.

【WCF】授权策略详解

然后,咱们把刚才的 MyAuthorManager 类的代码,把判断值“佛山”改为“广州”。

                foreach (Claim c in clset.FindClaims("city", Rights.Identity))
{
if (c.Resource.ToString() == "广州")
{
return true;
}
}

检测成功,返回true,所以此时服务就能正常调用了。

哟,今天给大伙讲的这个玩意儿有点不好理解,各位得有心理准备,但是,该克服的困难就应当克服,不要逃避。

示例源代码下载地址