Ralasafe开源有段时间了,大约有2个月了。根据社区的反馈,我打算围绕Ralasafe最佳实践,书写一系列BLOG。
大体内容有:
1, 登录控制: 哪些页面需要登录后才能访问,登录用户名、密码验证,登录转向页面;
2, URL权限控制:哪些页面访问需要进行角色权限验证,怎样验证最简单有效,如何处理验证失败情况;
3, 数据级权限管理方案探讨:选择中间件呢还是框架?
4, Ralasafe体系结构: 用户怎么读取,用户有哪些字段,怎样与应用基础;
5, 数据级查询权限管理: 如何给不同的人分配不同的查询数据权限,返回where条件呢,还是直接返回结果集?
6, 数据级决策权限管理: 如何给不同的人分配不同的数据操作权限,当用户不具备权限怎么办?
7, 其他细小的权限控制: 如下拉框显示内容;按钮、链接是否显示,图片是否显示等。
-------------------------------------------- ------- --------------------------------------
今天说的登录控制,内容主要有:哪些页面需要登录控制、登录验证逻辑、登
录后页面转向哪里,以及权限菜单等问题。虽然本系列讲解权限管理,尤其是数据级权限管理。但严格意义来说,登录控制,并不属于权限管理内容。它属于用户身
份认证内容。权限基本都与用户相关,用户首先就涉及到用户名密码验证。所以我们从这里开始说起。
需求考察
仔细考察登录控制,无外乎这些需求:
- 哪些页面需要登录后才能查看,而且哪些页面还需要进一步验证角色权限;
- 登录页面在哪里?
- 登录用户名、密码验证;
- 登录后转向哪个页面?
分析清楚需求后,我们来考察使用什么方案,以其达到目标:将共用与个性的东西分开,而且尽可能共同,个性的东西尽可能使用配置方式。
解决方案
- 登录界面和登录转向后页面,由开发人员编写,这属于个性化内容,有CSS、页面布局等;
- 哪些页面需要登录才能查看,可以通过Filter来控制:哪些页面需要控制,使用web.xml里面的url-pattern,是否登录使用Filter验证session;
- 哪些页面还需要进行角色权限验证,这个我们拆分出去,做为功能权限验证,以后再谈;
- 用户名、密码验证可以共用:就是从request中读取用户名、密码值,或许可能还要对密码进行加密,然后与数据库用户表相关字段进行比对。
- 登录后页面转向:通过给session添加一个gotoPage属性,验证成功后转向该页面即可。
实例说明
ralasafe/demo里面的页面需要登录后才能访问,ralasafe/demo/login.jsp页面是登录页面;ralasafe/demo/main.jsp是登录后,显示功能菜单的页面。
配置LoginFilter
我们先将LoginFilter配置到web.xml文件:
-
<
filter
>
-
<filter-name>ralasafe/LoginFilter</filter-name>
-
<filter-class>org.ralasafe.webFilter.LoginFilter</filter-class>
-
<init-param>
-
<param-name>loginPage</param-name>
-
<param-value>/ralasafe/demo/login.jsp</param-value>
-
</init-param>
-
<init-param>
-
<param-name>uniqueFieldsParams</param-name>
-
<param-value>loginName</param-value>
-
</init-param>
-
<init-param>
-
<param-name>passwordParam</param-name>
-
<param-value>password</param-value>
-
</init-param>
-
<!--init-param>
-
<param-name>encryptMethod</param-name>
-
<param-value>shahex</param-value>
-
</init-param-->
-
</
filter
>
<filter>
<filter-name>ralasafe/LoginFilter</filter-name>
<filter-class>org.ralasafe.webFilter.LoginFilter</filter-class>
<init-param>
<param-name>loginPage</param-name>
<param-value>/ralasafe/demo/login.jsp</param-value>
</init-param>
<init-param>
<param-name>uniqueFieldsParams</param-name>
<param-value>loginName</param-value>
</init-param>
<init-param>
<param-name>passwordParam</param-name>
<param-value>password</param-value>
</init-param>
<!--init-param>
<param-name>encryptMethod</param-name>
<param-value>shahex</param-value>
</init-param-->
</filter>
这里有几个属性上面没有提到。uniqueFieldsParams表示页面的哪些字段可以唯一确定用户,一般情况下只有一个参数。这里配置是loginName(Login页面的字段input name属性),那么login.jsp里面就有这样的代码:
-
<
input
name
="
<
span
style="
color
: rgb(255, 0, 0);"
>
<
strong
>
loginName
</
strong
>
</
span
>
"
type
=
"text"
class
=
"username"
>
<input name="loginName" type="text" class="username">
如果需要多个字段确定一个用户,比如需要用户名+机构唯一确定,那么web.xml可以配置成:
-
<
init-param
>
-
<param-name>uniqueFieldsParams</param-name>
-
<param-value>loginName,<span style="color: rgb(255, 0, 0);"><strong>unitId</strong></span></param-value>
-
</
init-param
>
<init-param>
<param-name>uniqueFieldsParams</param-name>
<param-value>loginName,unitId</param-value>
</init-param>
passwordParam表示页面哪个字段是密码字段;encryptMethod表示密码使用什么加密方法,ralasafe提供了base64,md5hex,shahex加密方法。你也可以自行开发加密方法,详见LoginFilter javadoc。
哪些页面需要登录验证
我们只要将需要验证的页面,安装该Filter即可。配置web.xml:
-
<
filter-mapping
>
-
<filter-name>ralasafe/LoginFilter</filter-name>
-
<url-pattern>/ralasafe/demo/*</url-pattern>
-
</
filter-mapping
>
<filter-mapping>
<filter-name>ralasafe/LoginFilter</filter-name>
<url-pattern>/ralasafe/demo/*</url-pattern>
</filter-mapping>
表示ralasafe/demo下的所有URL资源都需要经过LoginFilter过滤。
验证逻辑
验证逻辑全部在LoginFilter里面。LoginFilter主要做这些事情:
- 首先判断客户端是否在请求登录页面,如果是,那么转向登录页面,以免造成死循环;
- 然后如果是请求登录,那么读取用户名、密码(可能密码还要加密)进行验证;
- 如果不是请求登录,那么这时需要查看session用户是否登录了。如果没有登录,那么转到登录页面;如果已经登录继续doChain。
细心的朋友会问,怎样去后台验证用户名密码呢?
Ralasafe是通过配置元数据(
详见这里),来告诉系统哪张表是用户表,哪些字段是用户唯一字段(和LoginFilter里里面的
uniqueFieldsParams顺序对应上即可,无需名称相同)。
LoginFilter字段指明哪个字段是密码字段,LoginFilter还需要指明和用户表的哪个字段进行比较。也就是userPasswordField参数意义。详见:
LoginFilter javadoc。
登录页面转向
如果客户端在没有登录的情况下,请求/ralasafe/demo/employMng路径,那么登录成功后,系统最好直接转到该路径。
LoginFilter会将该路径采集下来,以“gotoPage”属性保存到session。登陆成功后,会移除掉该属性(不占用session资源)。
此时,LoginFilter的form action是这么编写的:
-
<
%
-
String gotoPage = (String) session.getAttribute("gotoPage");
-
if (StringUtil.isEmpty(gotoPage)) {
-
gotoPage = "main.jsp";
-
}
-
%>
-
<
form
name
=
""
action
=
"<%=gotoPage%>"
method
=
"post"
>
<%
String gotoPage = (String) session.getAttribute("gotoPage");
if (StringUtil.isEmpty(gotoPage)) {
gotoPage = "main.jsp";
}
%>
<form name="" action="<%=gotoPage%>" method="post">
至此,我相信一切你都明白了。
------------------------分隔线----------------------------
毕竟我们搞ralasafe很多年了(04年开始的),所以很难更好地站在使用者角度(虽然,我们在努力,一直在努力),内容肯定有欠缺和错误。欢迎大家提出宝贵建议,欢迎大家努力拍砖!
我们也将继续保持开源,为大家贡献好的软件。也恳请大家支持我们!
注:下期讲解 2, URL权限控制:哪些页面访问需要进行角色权限验证,怎样验证最简单有效,如何处理验证失败情况;
ralasafe团队博客在javaeye/baidu/sina等空间,同步发布。ralasafe官方网站:
http://www.ralasafe.org/zh