************************************************************************

动易网络科技有限公司
Dongyi Network Technology Co.,Ltd

程序名称：动易2005整合程序使用说明
程序版本：2.0
适用版本：动易2005/动网7.x
版权所有：动易网络(asp163.net)
Copyright 2005-2008 asp163.net - All Rights Reserved.

版权声明:
　　本程序及相关文档的版权及其他权利都归佛山市动易网络科技有限公司所有并保留一切权利。除了佛山市动易网络科技有限公司授权许可协议所提供的明确书面许可外，拥有本程序及相关文档并不赋予您任何有关这些专利、版权或其他知识产权的许可。

************************************************************************

程序说明：

一、动易2005整合程序2.0介绍：

　　动易2005整合程序2.0版以全新的思路与构架方式全新写过所有的代码，采用为每个被整合的系统以动易开发专用接口的方式进行通行。通过这种方式，用户无需再考虑通行注册的字段、通行登陆的Cookies等问题，只要在整合程序的相关文件中设定好整合相关的参数即可实现整合。理论上可以和任何一个系统整合，包括ASP、CGI、PHP、JSP不同语言写的系统。本程序随动易2005 SP2提供。
　　2.0版整合程序采用接口方式完成整合，用由站长自行设置的私钥进行数据验证，不通过cookies传递数据，可以防止伪造cookies进行权限提升或者导致的其它安全漏洞。
　　2.0版整合程序支持跨站、跨主机、跨域名整合。

二、2.0版整合相比以前版本的变化：

　　可同时整合的系统不再被限定为一个系统，在整合了一个甚至多个论坛的前提下，还可以整合更多的系统，比如blog等。
　　当要整合的几个系统分别安装在几个不同的域名下，或者安装在不同的服务器上时，仍然可以进行整合。
　　当用户注册时，数据不仅写入动易的数据库，同时还写入整合的全部系统的数据库（需要将被整合系统的注册页面链接或跳转到动易的注册页面），任何时候不整合了，每一套系统都拥有自己的完整用户数据。
　　用户从任意一个系统进行登陆都可以，并且都同时登陆整合的其它系统，不再有先登陆动易才能登陆其它系统的限制。
　　用户在所有整合的系统中修改用户资料时，都会同时修改其它系统中的资料，确保用户资料同步。
　　多个系统之间的信息传递，采用了资料＋认证私钥的联合认证方式，资料在传递过程前使用私钥进行加密，在另一端同样使用私钥进行验证，避免了通过伪造数据进行攻击。
    不写入cookies和session，避免了攻击者通过伪造cookies信息进行攻击的安全漏洞。


　　在进行以下整合操作前，请先安装好动易系统和论坛系统，确保二个系统都能单独正常运行，且均可以单独注册用户。

操作说明：


一、全新整合的操作说明：

　　1.如果您的动易系统是2005SP2以前的版本，请先升级您的动易系统到2005SP2版（组件、ASP文件均需要升级）。
　　2.如果您的动易或者需要整合的程序本身已经有数据，请先执行数据同步操作（请参阅“整合专用用户资料同步程序”），然后继续以下步骤。
　　3.打开动易系统所在文件夹下的inc/UpiConfig.asp文件，修改以下内容：
      Const BBSRefreshTime = 5                         '注册、登录、退出论坛同步跳转时间。
      Const BBSIntegration = False                     '是否整合论坛，如果整合论坛请设为True。
      Const SecurityKey = "testesttesttesttest"        '网站私钥，最好设成10位以上的字符串。
      Const arrUpiUrls = "http://bbs.asp163.net/Interface.asp"      '要整合的程序的完整URL（以“http://”开头，以接口文件的文件名结尾），如果有多个系统要整合，每个URL间用“|”分隔
　　根据您自己网站的实际情况修改这两个常量的值。
　　4.在本论坛整合程序目录中，打开您所要整合的论坛程序版本相对应的文件夹，找到UpiConfig.asp文件（通常在Inc或者include目录下）。修改以下内容：
      Const SecurityKey = "testesttesttesttest"      '验证私钥，应该与网站私钥完全相同。
      Const PE_Url = "http://www.asp163.net/"        '你的动易主站的完整URL，以“http://”开头，以“/”结尾。
　　然后将这所要整合的论坛程序版本相对应的文件夹中的所有文件，复制到您已架设好的论坛系统中，并覆盖这些论坛系统的原版文件。
　　5.如果整合多个系统，需重复进行第4步操作。
　　6.整合后的系统，尽量避免在后台增加用户、删除用户或者修改用户的用户名、密码。如果的确需要进行类似操作，则最好在每套系统的后台都进行一次同样的操作。


二、原来整合的系统升级

　　若您已经在动易系统是2005SP2前整合过论坛系统，请按下面的步骤进行操作：

　　1.如果您的动易系统是2005SP2以前的版本，请先升级您的动易系统到2005SP2版（动易组件、ASP文件均需要升级）。
　　2.用动网论坛7.0或者7.1的官方标准文件替换原来整合时修改过的文件(数据库不用动)。
　　3.经过第1和第2步的操作，您的整个网站现在已经改为未整合的几套独立系统。
　　4.再按照“全新整合的操作说明”中第2--4步进行整合操作。


三、数据同步操作的几点说明

　　本说明中所使用的数据同步程序在“整合专用用户资料同步程序”目录中。

　　1.如果只是动易和一套系统之间进行用户数据同步，则进行以下两步操作即可。
　　(1)运行用户数据同步程序，将要整合系统的用户数据同步到动易数据库。重复项可以选择“覆盖”或“跳过”。
　　(2)再次运行用户数据同步程序，将动易的用户数据同步到目标数据库。重复项应该选择“覆盖”，否则整合后可能会出现部分用户不能通行登录的问题。

　　2.如果是动易与多套系统进行数据同步，则针对每套系统，都必须进行上述两次同步操作。

　　3.通过数据同步操作，您当前的各个系统的用户数据库中的用户数量、每一个用户的用户名、密码等资料都会完全相同。以后用户在任何一套系统中修改自己的密码，则都会同时修改所有已整合的系统数据库中的资料以保持同步。


四、关于动网Cookies路径的说明

    因动网论坛使用的Cookies验证设置了Cookies路径，所以如果整合的论坛系统没有采用单独域名的访问方式，而是以网站的一个目录的形式访问的话，比如：http://www.asp163.net/bbs/index.asp ，那么在动易Inc/UPIConfig.asp文件及频道设置的论坛链接处应该统一使用小写的方式，而不要使用http://www.asp163.net/BBS/index.asp这种大写的访问方式，以确保两个系统可以同时登录。

