這篇文章主要介紹了AngularJS中實(shí)現(xiàn)用戶訪問(wèn)的身份認(rèn)證及表單驗(yàn)證功能的方法,Angular是Google開(kāi)發(fā)的一款瀏覽器端的高人氣JavaScript框架,需要的朋友可以參考下
身份驗(yàn)證
權(quán)限的設(shè)計(jì)中比較常見(jiàn)的就是RBAC基于角色的訪問(wèn)控制,基本思想是,對(duì)系統(tǒng)操作的各種權(quán)限不是直接授予具體的用戶,而是在用戶集合與權(quán)限集合之間建立一個(gè)角色集合。每一種角色對(duì)應(yīng)一組相應(yīng)的權(quán)限。
一旦用戶被分配了適當(dāng)?shù)慕巧螅撚脩艟蛽碛写私巧乃胁僮鳈?quán)限。這樣做的好處是,不必在每次創(chuàng)建用戶時(shí)都進(jìn)行分配權(quán)限的操作,只要分配用戶相應(yīng)的角色即可,而且角色的權(quán)限變更比用戶的權(quán)限變更要少得多,這樣將簡(jiǎn)化用戶的權(quán)限管理,減少系統(tǒng)的開(kāi)銷(xiāo)。
在Angular構(gòu)建的單頁(yè)面應(yīng)用中,要實(shí)現(xiàn)這樣的架構(gòu)我們需要額外多做一些事.從整體項(xiàng)目上來(lái)講,大約有3處地方,前端工程師需要進(jìn)行處理.
1. UI處理(根據(jù)用戶擁有的權(quán)限,判斷頁(yè)面上的一些內(nèi)容是否顯示)
2. 路由處理(當(dāng)用戶訪問(wèn)一個(gè)它沒(méi)有權(quán)限訪問(wèn)的url時(shí),跳轉(zhuǎn)到一個(gè)錯(cuò)誤提示的頁(yè)面)
3. HTTP請(qǐng)求處理(當(dāng)我們發(fā)送一個(gè)數(shù)據(jù)請(qǐng)求,如果返回的status是401或者403,則通常重定向到一個(gè)錯(cuò)誤提示的頁(yè)面)
訪問(wèn)身份控制的實(shí)現(xiàn)
首先需要在Angular啟動(dòng)之前就獲取到當(dāng)前用戶的所有的 permissions,然后比較優(yōu)雅的方式是通過(guò)一個(gè)service存放這個(gè)映射關(guān)系.對(duì)于UI處理一個(gè)頁(yè)面上的內(nèi)容是否根據(jù)權(quán)限進(jìn)行顯示,我們應(yīng)該通 過(guò)一個(gè)directive來(lái)實(shí)現(xiàn).當(dāng)處理完這些,我們還需要在添加一個(gè)路由時(shí)額外為其添加一個(gè)"permission"屬性,并為其賦值表明擁有哪些權(quán)限 的角色可以跳轉(zhuǎn)這個(gè)URL,然后通過(guò)Angular監(jiān)聽(tīng)routeChangeStart事件來(lái)進(jìn)行當(dāng)前用戶是否擁有此URL訪問(wèn)權(quán)限的校驗(yàn).最后還需要 一個(gè)HTTP攔截器監(jiān)控當(dāng)一個(gè)請(qǐng)求返回的status是401或者403時(shí),跳轉(zhuǎn)頁(yè)面到一個(gè)錯(cuò)誤提示頁(yè)面.大致上的工作就是這些,看起來(lái)有些多,其實(shí)一個(gè)個(gè)來(lái)還是挺好處理的.
返回401,執(zhí)行l(wèi)oginCtrl,返回403執(zhí)行PermissionCtrl。
在Angular運(yùn)行之前獲取到permission的映射關(guān)系
Angular項(xiàng)目通過(guò)ng-app啟動(dòng),但是一些情況下我們是希望 Angular項(xiàng)目的啟動(dòng)在我們的控制之中.比如現(xiàn)在這種情況下,我就希望能獲取到當(dāng)前登錄用戶的所有permission映射關(guān)系后,再啟動(dòng) Angular的App.幸運(yùn)的是Angular本身提供了這種方式,也就是angular.bootstrap().
var permissionList;
angular.element(document).ready(function() {
$.get('/api/UserPermission', function(data) {
permissionList = data;
angular.bootstrap(document, ['App']);
});
});
看的仔細(xì)的人可能會(huì)注意到,這里使用的是$.get(),沒(méi)有錯(cuò)用的是jQuery而不是Angular的$resource或者$http,因?yàn)樵谶@個(gè)時(shí)候Angular還沒(méi)有啟動(dòng),它的function我們還無(wú)法使用.
進(jìn)一步使用上面的代碼可以將獲取到的映射關(guān)系放入一個(gè)service作為全局變量來(lái)使用.
// app.js
var app = angular.module('myApp', []), permissionList;
app.run(function(permissions) {
permissions.setPermissions(permissionList)
});
angular.element(document).ready(function() {
$.get('/api/UserPermission', function(data) {
permissionList = data;
angular.bootstrap(document, ['App']);
});
});
// common_service.js
angular.module('myApp')
.factory('permissions', function ($rootScope) {
var permissionList;
return {
setPermissions: function(permissions) {
permissionList = permissions;
$rootScope.$broadcast('permissionsChanged')
}
};
});
在取得當(dāng)前用戶的權(quán)限集合后,我們將這個(gè)集合存檔到對(duì)應(yīng)的一個(gè)service中,然后又做了2件事:
(1) 將permissions存放到factory變量中,使之一直處于內(nèi)存中,實(shí)現(xiàn)全局變量的作用,但卻沒(méi)有污染命名空間.
(2) 通過(guò)$broadcast廣播事件,當(dāng)權(quán)限發(fā)生變更的時(shí)候.
1.如何確定UI組件的依據(jù)權(quán)限進(jìn)行顯隱
這里我們需要自己編寫(xiě)一個(gè)directive,它會(huì)依據(jù)權(quán)限關(guān)系來(lái)進(jìn)行顯示或者隱藏元素.
<!-- If the user has edit permission the show a link -->
<div has-permission='Edit'>
<a href="/#/courses/{{ id }}/edit"> {{ name }}</a>
</div>
<!-- If the user doesn't have edit permission then show text only (Note the "!" before "Edit") -->
<div has-permission='!Edit'>
{{ name }}
</div>
這里看到了比較理想的情況是通關(guān)一個(gè)has-permission屬性校驗(yàn)permission的name,如果當(dāng)前用戶有則顯示,沒(méi)有則隱藏.
angular.module('myApp').directive('hasPermission', function(permissions) {
return {
link: function(scope, element, attrs) {
if(!_.isString(attrs.hasPermission))
throw "hasPermission value must be a string";
var value = attrs.hasPermission.trim();
var notPermissionFlag = value[0] === '!';
if(notPermissionFlag) {
value = value.slice(1).trim();
}
function toggleVisibilityBasedOnPermission() {
var hasPermission = permissions.hasPermission(value);
if(hasPermission && !notPermissionFlag || !hasPermission && notPermissionFlag)
element.show();
else
element.hide();
}
toggleVisibilityBasedOnPermission();
scope.$on('permissionsChanged', toggleVisibilityBasedOnPermission);
}
};
});
擴(kuò)展一下之前的factory:
angular.module('myApp')
.factory('permissions', function ($rootScope) {
var permissionList;
return {
setPermissions: function(permissions) {
permissionList = permissions;
$rootScope.$broadcast('permissionsChanged')
},
hasPermission: function (permission) {
permission = permission.trim();
return _.some(permissionList, function(item) {
if(_.isString(item.Name))
return item.Name.trim() === permission
});
}
};
});
2.路由上的依權(quán)限訪問(wèn)
這一部分的實(shí)現(xiàn)的思路是這樣: 當(dāng)我們定義一個(gè)路由的時(shí)候增加一個(gè)permission的屬性,屬性的值就是有哪些權(quán)限才能訪問(wèn)當(dāng)前url.然后通過(guò)routeChangeStart事 件一直監(jiān)聽(tīng)url變化.每次變化url的時(shí)候,去校驗(yàn)當(dāng)前要跳轉(zhuǎn)的url是否符合條件,然后決定是跳轉(zhuǎn)成功還是跳轉(zhuǎn)到錯(cuò)誤的提示頁(yè)面.
app.config(function ($routeProvider) {
$routeProvider
.when('/', {
templateUrl: 'views/viewCourses.html',
controller: 'viewCoursesCtrl'
})
.when('/unauthorized', {
templateUrl: 'views/error.html',
controller: 'ErrorCtrl'
})
.when('/courses/:id/edit', {
templateUrl: 'views/editCourses.html',
controller: 'editCourses',
permission: 'Edit'
});
});
mainController.js 或者 indexController.js (總之是父層Controller)
app.controller('mainAppCtrl', function($scope, $location, permissions) {
$scope.$on('$routeChangeStart', function(scope, next, current) {
var permission = next.$$route.permission;
if(_.isString(permission) && !permissions.hasPermission(permission))
$location.path('/unauthorized');
});
});
這里依然用到了之前寫(xiě)的hasPermission,這些東西都是高度可復(fù)用的.這樣就搞定了,在每次view的route跳轉(zhuǎn)前,在父容器的Controller中判斷一些它到底有沒(méi)有跳轉(zhuǎn)的權(quán)限即可.
3.HTTP請(qǐng)求處理
這個(gè)應(yīng)該相對(duì)來(lái)說(shuō)好處理一點(diǎn),思想的思路也很簡(jiǎn)單.因?yàn)锳ngular應(yīng)用推薦的是RESTful風(fēng)格的借口,所以對(duì)于HTTP協(xié)議的使用很清晰.對(duì)于請(qǐng)求返回的status code如果是401或者403則表示沒(méi)有權(quán)限,就跳轉(zhuǎn)到對(duì)應(yīng)的錯(cuò)誤提示頁(yè)面即可.
當(dāng)然我們不可能每個(gè)請(qǐng)求都去手動(dòng)校驗(yàn)轉(zhuǎn)發(fā)一次,所以肯定需要一個(gè)總的filter.代碼如下:
angular.module('myApp')
.config(function($httpProvider) {
$httpProvider.responseInterceptors.push('securityInterceptor');
})
.provider('securityInterceptor', function() {
this.$get = function($location, $q) {
return function(promise) {
return promise.then(null, function(response) {
if(response.status === 403 || response.status === 401) {
$location.path('/unauthorized');
}
return $q.reject(response);
});
};
};
});
寫(xiě)到這里就差不多可以實(shí)現(xiàn)在這種前后端分離模式下,前端部分的權(quán)限管理和控制了。
表單驗(yàn)證
AngularJS 前端驗(yàn)證指令
var rcSubmitDirective = {
'rcSubmit': function ($parse) {
return {
restrict: "A",
require: [ "rcSubmit", "?form" ],
controller: function() {
this.attempted = false;
var formController = null;
this.setAttempted = function() {
this.attempted = true;
};
this.setFormController = function(controller) {
formController = controller;
};
this.needsAttention = function(fieldModelController) {
if (!formController) return false;
if (fieldModelController) {
return fieldModelController.$invalid && (fieldModelController.$dirty || this.attempted);
} else {
return formController && formController.$invalid && (formController.$dirty || this.attempted);
}
};
},
compile: function() {
return {
pre: function(scope, formElement, attributes, controllers) {
var submitController = controllers[0];
var formController = controllers.length > 1 ? controllers[1] : null;
submitController.setFormController(formController);
scope.rc = scope.rc || {};
scope.rc[attributes.name] = submitController;
},
post: function(scope, formElement, attributes, controllers) {
var submitController = controllers[0];
var formController = controllers.length > 1 ? controllers[1] : null;
var fn = $parse(attributes.rcSubmit);
formElement.bind("submit", function(event) {
submitController.setAttempted();
if (!scope.$$phase) scope.$apply();
if (!formController.$valid) return;
scope.$apply(function() {
fn(scope, {
$event: event
});
});
});
}
};
}
};
}
};
驗(yàn)證通過(guò)
<form name="loginForm" novalidate
ng-app="LoginApp" ng-controller="LoginController" rc-submit="login()">
<div class="form-group"
ng-class="{'has-error': rc.loginForm.needsAttention(loginForm.username)}">
<input class="form-control" name="username" type="text"
placeholder="Username" required ng-model="session.username" />
<span class="help-block"
ng-show="rc.form.needsAttention(loginForm.username) && loginForm.username.$error.required">Required</span>
</div>
<div class="form-group"
ng-class="{'has-error': rc.loginForm.needsAttention(loginForm.password)}">
<input class="form-control" name="password" type="password"
placeholder="Password" required ng-model="session.password" />
<span class="help-block"
ng-show="rc.form.needsAttention(loginForm.password) && loginForm.password.$error.required">Required</span>
</div>
<div class="form-group">
<button type="submit" class="btn btn-primary pull-right"
value="Login" title="Login">
<span>Login</span>
</button>
</div>
</form>
樣式如下
前端驗(yàn)證通過(guò)會(huì)調(diào)用login()。