编辑“爱飞多用户博客系统/整合说明”

{{爱飞多用户博客系统导航}}
==运行环境要求==
在启用系统整合接口之前，必须保证满足以下操作环境： 
*I-Favourite 1.5及以上版本；
*和非[[asp]]程序整合，WEB[[服务器]]必须安装并启用[[MSXML]]3或更高版本的[[XML]]解析器以支持XML数据解析及服务器安全[[HTTP]]访问,[[asp.net]]不存在此问题。 
　
==配置其它程序系统==
首先，修改web.config中的ssokey, 在整合提供，为防止外部调用，务必记住修改，整合秘匙为长度不限的字母和数字组合。 密匙在web.config中的的节点。 <add key="SSOKey" value="mykey" /> value中的值是需要修改的部分。 

*'''在asp.net系统中整合'''
在的项目中添加web引用
[[Image:I-fav_Connection1.png|center]]
 
输入[[博客]]路径/sso.asmx,如下图
[[Image:I-fav_Connection2.png|center]]
 
修改web引用名，单击添加引用。

==整合接口方法==
'''注:'''带*的为必填项 

 public int AccountExists(string account, string key); 
*'''方法说明：'''检查帐号(请不要和登录名混淆)是否存在  
*'''参数说明：'''
#account为用户帐号(注意不要和登录名混淆)，
#key为秘匙。
*'''返回值说明：'''
#-1 密匙错误 
#-2 帐号不存在 
#1 帐号已存在 

 public int CreateUser(string username, string account, string password, string emailAddress, 
                      string nickName, int gender, string address, string city, string telPhone,
                      string birthday, string idNumber, string question, 
                      string answer, string ipAddress, string key); 

*'''方法说明：'''创建用户 
*'''参数说明：'''
#username 用户登录名 * 
#account 用户帐号 * 
#password 密码(传递密码原文) * 
#emailAddress [[Email]]地址 * 
#nickName 用户昵称 
#gender 用户性别 (0:不详,1:男 ,2:女) * 
#address 用户住址 
#city 用户所在城市 
#telphone 电话号码 
#birthday 生日 
#idNumber 身份证号 
#question 安全问题 
#answer 安全问题答案 
#ipAddress 注册时的[[IP]]地址 
#key 整合秘匙
*'''返回值说明： '''
#-1 密匙错误 
#-2 不能创建用户，登录名已存在 
#-3 该帐号被禁止注册。 
#-4 帐号(account)不正确，帐号为数字和字母的组合，不能包含中文 
#-5 帐号已存在。 
#1 创建用户成功。 

 public int DeleteUser(string account,string key); 
*'''方法说明：''' 删除用户 
*'''参数说明：'''
#account为用户帐号(注意不要和登录名混淆)
#key为秘匙。
*'''返回值说明：'''
#-1 密匙错误 
#1 删除成功 

 public int ModifyPassword(string username,string password,string newPassword,string key);
*'''方法说明：''' 修改密码 
*'''参数说明： '''
#username 用户登录名 *
#account 用户帐号 * 
#password 密码(传递密码原文) *
#newPassword 新密码(传递密码原文) * 
#key 整合秘匙
*'''返回值说明： '''
#-1 密匙错误 
#-2 用户不存在 
#-3 原密码不正确 
#1 密码修改成功 

    public int UpdateUser(string username, string account,string password, string emailAddress, 
          string nickName, int gender, string address, string city, string telPhone, string birthday, 
           string idNumber, string question, string answer, string ipAddress, string key);

*'''方法说明：''' 更新用户
*'''参数说明： '''
#username 用户登录名 * 
#account 用户帐号 * 
#password 密码(传递密码原文) * 
#emailAddress Email地址 * 
#nickName 用户昵称 
#gender 用户性别 (0:不详,1:男 ,2:女) * 
#address 用户住址 
#city 用户所在城市 
#telphone 电话号码 
#birthday 生日 
#idNumber 身份证号 
#question 安全问题 
#answer 安全问题答案 
#ipAddress 注册时的IP地址 
#key 整合秘匙
*'''返回值说明： '''
#-1 密匙错误 
#-2 帐号或者Email或者昵称为空
#-3 用户不存在。 
#1 创建用户成功。 

 public int UserExists(string username,string key);
*'''方法说明：''' 检查登录名是否存在 
*'''参数说明： '''
#username为登录名(注意不要和帐号混淆)
#key为秘匙。 
*'''返回值说明：''' 
#-1 密匙错误 
#-2 帐号不存在 
#1 帐号已存在

==关于同步登录==
因web service是服务器端到服务器端调用，而登录需要同入[[cookies]]到客户端机器，因此I-Favourite同步登录使用URL传参模式来完成。 

'''同步登录调用路径：''' 博客程序路径/Spaces_Check.aspx

'''同步登录参数： '''
#Version 同步登录文件版本号 目前为1.0
#Username 用户登录名
#ChkCode 效验码 MD5(username+KEY); 用户名+整合密匙后md5的结果 在asp.net中效验码的md5 
<pre>
public static string ToMD5_16(string str)
      {
                  string s = FormsAuthentication.HashPasswordForStoringInConfigFile(str, "MD5");
                  return s.Substring(8, 16);
            }
</pre>

#backUrl 登录成功后返回的URL地址 

例如：博客程序URL地址/spaces_check.aspx?version=1.0&username=xiaoxiao&ChkCode=验证串&backUrl=<nowiki>http://bfor.cn/admin</nowiki> 

相关参数若包含中文，特殊符号，请使用URL进行编码。 

==参考来源==
*http://www.i-fav.com/doc/SDK.aspx?t=sdk&c=2&s=1

[[category:爱飞多用户博客系统|Z]]

{{爱飞多用户博客系统使用手册}}