NC6单点登录设计文档

目录

前言

特别说明：

1、方案详述

2、注册登录信息

2.1、登录NC系统

2.2、根据功能节点打开NC界面

2.3、自定义uiLoader打开NC任意界面 

2.3.1、 编写java类

2.3.2、部署

2.3.3、访问测试

3、单点登录配置文件详述

3.1、注册信息的超时设置

3.2、注册时的验证处理

3.3、AbstractSSOAuthenticator

前言

  因为业务场景需要，第三方系统有些工作需要经常到NC系统里做，如果每次去NC系统做业务单据，都需要反复登录，导致客户使用体验不是很好，所以需要开发实现从第三方系统单点登录到NC系统，提高客户满意度。

单点登录名词解释

单点登录（Single Sign On），简称为 SSO，是比较流行的企业业务整合的解决方案之一。SSO的定义是在多个应用系统中，用户只需要登录一次就可以访问所有相互信任的应用系统。

特别说明：

  本方案是基于用友集提供的【NC63单点登录方案说明文档】进行二次修改，本篇文章不仅是为了记录个人开发需要，也同样为了广大开发者们。

1、方案详述

  想要单点登录到NC，首先需要在服务器端向NC服务器注册将要登录的用户的信息以及其他一些需要的信息，这些信息将被保存在NC服务器上，通过ssoKey进行关联映射。在完成注册信息后，客户端在登录时需要提供ssoKey，通过该值获得登录用户的相关信息，进入NC系统。

2、注册登录信息

NC系统提供了一个Servlet来注册用户登录信息。访问该servlet的URL格式基本为：

http://host:port/service/ssoRegServlet，其后面可以跟随多个参数。

===参数信息===

【userCode】：

    指定用户编码，该参数必须提供，不能省略。

【ssoKey】：

    指定映射登录信息的键值，并在登录时需要提供该值。该值要求唯一，如果在注册时没有提供该值，NC系统会自动生成一个ssoKey的值，并在返回的Servlet流中输出该值。

【busiCenter】：

    指定用户所属的账套编码，该值可以忽略。如果忽略该值，并且在多个账套中都存在userCode用户，那么会让终端用户选择账套。

【groupCode】：

    指定登录的集团编码，该值可以忽略。

【langCode】：

    指定登录的语种，该值可以忽略，默认为中文。

示例：

http://host:port/ service/ssoRegServlet?ssoKey=16354820401&userCode=zhangsan 
这个URL表示将以用户zhangsan的身份登录，注册信息的键值为16354820401。

2.1、登录NC系统

  在完成了用户登录信息的注册后，客户端就可以以注册的ssoKey值来登录NC系统了，登录NC系统的ssoKey值以URL参数的形式提供。http://host:port/login.jsp?ssoKey=keyvalue。

对于前面的示例

http://host:port/ service/ssoRegServlet?ssoKey=16354820401&userCode=zhangsan