在写这篇文章的时候，我还在想，这篇文章也许能给你带来一些收获，但或许会令你更加的迷茫，为什么会这样？
因为：
1、UCenter虽然足够强大，但正为它的强大，它的不少暗箱操作使得我们望而生畏，我们不害怕出错，我们害怕出错时抓不到出错点。
2、同步登录经常会跨平台，跨服务器，跨域，跨数据库等。环境要求比较高，这使得我们需要更多地了解它。
最近公司弄了个团购项目，要求团购的用户和论坛的会员同步起来，以期实现优质会员享受更低折扣等功能。这个项目正是以asp.net开发，当然，在这里要非常感谢同步API的原作者dozer，其原理在其主页文章http://www.dozer.cc/2011/01/ucenter-api-in-depth-1st/
有详细介绍，我这里只简单介绍一下：
UCenter是所有子项目的核心，任何其中某一子应用（包括Discuz论坛）通过向它发送登录，注册，删除，退出等消息，再由UCenter转发到其它的子应用。
，另外我只介绍一下需要重点步骤及需要注意的地方。
第一步，你要得到和UCenter进行通信的类库，作者的主页有原始类库http://www.dozer.cc/2011/05/ucenter-api-for-net-on-codeplex/，是asp.net 4.0版的。我的环境是3.5所以将类库作了一些修改，修改之后的版本在这里/Files/CoreCaiNiao/DS.Web.UCenter.rar。
第二步，你在你的asp.net项目中引用该类库，引用类库的时候，Browse到dll就行，没有必要把整个项目原代码添加到你的解决方案中。
这个类库有两个重点的文件夹需要注意：DS.Web.UCenter.Api与DS.Web.UCenter.Client，
其中DS.Web.UCenter.Api用于响应由UCenter中心发出的通知消息；
然后DS.Web.UCenter.Client用于本地向UCenter发送消息；
第三步，你的asp.net项目需要一个专门向MySql数据库提供操作的类，为了使用本类，还需要安装mysql-connector-net-6.4.3.msi，这个文件可以到官网去下载（上谷歌搜一下），之后，建立用于连接MySql的类。
有人要问和MySql数据库通信的必要性，我得解释一下，UCenter向你的应用发出的通知里，只有UID，要想得到更多的用户信息，唯有和MySql通信。
我这里有一个临时写的，如果你不介意，可以拿去用，代码如下：
usingSystem.Collections.Generic;
usingSystem.Linq;
usingSystem.Text;
usingMySql.Data;
usingMySql.Data.MySqlClient;
usingSystem.Data;
namespaceUCenterDB
{
publicclassMySqlHelper
{
privatestringconnString;
privateMySqlConnectionconn;
publicstringConnString{
set
{
connString=value;
conn=newMySqlConnection(this.connString);
}
}
publicMySqlHelper(stringconnString){
this.connString=connString;
conn=newMySqlConnection(this.connString);
}
publicintExecuteNonQuery(stringquery){
MySqlCommandcmd=createTxtCommand(query);
intresult=-1;
try
{
conn.Open();
result=cmd.ExecuteNonQuery();
conn.Close();
}
catch(Exceptionex)
{
//错误处理过程
}
returnresult;
}
publicstringExecuteScalar(stringquery)
{
MySqlCommandcmd=createTxtCommand(query);
stringresult=string.Empty;
try
{
conn.Open();
result=cmd.ExecuteScalar().ToString();
conn.Close();
}
catch(Exceptionex)
{
//错误处理过程
}
returnresult;
}
publicDataTableGetDataTable(stringquery){
DataSetds=newDataSet();
MySqlDataAdaptermsda=newMySqlDataAdapter();
msda.SelectCommand=createTxtCommand(query);
msda.Fill(ds);
returnds!=null&&ds.Tables.Count>0?ds.Tables[0]:null;
}
privateMySqlCommandcreateTxtCommand(stringquery){
returnnewMySqlCommand
{
Connection=conn,
CommandText=query,
CommandType=CommandType.Text
};
}
}
}
不过我要提醒一下，为了安全，在主服务器开放MySql对外的帐户权限的时候，仅需要开放select权限就可以了。
第四步，你需要一个响应通知的页面了，这里为了尊重原作者，我在WEB根目录下建立了API文件夹，并在里面建立了一个名为uc.ashx的响应文件。这个页面用于响应UCenter的同步通知。
文件内容如下：
usingSystem.Collections;
usingSystem.Data;
usingSystem.Linq;
usingSystem.Web;
usingSystem.Web.Services;
usingSystem.Web.Services.Protocols;
usingSystem.Xml.Linq;
usingDS.Web.UCenter;
usingDS.Web.UCenter.Api;
usingSystem.Collections.Generic;
usingUCenterDB;
namespaceCoreCaiNiao.Web.API
{
///<summary>
///Summarydescriptionfor$codebehindclassname$
///</summary>
[WebService(Namespace="http://tempuri.org/")]
[WebServiceBinding(ConformsTo=WsiProfiles.BasicProfile1_1)]
publicclassuc:UcApiBase
{
SiteMemberManagerusers=TuanGouManager.siteMemberManager;
MySqlHelpermsh=newMySqlHelper(DBConfig.ConnStringMySql);
publicoverrideApiReturnDeleteUser(IEnumerable<int>ids)
{
thrownewNotImplementedException();
}
publicoverrideApiReturnRenameUser(intuid,stringoldUserName,stringnewUserName)
{
thrownewNotImplementedException();
}
publicoverrideUcTagReturnsGetTag(stringtagName)
{
thrownewNotImplementedException();
}
publicoverrideApiReturnSynLogin(intuid)
{
SiteMemberloginMember=users.GetInfoByUid(uid);
DataTabledt=msh.GetDataTable("selectuid,username,password,email,groupidfrompre_common_memberwhereulimit0,1");
if(dt==null||dt.Rows.Count<1)
{
returnApiReturn.Failed;//无法从远端找到，则此用户不存在
}
DataRowdr=dt.Rows[0];
if(loginMember!=null){//从本地库找到，则更新库
loginMember.ULevel=dr[4].ToString().ToNumber();
users.EditInfo();
TuanGouManager.userSessionManager.Login(loginMember,UserLoginExpire.NoSave);
returnApiReturn.Success;
}
//本地库没有，则添加到本地库
loginMember=newSiteMember
{
CreateTime=DateTime.Now,
Address="",
BadAppCount=0,
CumulateMoney="",
EditTime=DateTime.Now,
Email=dr[3].ToString(),
GoodAppCount=0,
Intro="",
IpAddress=HttpContext.Current.Request.UserHostAddress,
IsLock=0,
NickName="",
NormalAppCount=0,
PickedMoney="",
RemainMoney="",
SiteAuthoritys="",
SiteRole="",
TrueName="",
UID=uid,
ULevel=dr[4].ToString().ToNumber(),
UserName=dr[1].ToString(),
UserPass=dr[2].ToString(),
UserQQ="",
UserSex="保密",
UserTel="",
UserType=",1,"
};
intuserId=users.AddNewInfo(loginMember);
loginMember.ID=userId;
TuanGouManager.userSessionManager.Login(loginMember,UserLoginExpire.NoSave);
returnApiReturn.Success;
}
publicoverrideApiReturnSynLogout()
{
TuanGouManager.userSessionManager.Logout();
returnApiReturn.Success;
}
publicoverrideApiReturnUpdatePw(stringuserName,stringpassWord)
{
thrownewNotImplementedException();
}
publicoverrideApiReturnUpdateBadWords(UcBadWordsbadWords){thrownewNotImplementedException();}
publicoverrideApiReturnUpdateHosts(UcHostshosts){thrownewNotImplementedException();}
publicoverrideApiReturnUpdateApps(UcAppsapps){thrownewNotImplementedException();}
publicoverrideApiReturnUpdateClient(UcClientSettingclient){thrownewNotImplementedException();}
publicoverrideApiReturnUpdateCredit(intuid,intcredit,intamount){thrownewNotImplementedException();}
publicoverrideUcCreditSettingReturnsGetCreditSettings(){thrownewNotImplementedException();}
publicoverrideApiReturnGetCredit(intuid,intcredit){thrownewNotImplementedException();}
publicoverrideApiReturnUpdateCreditSettings(UcCreditSettingscreditSettings){thrownewNotImplementedException();}
}
}
我的示例代码中,只对同步登录和退出消息作出响应,具体过程中,您可以根据需要作更多的响应.
第五步，这步是写配置信息，因为原始类库的配置信息都写到它自己的App.config中去了，我们需要复制过来到Web.config
在<appSettings>节中，加入以下行：
<!--DZ1.5用户同步-->
<!--客户端版本-->
<add key="UC_CLIENT_VERSION" value="1.5.2"/>
<!--发行时间-->
<add key="UC_CLIENT_RELEASE" value="20101001"/>
<!--API 开关（value类型：True False 默认值：True）-->
<!--是否允许删除用户-->
<add key="API_DELETEUSER" value="True"/>
<!--是否允许重命名用户-->
<add key="API_RENAMEUSER" value="True"/>
<!--是否允许得到标签-->
<add key="API_GETTAG" value="True"/>
<!--是否允许同步登录-->
<add key="API_SYNLOGIN" value="True"/>
<!--是否允许同步登出-->
<add key="API_SYNLOGOUT" value="True"/>
<!--是否允许更改密码-->
<add key="API_UPDATEPW" value="True"/>
<!--是否允许更新关键字-->
<add key="API_UPDATEBADWORDS" value="True"/>
<!--是否允许更新域名解析缓存-->
<add key="API_UPDATEHOSTS" value="True"/>
<!--是否允许更新应用列表-->
<add key="API_UPDATEAPPS" value="True"/>
<!--是否允许更新客户端缓存-->
<add key="API_UPDATECLIENT" value="True"/>
<!--是否允许更新用户积分-->
<add key="API_UPDATECREDIT" value="True"/>
<!--是否允许向UCenter提供积分设置-->
<add key="API_GETCREDITSETTINGS" value="True"/>
<!--是否允许获取用户的某项积分-->
<add key="API_GETCREDIT" value="True"/>
<!--是否允许更新应用积分设置-->
<add key="API_UPDATECREDITSETTINGS" value="True"/>
<!--API 开关结束-->
<!--返回值设置-->
<!--返回成功（默认：1）-->
<add key="API_RETURN_SUCCEED" value="1"/>
<!--返回失败（默认：-1）-->
<add key="API_RETURN_FAILED" value="-1"/>
<!--返回禁用（默认：-2）-->
<add key="API_RETURN_FORBIDDEN" value="-2"/>
<!--返回值设置结束-->
<!--[必填]通信密钥-->
<add key="UC_KEY" value="FD144298AF7E4797A66ACC0C18CXXEA3"/>
<!--[必填]UCenter地址,这个要根据需要变化,例如,http://你的论坛UCENTER地址-->
<add key="UC_API" value="http://bbs.XXX.XXX.com/ucenter" />
<!--[必填]默认编码-->
<add key="UC_CHARSET" value="utf-8"/>
<!--[非必填]UCenter IP-->
<add key="UC_IP" value=""/>
<!--[必填]应用ID-->
<add key="UC_APPID" value="4"/>
这里有三行要改：
倒数第1行：应用ID:UC_APPID
倒数第4行：UCenter地址:UC_API
倒数第5行：通信密钥:UC_KEY
另外，再加上MySqlProviderFactories节
<!--MySql使用-->
<system.data>
<DbProviderFactories>
<add name="MySQL Data Provider" invariant="MySql.Data.MySqlClient" description=".Net Framework Data Provider for MySQL" type="MySql.Data.MySqlClient.MySqlClientFactory, MySql.Data, Version=6.4.3.0, Culture=neutral, PublicKeyToken=c5687fc88969c44d" />
</DbProviderFactories>
</system.data>
第六步，检查本地服务器和UCenter服务器是否能正常通信(两台服务器互相telnet IP地址 80)
第七步，去UCenter添加此应用，具体怎么填的图片如下：
最后，我祈祷你能通信成功并同步成功。建议先在本地进行DEBUG模式，在uc.ashx文件的SynLogin(int uid)方法及UpdateApps(UcApps apps)处下断点，这样可以查看是否有通知过来，之后再确定问题的根源。
我成功的图片:
最新提醒:
有不少读者反映为什么引用我的UC.ashx后不能直接被编译?这是因为你直接把我的业务逻辑代码也照搬了,实际上
public override ApiReturn SynLogin(int uid)
这个函数是用来做你自己的业务处理的,做完处理后,返回给接口一个成功的信号就行了,形式如同这样:
2{
3SiteMemberloginMember=users.GetInfoByUid(uid);
4DataTabledt=msh.GetDataTable("selectuid,username,password,email,groupidfrompre_common_memberwhereulimit0,1");
5if(dt==null||dt.Rows.Count<1)
6{
7returnApiReturn.Failed;//无法从远端找到，则此用户不存在
8}
9DataRowdr=dt.Rows[0];
10if(loginMember!=null){//从本地库找到，则更新库
11loginMember.ULevel=dr[4].ToString().ToNumber();
12users.EditInfo();
13TuanGouManager.userSessionManager.Login(loginMember,UserLoginExpire.NoSave);
14returnApiReturn.Success;
15}
16
17//本地库没有，则添加到本地库
18loginMember=newSiteMember
19{
20CreateTime=DateTime.Now,
21Address="",
22BadAppCount=0,
23CumulateMoney="",
24EditTime=DateTime.Now,
25Email=dr[3].ToString(),
26GoodAppCount=0,
27Intro="",
28IpAddress=HttpContext.Current.Request.UserHostAddress,
29IsLock=0,
30NickName="",
31NormalAppCount=0,
32PickedMoney="",
33RemainMoney="",
34SiteAuthoritys="",
35SiteRole="",
36TrueName="",
37UID=uid,
38ULevel=dr[4].ToString().ToNumber(),
39UserName=dr[1].ToString(),
40UserPass=dr[2].ToString(),
41UserQQ="",
42UserSex="保密",
43UserTel="",
44UserType=",1,"
45};
46intuserId=users.AddNewInfo(loginMember);
47loginMember.ID=userId;
48TuanGouManager.userSessionManager.Login(loginMember,UserLoginExpire.NoSave);
49returnApiReturn.Success;
50}
其中，灰色的部分千万别抄，只是示意代码，绿色的部分是必须要的，作用是向接口表明你已经成功处理登录业务啦。
应朋友要求,特制作DEMO一份,已测试同步成功!用户需要自行安装UCenter及论坛等.UC_Demo.rar
DEMO说明:
1、子应用登录入口:default.aspx
2、注意web.config中的几处不要填错了，通信密钥，应用ID，UCenter地址(最好用域名或映射域名而不要用IP，有时直接用IP无法连接)，编码（中文用户名时会用到）
3、该DEMO请在调试状态下进行，方便知道问题所在。在UCenter配置此Demo的新应用时，应该带上端口号，例如http://localhost:28457/
您可以转载本文,但请标明出处:http://www.cnblogs.com/CoreCaiNiao/archive/2011/08/25/2153434.html
Asp.net 与 UCenter 用户同步之实施过程
原文地址：http://www.cnblogs.com/webenh/p/8087443.html