泛微Ecology9.0与NC单点登录配置手册v 1.0

版本历史

1
NC单点登录实现机制及过程

1．当客户端用户希望进入NC系统时，首先向外部的认证系统提交请求。
2．
由外部认证系统向nc服务器注册客户端的登录信息，这些信息是nc系统所必需的信息。可以通过 一个随机的键值key来索引登录信息。
3．
客户端将通过该键值来进入nc系统。即客户端将向nc应用服务器提交其键值。nc服务器将利用该键值从注册中心中获取登录信息（同时注销注册信息）。然后利用这些登录信息登录到NC系统。
4．超时处理：注册的登录信息有其生命期，超过生命期的注册信息将会被清除。客户端只能在超时以前登录nc才有效，否则不能进入nc系统。超时的值在配置文件中进行配置。

5．本手册使用于Ecology8.100.0531版本及以上版本；NC版本6.0及以上版本。

实现步骤详解

（1
进入后台集成中心页面，点击集成登录，进入集成登录（适用NC6.0以上）

（2
进入集成登录界面，点击新建，进入集成登录新建页面

新建界面

展示界面

（3
参数说明

Ø标识：元素指定对应集成登录时需要的id（后续会提到），此处可任意填写，建议数值或者英文

Ø名称：可以设置多个单点登录方案，该处填写这个单点登录方案的名字

Ø内外网地址：填写客户NC内外网访问地址，注意需要带http：//

Ø账号参数名及密码参数名无需改动；

Ø帐套：NC系统有帐套的概念，一个用户可能有多个帐套，此处需要将用户需要单点进的帐套在此处设置（为帐套ID），每一个账号需要设置单独的方案；

Ø帐套如何获取:如现场没有NC工程师协助，帐套ID获取方式为：用户NC系统管理员ROOT账号登陆后，NC系统动态建模平台中财务核算帐簿，点击进入界面可以查看帐套id；如下图。

（4
其他参数根据客户NC实际情况可配置公司名称、系统标示等相关字段。

（5
前端菜单设置

Ø账号设置菜单；地址：/interface/AccountSetting.jsp

Ø单点登录菜单；地址：/interface/Nc6Entrance.jsp?id=NCCS

（6
前端用户使用

Ø账户设置界面：

Ø单点登录界面：

2
常见问题处理方案

（1
按照步骤设置成功，用户点击登录后出现以下错误：

如有现场没有NC工程师联调，请用户NC系统管理员修改NC程序包内该文件：

配置文件ierp\sf\ssoConfig.xml：

该文件用于配置在单点登录中能够注册登录信息的主机ip和注册信息的超时值。这些配置都是出于对安全的考虑，因为只有在该文件中配置的主机才能向nc服务器注册登录信息。

ssoConfig.xml的内容为

<?xml version="1.0" encoding="UTF-8"?>

<SSOConfig>

<regTimeOut>200</regTimeOut>           ---用于指定注册信息的生命期，单位为秒

<authenticator classname="nc.sso.bs.DefaultSSOAuthenticator">

<listParam key="IPAddress">

         <string>221.226.25.34</string>          ---用于指定可以注册的外部主机ip

<string>127.0.0.1</string>

</listParam>

</authenticator>

</SSOConfig>

切忌提醒系统管理员更改前备份该文件，同时更改后备案发送给NC实施商以便NC方备案