Angular 常常会被用到后台和管理工具的开发,这两类都会须要对用户进行鉴权。而鉴权的第一步,就是进行身份验证。因为 Angular 是单页应用,会在一开始,就把大部分的资源加载到浏览器中,因此就更须要注意验证的时机,并保证只有经过了验证的用户才能看到对应的界面。css
本篇文章中的身份验证,指的是如何肯定用户是否已经登陆,并确保在每次与服务器的通讯中,都可以知足服务器的验证需求。注意,并不包括对具体是否具备某一个权限的判断。html
对于登陆,主要是接受用户的用户名密码输入,提交到服务器进行验证,处理验证响应,在浏览器端构建身份验证数据。前端
目前,实现身份验证的方法,主要有两个大类:git
传统的浏览器网页,都是使用 Cookies 来验证身份,实际上,浏览器端的应用层里,基本不用去管身份验证的事情,Cookies 的设置,由服务器端完成,在提交请求的时候,由浏览器自动附加对应的 Cookies 信息,因此在 JavaScript 代码中,不须要为此编写专门的代码。但每次请求的时候,都会带上所有的 Cookies 数据,angularjs
随着 CDN 的应用,移动端的逐渐兴起, Cookies 愈来愈不能知足复杂的、多域名下的身份验证需求。github
实际上基于密钥的身份验证并非最近才兴起,它一直存在,甚至比 Cookies 历史更长。当浏览器在请求服务器的时候,将密钥以特定的方式附加在请求中,好比放在请求的头部( headers )。为此,须要编写专门的客户端代码来管理。算法
最近出现的基于 JSON 的 Web 密钥(JSON Web Token)标准,即是典型的使用密钥来实现的身份验证。数据库
在 Web 应用中,若是是构造 API ,则应优先考试使用密钥方式。后端
登陆是身份验证第一步,经过登陆,才可以组织起来对应的身份验证数据。浏览器
登陆页的处理,有两种方式:
通常状况下,使用单独的登陆页的目的在于保护登陆后跳转的页面不被匿名用户访问。所以,在登陆页里,构造一个表单,直接采用传统的表彰提交方式(非 Ajax),后端验证用户名密码成功后,输出登陆后单面应用页面的 HTML 。
在这种状况下,能够直接将身份验证信息放在输出的 HTML 里,好比,可使用 Jade 构造一个这样的页面:
1 2 3 4 5 6 7 8 9 10 |
<!-- dashboard.jade --> doctype html html head link(rel="stylesheet", href="/assets/app.e1c2c6ea9350869264da10de799dced1.css") body script. window.token = !{JSON.stringify(token)}; div.md-padding(ui-view) script(src="/assets/app.84b1e53df1b4b23171da.js") |
后端在用户名密码验证成功以后,能够采用以下的方式来渲染输出 HTML :
1 2 3 |
return res.render('dashboard', { token: token }); |
Angular 应用一启动,即可以进行须要使用身份验证的通讯。并且还保证了只有登陆成功的用户才能够进入这个页面。
对于多视图的 Angular 应用,通常会采用路由,在页面以内,通常有固定的侧边栏菜单,或者顶部导航菜单,正文区域由路由模块来控制。
下面的示例代码,使用的是 Angular Material 来组织页面,路由模块使用的是 ui-router 。在应用打开的时候,有专门的加载动画,加载完成以后,显示的页面,使用 AppController
这个控制器,对于没有登陆的用户,会显示登陆表单,登陆完成以后,页面分为三大部分,一是顶部面包屑导航,二是侧边栏菜单,另外就是路由控制的正文部分。代码以下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 |
<body ng-app="app" layout="row"> <div id="loading"> <!--页面加载的提示--> </div> <div flex layout="row" ng-cloak ng-controller="AppController" ng-init="load()"> <div ng-if="!isUserAuth", ng-controller="LoginController"> <!--登陆表单--> </div> <div ng-if="isUserAuth" flex layout="row"> <md-sidenav flex="15" md-is-locked-open="true" class="stop-text-select bbmd-sidebar md-whiteframe-4dp"> <!--侧边栏菜单--> </md-sidenav> <md-content flex layout="column" role="main"> <md-toolbar class="stop-text-select md-whiteframe-glow-z1"> <!--顶部菜单--> </md-toolbar> <md-content> <!--路由--> <div ui-view class="md-padding"></div> </md-content> </md-content> </div> </div> </body> |
对于 Loading 动画,是在 AppController
以外的,能够在 AppController
的代码中,对其进行隐藏。这样达到了全部 CSS / JavaScript 加载完成以后 Loading 就消失的目的。
AppController
中有一个变量 isUserAuth
,初始化的时候是 false
,当本地存储的会话信息验证有效,或者登陆完成以后,这个值便会置为 ture
,因为 ng-if
的控制,即可以实现隐藏登陆表单、显示应用内容的目的。要注意,这里只有使用 ng-if
而不是 ng-show/ng-hide
,前者才会真正的删除和增长 DOM 元素,然后者只是修改某个 DOM 元素的 CSS 属性,这点很重要,只有这样,才可以保证登陆完成以后,再加载单页应用中的内容,防止尚未登陆,当前路由中的控制器代码就直接执行了。
一个比较理想的基于用户名和密码的登陆流程是这样的:
md5(username + md5(md5(password)))
,再将密码哈希值和用户名提交给后端可能有 80% 的人没法理解为何要把一个登陆作得这么复杂。这可能要写一篇专门的文章才解释得清楚。在这里先解释一下为何浏览器端要对密码作哈希,缘由以下:
这种作法,使得用户的最大风险,也只是当前这个应用中的数据被窃取。不会扩大损失范围,毫不会出现 CSDN 之流的问题。
对于有些应用,并非全部的页面都须要用户登陆的,多是进行某些操做的时候,才须要登陆。在这种状况下,登陆完成以后,必需要通知整个应用。这可使用广播这个功能。
简易代码以下:
1 2 3 4 5 6 7 8 9 10 11 12 |
angular .module('app') .controller('LoginController', ['$rootScope', LoginController]); function LoginController($rootScope) { // 登陆成功以后调用的函数 function afterLoginSuccess() { $rootScope.$broadcast('user.login.success', { // 须要传输的数据 }); } } |
在其它的控制器中,即可以监听这个广播,并执行登陆成功以后须要进行的操做,如获取列表或者详情:
1 2 3 |
$scope.$on('user.login.success', function(handle, data){ // 处理 }); |
登陆成功以后,服务器返回了密钥,以后的 API 请求都须要带上密钥,并且请求返回的响应,还须要检查是不是关于身份信息失效的错误。这一系列的工做比较繁琐,应该是自动完成才行。
密钥的保存,大概有以下几个办法:
比较好的办法是,身份验证信息存储在 localStorage 里,但在应用启动时,初始化到 Angular 的单例 Service 中。
身份验证信息的目的,是为了向服务器代表身份,获取数据。因此,在请求中须要附加身份验证信息。
通常的应用中,身份验证信息都是放在请求的 headers 头部中。若是在每次请求的时候,一一设置 headers ,那就太费时费力了。Angular 中的 $httpProvider
提供了一个拦截器 interceptors
,经过它能够实现对每个请求和响应的统一处理。添加拦截器的方式以下:
1 2 3 4 5 |
angular .module('app') .config(['$httpProvider', function($httpProvider){ $httpProvider.interceptors.push(HttpInterceptor); }]); |
HttpInterceptor
的定义方式以下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
angular .module('app') .factory('HttpInterceptor', ['$q', HttpInterceptor]); function HttpInterceptor($q) { return { // 请求发出以前,能够用于添加各类身份验证信息 request: function(config){ if(localStorage.token) { config.headers.token = localStorage.token; } return config; }, // 请求发出时出错 requestError: function(err){ return $q.reject(err); }, // 成功返回了响应 response: function(res){ return res; }, // 返回的响应出错,包括后端返回响应时,设置了非 200 的 http 状态码 responseError: function(err){ return $q.reject(err); } }; } |
拦截器提供了对发出请求到返回响应的全生命周期处理,通常能够用来作下面几个事情:
在上面的示例代码中,当 localStorage 中包括 token
这个值时,就在每个请求的头部,添加一个 token
值。
通常的,后端应该在 token
验证失败时,将响应的 http 状态码设置为 401 ,这样,在拦截器的 responseError
中即可以统一处理:
1 2 3 4 5 6 7 8 9 10 |
responseError: function(err){ if(-1 === err.status) { // 远程服务器无响应 } else if(401 === err.status) { // 401 错误通常是用于身份验证失败,具体要看后端对身份验证失败时抛出的错误 } else if(404 === err.status) { // 服务器返回了 404 } return $q.reject(err); } |
其实,只要服务器返回的状态码不是 200 ,都会调用 responseError
,能够在这里,统一处理并显示错误