Web用户的身份验证及WebApi权限验证流程的设计和实现
Posted Honnnnl
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Web用户的身份验证及WebApi权限验证流程的设计和实现相关的知识,希望对你有一定的参考价值。
前言:Web 用户的身份验证,及页面操作权限验证是B/S系统的基础功能,一个功能复杂的业务应用系统,通过角色授权来控制用户访问,本文通过Form认证,Mvc的Controller基类及Action的权限验证来实现Web系统登录,Mvc前端权限校验以及WebApi服务端的访问校验功能。
1. Web Form认证介绍
Web应用的访问方式因为是基于浏览器的Http地址请求,所以需要验证用户身份的合法性。目前常见的方式是Form认证,其处理逻辑描述如下:
1. 用户首先要在登录页面输入用户名和密码,然后登录系统,获取合法身份的票据,再执行后续业务处理操作;
2. 用户在没有登录的情况下提交Http页面访问请求,如果该页面不允许匿名访问,则直接跳转到登录页面;
3. 对于允许匿名访问的页面请求,系统不做权限验证,直接处理业务数据,并返回给前端;
4. 对于不同权限要求的页面Action操作,系统需要校验用户角色,计算权限列表,如果请求操作在权限列表中,则正常访问,如果不在权限列表中,则提示“未授权的访问操作”到异常处理页面。
2. WebApi 服务端Basic 方式验证
WebApi服务端接收访问请求,需要做安全验证处理,验证处理步骤如下:
1. 如果是合法的Http请求,在Http请求头中会有用户身份的票据信息,服务端会读取票据信息,并校验票据信息是否完整有效,如果满足校验要求,则进行业务数据的处理,并返回给请求发起方;
2. 如果没有票据信息,或者票据信息不是合法的,则返回“未授权的访问”异常消息给前端,由前端处理此异常。
3. 登录及权限验证流程
流程处理步骤说明:
1. 用户打开浏览器,并在地址栏中输入页面请求地址,提交;
2. 浏览器解析Http请求,发送到Web服务器;Web服务器验证用户请求,首先判断是否有登录的票据信息;
3. 用户没有登录票据信息,则跳转到登录页面;
4. 用户输入用户名和密码信息;
5. 浏览器提交登录表单数据给Web服务器;
6. Web服务需要验证用户名和密码是否匹配,发送api请求给api服务器;
7. api用户账户服务根据用户名,读取存储在数据库中的用户资料,判断密码是否匹配;
1)如果用户名和密码不匹配,则提示密码错误等信息,然该用户重新填写登录资料;
2)如果验证通过,则保存用户票据信息;
8. 接第3步,如果用户有登录票据信息,则跳转到用户请求的页面;
9. 验证用户对当前要操作的页面或页面元素是否有权限操作,首先需要发起api服务请求,获取用户的权限数据;
10. api用户权限服务根据用户名,查找该用户的角色信息,并计算用户权限列表,封装为Json数据并返回;
11. 当用户有权限操作页面或页面元素时,跳转到页面,并由页面Controller提交业务数据处理请求到api服务器;
如果用户没有权限访问该页面或页面元素时,则显示“未授权的访问操作”,跳转到系统异常处理页面。
12. api业务服务处理业务逻辑,并将结果以Json 数据返回;
13. 返回渲染后的页面给浏览器前端,并呈现业务数据到页面;
14. 用户填写业务数据,或者查找业务数据;
15. 当填写或查找完业务数据后,用户提交表单数据;
16. 浏览器脚本提交get,post等请求给web服务器,由web服务器再次解析请求操作,重复步骤2的后续流程;
17. 当api服务器验证用户身份是,没有可信用户票据,系统提示“未授权的访问操作”,跳转到系统异常处理页面。
4. Mvc前端代码示例
4.1 用户登录AccountController
4.2 用户模型AccountModel
4.3 控制器基类WebControllerBase
4.5 业务Controller示例
5. WebApi 服务端代码示例
5.1 控制器基类ApiControllerBase
/// <summary> /// Controller的基类,用于实现适合业务场景的基础功能 /// </summary> /// <typeparam name="T"></typeparam> [BasicAuthentication] public abstract class ApiControllerBase : ApiController { }
5.2 权限属性BaseAuthenticationAttribute
/// <summary> /// 基本验证Attribtue,用以Action的权限处理 /// </summary> public class BasicAuthenticationAttribute : ActionFilterAttribute { /// <summary> /// 检查用户是否有该Action执行的操作权限 /// </summary> /// <param name="actionContext"></param> public override void OnActionExecuting(HttpActionContext actionContext) { //检验用户ticket信息,用户ticket信息来自调用发起方 if (actionContext.Request.Headers.Authorization != null) { //解密用户ticket,并校验用户名密码是否匹配 var encryptTicket = actionContext.Request.Headers.Authorization.Parameter; if (ValidateUserTicket(encryptTicket)) base.OnActionExecuting(actionContext); else actionContext.Response = new HttpResponseMessage(HttpStatusCode.Unauthorized); } else { //检查web.config配置是否要求权限校验 bool isRquired = (WebConfigurationManager.AppSettings["WebApiAuthenticatedFlag"].ToString() == "true"); if (isRquired) { //如果请求Header不包含ticket,则判断是否是匿名调用 var attr = actionContext.ActionDescriptor.GetCustomAttributes<AllowAnonymousAttribute>().OfType<AllowAnonymousAttribute>(); bool isAnonymous = attr.Any(a => a is AllowAnonymousAttribute); //是匿名用户,则继续执行;非匿名用户,抛出“未授权访问”信息 if (isAnonymous) base.OnActionExecuting(actionContext); else actionContext.Response = new HttpResponseMessage(HttpStatusCode.Unauthorized); } else { base.OnActionExecuting(actionContext); } } } /// <summary> /// 校验用户ticket信息 /// </summary> /// <param name="encryptTicket"></param> /// <returns></returns> private bool ValidateUserTicket(string encryptTicket) { var userTicket = FormsAuthentication.Decrypt(encryptTicket); var userTicketData = userTicket.UserData; string userName = userTicketData.Substring(0, userTicketData.IndexOf(":")); string password = userTicketData.Substring(userTicketData.IndexOf(":") + 1); //检查用户名、密码是否正确,验证是合法用户 //var isQuilified = CheckUser(userName, password); return true; } }
5.3 api服务Controller实例
public class ProductController : ApiControllerBase { [HttpGet] public object Find(string id) { return ProductServiceInstance.Find(2); } // GET api/product/5 [HttpGet] [AllowAnonymous] public Product Get(string id) { var headers = Request.Headers; var p = ProductServiceInstance.GetById<Product, EPProduct>(long.Parse(id)); if (p == null) { throw new HttpResponseException(new HttpResponseMessage(HttpStatusCode.BadRequest) Content = new StringContent("id3 not found"), ReasonPhrase = "product id not exist." }); } return p; } }
6. 其它配置说明
6.1 Mvc前端Web.Config 配置
machineKey节点配置,是应用于对用户ticket数据加密和解密。
6.2 WebApi服务端Web.Config配置
7. 总结
Web系统的用户登录及页面操作权限验证在处理逻辑上比较复杂,需要考虑到Form认证、匿名访问,Session和Cookie存储,以及Session和Cookie的过期处理,本文实现了整个权限验证框架的基本功能,供系统架构设计人员以及Web开发人员参考。
以上是关于Web用户的身份验证及WebApi权限验证流程的设计和实现的主要内容,如果未能解决你的问题,请参考以下文章