Ecology系统集成接口指南—单点登录篇（V0.1）
SUBMITED BY WEAVER
目 录
1、集成登陆
企业在信息化的过程中不可避免的会购置各种各样的业务系统，为了登陆不同的系统，用户需要频繁的打开不同的窗口、输入各自的帐号密码，费时费力。但是通过ecology系统的自定义菜单功能和集成登陆接口，可以比较方便的实现登陆ecology系统后直接到达其他业务系统的功能，省去了繁琐的登陆过程。
1.1使用说明
- 系统管理员维护待集成系统的登陆页面地址，如图所示：
（图一，继承登陆菜单入口）
（图二，点“集成登陆”菜单后的显示页面，我们可以通过“新建”来维护需要集成的系统。本文以集成网易163邮箱为例。注意：标识很重要，不能重复，在后面的步骤中会用到标识值）
（图三，新建页面。内网地址为局域网访问，外网地址为internet访问。账号参数名和密码参数名通过查看该系统登录页面的html源码获得，如果登陆页面还有其他输入项的话则添加其他参数）
页面说明
标示：通过自定义菜单搭建其他系统入口时的唯一标志，下文会说明（不可重复）
内网地址，外网地址：其他系统的访问地址，通常情况下保持一致就可以,某些特殊的客户同一个系统可能内网访问和外网访问用的是不同的地址，那么这里要分别设置
帐号参数名：登陆其他系统的的用户名的参数名称，其值可以直接选择直接用ECOLOGY的帐号登陆（如果其他系统的帐号和ECOLOGY帐号一致）或者由客户在使用的时候先输入一次帐号，以后只要在其他系统帐号改变的时候再输入就可以！
密码参数名：登陆其他系统的的口令的参数名称，其值可以直接选择直接用ECOLOGY的密码登陆（如果其他系统的帐号和ECOLOGY密码一致）或者由客户在使用的时候先输入一次密码，以后只要在其他系统密码帐号改变的时候再输入就可以！
其他参数：有些系统登陆的时候可能还需要一些其他的参数，在这里可以自由添加；参数名为实际登陆到其他系统的时候所需要的参数的名称，标签是客户在设置参数值时的一个说明，参数值可以从部门（ECOLOGY 中的部门ID），分部（ECOLOGY系统中的分部ID），固定值（如果选择固定值，必须在后面输入一个值），用户录入（客户在使用的时候先输入一次）中选择
（图四，给待集成的系统添加左侧菜单）
（图五）
（图六，链接地址必须设为/interface/Entrance.jsp?id=待集成系统的标识值）
（图七，这个菜单用来给系统用户维护集成系统的帐号信息。链接地址必须是
/interface/AccountSetting.jsp)
- 到目前为止，系统设置已经完成，系统用户可以使用被集成的系统了。在使用被集成的系统之前需要先设置一下自己在被集成系统中的账号信息和其他参数信息（通过前文所述的“账号设置”左侧菜单进行设置，设置一次就可以了，只有在被集成系统的帐号改变了的情况下才需要再次设置;如果在登陆设置的地方选择的ECOLOGY的帐号，密码，部分，或者分部或者是固定值，那么这里是不需要设置的）
（图一）
（图二）
帐号：在这里设置登陆其他系统的帐号，如果在“登陆设置”处“帐号参数名”后选择的“使用ECOLOGY帐号”那么这里将不要设置也不会出现
密码：在这里设置登陆其他系统的密码，如果在“登陆设置”处“密码参数名”后选择的“使用ECOLOGY密码”那么这里将不要设置也不会出现
参数4：这里显示是“登陆设置”处添加的参数的标签，并且只显示“参数值”选择了“手工录入”的参数项
访问类型：分别对应“登陆设置”设置的“内网地址”和“外网地址”
（图三，设置好账号信息后点“网易163邮箱”左侧菜单，直接登录进入163邮箱系统）
- 接口开发
通过上面所述,基本上已经能满足绝大数客户的单点登陆需求,如果客户的其他系统有比较特殊的控制,上面的设置不能达到直接进入被集成系统的目的，可以通过修改接口文件来自己写集成登陆的代码。
if(sysid.equals(“1”)){//如果系统标识值等于1
//163邮件系统集成
out.print(str);
}else if(sysid.equals(“2”)){//如果系统标识值等于2
//第二套待集成系统
out.print(str);
}
。。。。
else{
out.print(str);
}
str字符串变量是被集成系统的登录页面html表单提交代码，客户开发人员可以自己修改str的值来实现自己的登陆代码。大多数情况下可以不用自己开发，但是对基于.net技术的网站系统可能需要自己实现登陆部分的代码。
4. 注意事项。
被集成的系统必须是B/S架构的系统，登录页面必须是传统的登录页面（没有验证码、动态密码等）
参数的获取方法：一般登陆参数可知直接询问要集成的产品的开发商；下面介绍下如何自己获得需要的登陆参数名：
首先：在IE中打开要集成系统的登陆页面
然后：点击IE的菜单“查看”—〉“源文件”
最后：在打开的TXT文件中找到单词“<form>”和“</form>”需要的参数一般都包含在这两个单词之间.以ECOLOGY系统为例（注意“type=hidden”的类型，如果该项的value值不为空，一般也是必须的登陆参数，如果为空则可以不要）
<form name=form1 action= “VerifyLogin.jsp” method=post onSubmit=”return checkall();”>
<INPUT type=hidden name=”loginfile” value= “/login/Login.jsp?logintype=1&gopage=” >
<INPUT type=hidden name=”logintype” value=”1″>
<INPUT type=hidden name=”rnd” >
<input type=hidden name=”gopage” value=””>
<INPUT type=hidden name=”serial”>
<input name=”loginid” type=”text” size=”15″ value=”” style=”margin:0px 0 0 560px;height:22px;width:115px”><br/>
<input name=”userpassword” type=”password” size=”15″ style=”margin:6px 0 0 560px;height:22px;width:115px”><br/>
</form>
转载请注明：赫非域 » Ecology系统集成接口指南—单点登录篇