使用devise、cancan和rolify组件建立用户权限模型的说明。
- devise:负责用户注册、登录、退出、找回密码等操作。细节参考devise on github
- cancan:负责角色建立、对角色授权、在页面中根据授权是否显示元素,以及模型中超出授权时抛出异常。细节参考rolify on github
- rolify:负责将用户与角色关联。细节参考rolify on github
其中,如果系统拥有自己独立的用户管理模块,可以不使用devise控件。这里先介绍仅包含cancan+rolify的部分。
一、环境安装配置
1.安装gem包,Gemfile。
gem 'cancan' gem 'rolify'
2. 创建cancan的Ability
$ rails generate cancan:ability #该命令在model中建立ability.rb文件
3.和rolify的Role
$ rails generate rolify Role User $ rake db:migrate #如下图所示 #在config中创建rolify的配置文件 #建立数据迁移文件,添加role,user_role模型,并创建数据表 #向user模型中添加rolify方法
至此,环境配置基本完成
二、权限管理
1.角色权限配置文件,集中管理权限信息
所有权限信息在app/models/ability.rb文件中存储,范例,如下:
class Ability include CanCan::Ability def initialize(user) if user.blank? # not logged in cannot :manage, :all basic_read_only elsif user.has_role?(:admin) # admin can :manage, :all elsif user.has_role?(:member) can :create, Topic can :update, Topic do |topic| (topic.user_id == user.id) end can :destroy, Topic do |topic| (topic.user_id == user.id) end basic_read_only else # banned or unknown situation cannot :manage, :all basic_read_only end end protected def basic_read_only can :read, Topic can :list, Topic can :search, Topic end end
2、权限判断
view中的权限:
<% if can? :update, @article %> <%= link_to "Edit", edit_article_path(@article) %> <% end %>
controller中的权限:
class ArticlesController < ApplicationController authorize_resource def show # @article is already authorized end end
3、用户角色添加
#在角色分配部分给用户实力user对象添加角色 @user.add_role 'admin'
附:authorize_resource方法解析
authorize_resource 根據 CanCan::Ability 的权限表对 resource 进行权限判断。
而 resource 必定是controller的同名实例。
也就是说 ArticlesController 对应的必然是 @article。
如果在 ArticlesController 里需要使用 @post,只需在 controller 里指定资源实例的名字,如,authorize_resource :post
三、devise的使用
1、安装gem包
gem 'devise'
2、devise初始化
$ rails generate devise:install
这句命令会产生一个用户指南,告诉你该做的几件事请,以下是内容翻译(已经去除heroku部署的那一条,增加了登录退出选项的说明):
1) 确定你的环境中有一个缺省的URL,config/environments/development.rb:
config.action_mailer.default_url_options = { :host => 'localhost:3000' }
如果在production环境, :host 必须设置成应用的真实主机名。
2) 确定已经在config/routes.rb中定义了root_url(注意删除public下面的index.html), 例如:
root :to => "home#index"
可以使用下面命令生成一个home#index的页面:
rails g controller home index
3) 在app/views/layouts/application.html.erb中增加消息提醒,例如:
class="notice"><%= notice %>
class="alert"><%= alert %>
4) 很多时候还需要增加登录、退出的选项:
$ rails g devise:views
生成用户模型(你可以使用其他名称代替User),并执行数据迁移
$ rails g devise User $ rake db:migrate #新建数据迁移文件,向user表中添加必要的字段
在Controller中增加认证过滤,即可在访问该模型页面时转向用户登录页面(这自行没验证)
在需要认证的模型中,如HomeController,增加下面代码:
before_filter :authenticate_user!
参考文档:
《Ruby on Rails: 使用devise+cancan+rolify建立完整的权限管理系统》
http://my.oschina.net/silentboy/blog/204772
《使用Devise+Rolify + Cancan 控管權限》
http://deveede.logdown.com/posts/206943-use-deviserolify-cancan-control-permissions
《Cancan 實作角色權限設計的最佳實踐(1、2、3) 》
ref:[http://blog.xdite.net/posts/2012/07/30/cancan-rule-engine-authorization-based-library-1/]
ref:[http://blog.xdite.net/posts/2012/07/30/cancan-rule-engine-authorization-based-library-2/]
ref:[http://blog.xdite.net/posts/2012/07/30/cancan-rule-engine-authorization-based-library-3/]
《Rails插件:CanCan权限验证插件学习总结》
ref:[http://blog.csdn.net/jackal998099/article/details/21519925]