Authorization其目标就是验证Http请求能否通过验证。ASP.Net Core提供了很多种Authorization方式，详细可以参考 微软官方文档。在这里只详细介绍三种方式：
- Policy
- Middleware
- Custom Attribute
1. Policy : 策略授权
先定义一个IAuthorizationRequirement类来定义策略的要求，以下例子支持传递一个age参数。
public class AdultPolicyRequirement : IAuthorizationRequirement
{
public int Age { get; }
public AdultPolicyRequirement(int age)
{
//年龄限制
this.Age = age;
}
}
然后定义策略要求的Handler，当提供的Controller被请求时先根据请求的Http报文来决定是否可以通过验证。
public class AdultAuthorizationHandler : AuthorizationHandler
{
protected override Task HandleRequirementAsync(AuthorizationHandlerContext context, AdultPolicyRequirement requirement)
{
//获取当前http请求的context对象
var mvcContext = context.Resource as AuthorizationFilterContext;
//以下代码都不是必须的，只是展示一些使用方法，你可以选择使用
......
//
var age = mvcContext.HttpContext.Request.Query.FirstOrDefault(u => u.Key == "age");
if (age.Value.Count <= 0|| Convert.ToInt16(age.Value[0]) < requirement.Age)
{
context.Fail();
}
else
{
//通过验证，这句代码必须要有
context.Succeed(requirement);
}
return Task.CompletedTask;
}
}
还需要在启动时，在services里注册定义的策略和对应的Handler
//添加二种认证策略，一种以12岁为界限，一种是18岁
services.AddAuthorization(options =>
{
options.AddPolicy("Adult1", policy =>
policy.Requirements.Add(new AdultPolicyRequirement(12)));
options.AddPolicy("Adult2", policy =>
policy.Requirements.Add(new AdultPolicyRequirement(18)));
});
//添加策略验证handler
services.AddSingleton();
最后在相应的Controller前加上Authroize特性 [Authorize("Adult1")]。总体上Policy这种方式比较简单，但是也有不灵活的地方，不同的策略要求都需要提前在services里注册。完整的例子可以参考 PolicySample
2. Middleware: 中间件方式
这种方式并不是专门用于授权，它的用途更广更灵活,它用于在所有Http Request和Response前授权检查、数据处理、错误跳转、日志处理等。详细说明可以参考 官方Middleware说明。
image
这个图是基本的结构和运行图，我们可以创建多个中间组件，组成一个管道，在Http的Request发出和Response创建之前对HttpContext.Request和HttpContext.Response进行处理。看以下例子，定义了2个中间组件类：
public class AuthorizeMiddleware
{
private readonly RequestDelegate next;
public AuthorizeMiddleware(RequestDelegate next)
{
this.next = next;
}
public async Task Invoke(HttpContext context /* other scoped dependencies */)
{
//以下代码都不是必须的，只是展示一些使用方法，你可以选择使用
...
//这个例子只是修改一下response的header
context.Response.OnStarting(state => {
var httpContext = (HttpContext)state;
httpContext.Response.Headers.Add("test2", "testvalue2");
return Task.FromResult(0);
}, context);
//处理结束转其它中间组件去处理
await next(context);
}
}
public class OtherMiddleware
{
private readonly RequestDelegate next;
public OtherMiddleware(RequestDelegate next)
{
this.next = next;
}
public async Task Invoke(HttpContext context )
{
//这个例子只是修改一下response的header
context.Response.OnStarting(state => {
var httpContext = (HttpContext)state;
httpContext.Response.Headers.Add("test1", "testvalue1" );
return Task.FromResult(0);
}, context);
await next(context);
}
}
这里定义的类不需要实现接口或集成系统的类。只需要给app增加middleware代理类的定义。注意在HttpResponse发出之后就不要再调用next.invoke()。以下三句代码的执行顺序不能弄错。
app.UseMiddleware(typeof(AuthorizeMiddleware));
app.UseMiddleware(typeof(OtherMiddleware));
app.UseMvc();
执行web请求后执行的顺序是：
- 执行AuthorizeMiddleware的invoke方法
- 执行OtherMiddleware的invoke方法
- 执行ValueController的Get方法
- 执行OtherMiddleware的修改header方法
- 执行AuthorizeMiddleware的修改header方法
- 发出Http Response
大家可以自己执行一下代码来理解。代码参考 Github地址
3. Custom Attribute:自定义特性
这里其实是第一种Policy策略和自定义特性的结合，从而实现在Controller的具体方法位置自定义不同参数的Policy策略。
首先需要定义这个Attribute和策略要求类
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
public class PermissionCheckAttribute : AuthorizeAttribute
{
public string Id { get; set; }
public int Operation { get; set; }
public PermissionCheckAttribute() : base("PermissionCheck")
{
}
}
public class PermissionCheckPolicyRequirement : IAuthorizationRequirement
{
//Add any custom requirement properties if you have them
public PermissionCheckPolicyRequirement()
{
}
}
再定义策略和Attribute对应的Handler处理类
public class PermissionCheckPolicyHandler : AttributeAuthorizationHandler<PermissionCheckPolicyRequirement, PermissionCheckAttribute>
{
protected override Task HandleRequirementAsync(AuthorizationHandlerContext authoriazationContext,
PermissionCheckPolicyRequirement requirement, IEnumerable<PermissionCheckAttribute> attributes)
{
var context = authoriazationContext.Resource as AuthorizationFilterContext;
foreach (var permissionAttribute in attributes)
{
this.checkPermission(context, permissionAttribute.Id, permissionAttribute.Operation);
}
authoriazationContext.Succeed(requirement);
return Task.FromResult<object>(null);
}
private void checkPermission(AuthorizationFilterContext context, string _Id, int _Operation)
{
if (_Operation > 0)
{
if (_Id != "user1")
{
throw new Exception("不具备操作权限");
}
}
else
{
//dosomething
}
return;
}
}
同样还需要在service里添加策略和策略处理类，这里不贴代码了。最后在Controller里使用带参数的Attribute，类似如下：
[HttpGet]
[PermissionCheck (Id ="user1", Operation=2)]
public IEnumerable Get()
{
return new string[] { "value1", "value2" };
}
// GET api/values/5
[HttpGet("{id}")]
[PermissionCheck(Id = "user2", Operation = 4)]
public string Get(int id)
{
return "value";
}
完整的代码参考Github地址
网友评论