单点登录集成说明

落日映苍穹つ 2022-04-17 02:14 265阅读 0赞

# **第一步：下载资源包** #

如果项目是maven项目可在pom文件引入以下代码：

<table style="width:414.8pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#7f7f7f;width:414.8pt;"> &lt;!--集成cas需要的jar--&gt; &lt;dependency&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;groupId&gt;org.jasig.cas.client&lt;/groupId&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;artifactId&gt;cas-client-core&lt;/artifactId&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;version&gt;3.3.3&lt;/version&gt; &lt;/dependency&gt; &lt;!--集成cas &nbsp;END &nbsp;&nbsp;&nbsp;--&gt; </td> 
 </tr> 
 </tbody> 
</table>

如果没有使用mave，将lib目录提供的jar拷贝到应用的\\WEB-INF\\lib目录下。

cas-client-core-3.3.3.jar

# **第二步：修改应用配置文件** #

修改应用的web.xml文件，添加与SSO Server通信的filter和listener，具体配置信息如下：

<table style="width:414.8pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#7f7f7f;width:414.8pt;"> &lt;!--用于实现单点登出功能 --&gt; &lt;filter&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-name&gt;CAS Single Sign Out Filter&lt;/filter-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-class&gt;org.jasig.cas.client.session.SingleSignOutFilter&lt;/filter-class&gt; &lt;/filter&gt; &lt;!-- 负责用户的认证工作--&gt; &lt;filter&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-name&gt;CAS Authentication Filter&lt;/filter-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-class&gt;org.jasig.cas.client.authentication.AuthenticationFilter&lt;/filter-class&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;init-param&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;param-name&gt;casServerLoginUrl&lt;/param-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;param-value&gt;http://47.92.125.222:8080/cas/login&lt;/param-value&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;/init-param&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;init-param&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;param-name&gt;serverName&lt;/param-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;param-value&gt;http://47.92.125.222:8084&lt;/param-value&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;/init-param&gt; &lt;/filter&gt; &nbsp; &lt;!-- 该过滤器负责对Ticket的校验工作--&gt; &lt;filter&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-name&gt;CAS Validation Filter&lt;/filter-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-class&gt;org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter &lt;/filter-class&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;init-param&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;param-name&gt;casServerUrlPrefix&lt;/param-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;param-value&gt;http://47.92.125.222:8080/cas&lt;/param-value&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;/init-param&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;init-param&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;param-name&gt;serverName&lt;/param-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;param-value&gt;http://47.92.125.222:8084&lt;/param-value&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;/init-param&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;init-param&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;param-name&gt;redirectAfterValidation&lt;/param-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;param-value&gt;true&lt;/param-value&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;/init-param&gt; &lt;/filter&gt; &lt;!-- 该过滤器使得开发者可以通过org.jasig.cas.client.util.AssertionHolder来获取用户的登录名。 比如AssertionHolder.getAssertion().getPrincipal().getName()。 --&gt; &lt;filter&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-name&gt;CAS Assertion Thread Local Filter&lt;/filter-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-class&gt;org.jasig.cas.client.util.AssertionThreadLocalFilter&lt;/filter-class&gt; &lt;/filter&gt; &nbsp; &lt;!—需要根据实际情况，将/* &nbsp;改为具体的URL--&gt; &lt;filter-mapping&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-name&gt;CAS Single Sign Out Filter&lt;/filter-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;url-pattern&gt;/*&lt;/url-pattern&gt; &lt;/filter-mapping&gt; &lt;filter-mapping&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-name&gt;CAS Authentication Filter&lt;/filter-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;url-pattern&gt;/*&lt;/url-pattern&gt; &lt;/filter-mapping&gt; &lt;filter-mapping&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-name&gt;CAS Validation Filter&lt;/filter-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;url-pattern&gt;/*&lt;/url-pattern&gt; &lt;/filter-mapping&gt; &lt;filter-mapping&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;filter-name&gt;CAS Assertion Thread Local Filter&lt;/filter-name&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;url-pattern&gt;/*&lt;/url-pattern&gt; &lt;/filter-mapping&gt; &nbsp; &nbsp; &lt;listener&gt; &nbsp;&nbsp;&nbsp;&nbsp;&lt;listener-class&gt;org.jasig.cas.client.session.SingleSignOutHttpSessionListener&lt;/listener-class&gt; &lt;/listener&gt; </td> 
 </tr> 
 </tbody> 
</table>

# **第三步：定制获取当前用户信息** #

单点登录集成，需要应用系统调用统一用户管理系统（SSO Server）提供的API来获取。

应用系统根据需要定制调整,可以封装成一个单独的类，可以直接拷贝下面的代码片段在需要获取当前用户的地方直接使用。

<table style="width:414.8pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#7f7f7f;width:414.8pt;"> /*&nbsp;引入接口类 */ import org.jasig.cas.client.util.AssertionHolder; import java.util.*; &nbsp; …… &nbsp; Map&lt;String,Object&gt; attrMap&nbsp;=&nbsp;null; Assertion assertion= null; try{ assertion = AssertionHolder.getAssertion(); attrMap&nbsp;= assertion.getPrincipal().getAttributes(); }catch (Exception e){ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;logger.error("获取登录用户对象失败！！！"); } &nbsp; if(null == attrMap&nbsp;|| 0 == attrMap.size()){ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//需要跳转到登录页面重新登录 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;…… &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; }else{ &nbsp;&nbsp;&nbsp;//需要应用系统编写代码，从attrMap获取业务需要的当前登录用户信息。 &nbsp;&nbsp;&nbsp;…… &nbsp;&nbsp;&nbsp;String&nbsp;account=(String)attrMap.get(“ACCOUNT”); &nbsp; &nbsp;&nbsp;&nbsp;…… &nbsp; } &nbsp; …… &nbsp; </td> 
 </tr> 
 </tbody> 
</table>

attrMap包含的登录用户信息，分为企业用户和内部用户两种，两种不同用户的数据项也有所不同，具体如下：

1、企业用户属性

2、内部用户属性

<table style="width:414.8pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#7f7f7f;width:414.8pt;"> ACCOUNT &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//账号 TYPE &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//账号类型 &nbsp;&nbsp;TYPE=1 TELEPHONE &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//手机号 NAME &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//姓名 CARD_ID &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//身份证号 ORG_CODE &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//所在机构编码 ORG_NAME &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//所在机构名称 ORG_STATE &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//所在机构状态 &nbsp;&nbsp;&nbsp;&nbsp;0：正常 &nbsp;&nbsp;&nbsp;1：待注销 PARENT_ORGCODE &nbsp;//上级检验机构编码 SUR_TYPE &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//是否验船师 SEX &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//性别&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1：男 &nbsp;&nbsp;2：女 NATION &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//民族（代码） BIRTH &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//出生年月 POLICTICAL &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//政治面貌（代码） EDUCATION &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//学历（代码） MAJORS &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//专业（代码） WORK_HISTORY &nbsp;&nbsp;&nbsp;&nbsp;//工作履历 EMAIL &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//邮箱 </td> 
 </tr> 
 </tbody> 
</table>

# **第四步：账号信息同步** #

## **4.2、企业用户** ##

1、企业账号同步，采取在企业第一次登录业务系统时，由业务系统同步到业务系统

（1）企业账号登录业务系统后，通过**调用统一用户提供的接口，获取到当前登录账号信息**（见第三步：定制获取当前用户信息）。

（2）获取**ACCOUNT**值，在本地登录登录

在的本地登录时，到本地数据库查找，如果没有该账号，说明账号还没同步，就将获取的该账号的信息插入到业务系统的数据库，同时默认授权（实名认证）。

（3）在业务系统审核完企业账号的实名认证，调用**统一用户提供的接口，将账号状态变为“已审核”**（使CHECK\_STATE=1）。

2、企业第一个注册的账号，通过实名认证后，自动成为企业管理员，可以在统一用户管理中为该企业添加其他账号（企业管理员添加的账号不用再做实名认证，企业管理员可以不再添加新账号）。

新添加的账号，仍采取在企业第一次登录业务系统时，由业务系统**调用统一用户提供的接口，将获取到当前登录账号信息**（见第三步：定制获取当前用户信息）插入到业务系统的库表，同时默认授予跟第一个企业账号一样的权限。

## **4.2、对于内部用户** ##

内部用户同步，通过主数据实现同步，添加一个内部用户，需要在业务系统中授权才能进入业务系统办理业务。

业务系统授权时，触发一下同步操作，将数据同步到应用系统。