单点登录CAS使用记（三）：实现自定义验证用户登录

问题：

CAS自带的用户验证逻辑太过简单，如何像正常网站一样，通过验证DB中的用户数据，来验证用户以及密码的合法性呢？

方案1：CAS默认的JDBC扩展方案：

CAS自带了两种简单的通过JDBC方式验证用户的处理器。

1.QueryDatabaseAuthenticationHandler

2.SearchModeSearchDatabaseAuthenticationHandler

这两个处理类位于cas-server-support-jdbc这个扩展工程下。

第一步：改写用户验证处理器

打开deployerConfigContext.xml

找到这个处理器

<bean class="org.jasig.cas.authentication.handler.support.SimpleTestUsernamePasswordAuthenticationHandler" />

把他替换成为 下面两种其中任意一个bean皆可。

<bean id="SearchModeSearchDatabaseAuthenticationHandler"
      class="org.jasig.cas.adaptors.jdbc.SearchModeSearchDatabaseAuthenticationHandler"
      abstract="false" singleton="true" lazy-init="default" autowire="default" dependency-check="default">
  <property  name="tableUsers">
   <value>users</value>
  </property>
  <property name="fieldUser">
   <value>user_id</value>
  </property>
  <property name="fieldPassword">
   <value>password</value>
  </property>
  <property name="dataSource" ref="dataSource" />
</bean>

或者

 <bean class="org.jasig.cas.adaptors.jdbc.QueryDatabaseAuthenticationHandler">
  <property name="dataSource" ref="dataSource" />
  <property name="sql" value="select password from some_table where lower(username) = lower(?)" />
</bean>

把对应的用户表名、用户名、密码替换成为 你实际数据库中的 用户表名、用户名、密码对应的字段名称。

第二步：加载驱动（oracle、mysql任选一种），连接数据库

依然在这个文件中deployerConfigContext.xml,在最后一个</bean>标签之前，加上下面配置即可（oracle、mysql任选其一）。

<!-- Oracle connector -->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
 <property name="driverClassName">
  <value>oracle.jdbc.driver.OracleDriver</value>
 </property>
 <property name="url">
  <value>jdbc:oracle:thin:@database-server-name:1521:SID</value>
 </property>
 <property name="username">
  <value>admusr</value>
 </property>
 <property name="password">
  <value>admpwd</value>
 </property>
</bean>
 
<!-- MySQL connector -->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
 <property name="driverClassName">
  <value>com.mysql.jdbc.Driver</value>
 </property>
 <property name="url">
  <value>jdbc:mysql://database-server-name:3306/db-name</value>
 </property>
 <property name="username">
  <value>admusr</value>
 </property>
 <property name="password">
  <value>admpwd</value>
 </property>
</bean>

第三步：导入必要的jar包

cas-server-webapp的pom.xml

<!-- 必须导入start -->
<dependency>
    <groupId>org.jasig.cas</groupId>
    <artifactId>cas-server-support-jdbc</artifactId>
    <version>${project.version}</version>
</dependency>
<dependency>
    <groupId>commons-dbcp</groupId>
    <artifactId>commons-dbcp</artifactId>
    <version>1.2.1</version>
    <scope>runtime</scope>
</dependency>
<!-- 必须导入end -->

<!-- oracle 、 mysql 任选其一 start-->
<dependency>
    <groupId>oracle</groupId>
    <artifactId>ojdbc14</artifactId>
    <version>10.2.0.4</version>
    <scope>provided</scope>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.5</version>
    <scope>provided</scope>
</dependency>
<!-- oracle 、 mysql 任选其一 end-->

重新启动项目，在登录页验证即可。

---------------------分割----------------------

方案2：套用原有项目的用户登录逻辑（非JDBC方式）

背景：

1.因为是要整合多个项目的登录功能，换句话说，就是原有的项目其实分别都有已经实现的用户登录逻辑页面、登录逻辑，并且是经过了大量测试，程序逻辑比较健壮。

2.原有的项目并不是通过JDBC方式来访问数据库的，为了保持代码风格统一，最好与其他项目保持一致，或者直接套用原有的验证逻辑。（比如：我们项目使用的是Mybatis方式）

3.CAS扩展的JDBC验证方式还是过于简单，对于复杂的验证逻辑不便于扩展。

第一步：自定义一个用户验证处理器

可以在原有的cas-server-support-jdbc工程下，也可以自己新建一个工程

注意：本类要继承这个类AbstractUsernamePasswordAuthenticationHandler

public final class MyUserAuthenticationHandler extends
        AbstractUsernamePasswordAuthenticationHandler
{
    /**
     * 这个API是原有项目验证用户相关处理的API，直接导入相关jar包就可以使用
     */
    @Autowired
    private UserApi userApi;
    
    @Override
    protected final boolean authenticateUsernamePasswordInternal(
            final UsernamePasswordCredentials credentials)
            throws MyAuthenticationException
    {
        String username = getPrincipalNameTransformer().transform(credentials.getUsername());
        String password = credentials.getPassword();
        try
        {
            userApi.login(username, password);
        }
        catch (Exception e)
        {
            throw new MyAuthenticationException(e);
        }
        return true;
    }
}

第二步：自定义异常处理器

因为CAS原有的异常处理逻辑是，只能通过errorcode去messages_zh_CN.properties寻找已经中定义好的异常消息，

如果找不到直接返回errorcode到页面，并不支持直接抛出文字形式的异常消息。

且，还需要为每种异常都定义专属的异常类，例如：

BadCredentialsAuthenticationException.java

BadPasswordAuthenticationException.java

BadUsernameOrPasswordAuthenticationException.java

而本异常类可以直接接受Api抛出的所有异常，或者也可以自定义文字形式的异常消息。如：new Exception("这是异常消息")

同样也支持原有的根据errorCode读取异常消息的方式。

public final class MyAuthenticationException extends
        AuthenticationException
{
    
    /** Serializable ID. */
    private static final long serialVersionUID = 3906648604830611762L;
    
    /**
     * 本构造方法可以返回任何自定义的异常消息到前台
     * <p>例子:TongXiangAuthenticationException(new Exception("自定义的异常消息"))</p>
     */
    public MyAuthenticationException(final Throwable throwable)
    {
        super(throwable.getMessage());
    }
    
    /**
     * 本构造方法只能返回在messages_zh_CN.properties中已经定义好的异常消息
     */
    public MyAuthenticationException(final String code)
    {
        super(code);
    }
    

第三步：修改deployerConfigContext.xml

方案1中，在配置文件中配置了

JDBC方式的处理器bean、连接数据库的BasicDataSource bean 

这里统统不需要。

直接找到这个处理器

<bean class="org.jasig.cas.authentication.handler.support.SimpleTestUsernamePasswordAuthenticationHandler" />

把他替换成为自定义的验证处理器。

<bean class="org.jasig.cas.authentication.handler.support.MyUserAuthenticationHandler" />

因为，访问数据库以及验证用户逻辑的处理都在UserApi中做处理，不需要CAS再做处理了。

第四步：pom.xml加载自定义的工程或者被修改的工程jar包

cas-server-webapp的pom.xml

<dependency>
    <groupId>org.jasig.cas</groupId>
    <artifactId>cas-server-support-jdbc</artifactId>
    <version>${project.version}</version>
</dependency>

或者用户自定义的项目

<dependency>
    <groupId>org.jasig.cas</groupId>
    <artifactId>cas-server-support-myself</artifactId>
    <version>1.0</version>
</dependency>

 启动验证。

---

单点登录CAS使用记系列：

• 单点登录CAS使用记（一）：前期准备以及为CAS-Server配置SSL协议

• 单点登录CAS使用记（二）：部署CAS服务器以及客户端

• 单点登录CAS使用记（三）：实现自定义验证用户登录

• 单点登录CAS使用记（四）：为登录页面加上验证码

• 单点登录CAS使用记（五）：cas-client不拦截静态资源以及无需登录的请求。

• 单点登录CAS使用记（六）：单点登出、单点注销

• 单点登录CAS使用记（七）：关于服务器超时以及客户端超时的分析

• 单点登录CAS使用记（八）：使用maven的overlay实现无侵入的改造CAS