rails权限管理—devise+cancan+rolify

时间:2023-11-12 17:05:44

使用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文件

rails权限管理—devise+cancan+rolify

3.和rolify的Role

$ rails generate rolify Role User
$ rake db:migrate #如下图所示
#在config中创建rolify的配置文件
#建立数据迁移文件,添加role,user_role模型,并创建数据表
#向user模型中添加rolify方法

rails权限管理—devise+cancan+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

rails权限管理—devise+cancan+rolify

这句命令会产生一个用户指南,告诉你该做的几件事请,以下是内容翻译(已经去除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中增加消息提醒,例如:

<p class="notice"><%= notice %></p>  <p class="alert"><%= alert %></p>

4) 很多时候还需要增加登录、退出的选项:

<% if current_user %>
<%= link_to('退出', destroy_user_session_path, :method => :delete) %> |
<%= link_to('修改密码', edit_registration_path(:user)) %>
<% else %>
<%= link_to('注册', new_registration_path(:user)) %> |
<%= link_to('登录', new_session_path(:user)) %>
<% end %><span></span>

5) 如果要定制Devise的view模型,可以再执行以下语句:

$ rails g devise:views

生成用户模型(你可以使用其他名称代替User),并执行数据迁移

$ rails g devise User
$ rake db:migrate
#新建数据迁移文件,向user表中添加必要的字段

rails权限管理—devise+cancan+rolify

rails权限管理—devise+cancan+rolify

在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]