discuz之同步登入

前言

 

首先感谢dozer学长吧UCenter翻译成C#

博客地址----------->http://www.dozer.cc/

 

其次感谢群友快乐々止境同学的热心指导,虽然萍水相逢但让我感受到了世界的温暖

 

Discuz搭建

同步登入

Discuz是康盛公司下的一套通用的社区论坛软件系统

康盛公司还有其他产品,为了让多个网站一个账号登入就能畅通无阻,于是有了UCenter

本篇介绍Asp.Net网站与Discuz实现同步登入

建议去看看dozer自己写教程http://www.dozer.cc/2011/01/ucenter-api-in-depth-1st.html
我这里大部分是搬运他的
首先获得UCenter For .Nethttps://github.com/dozer47528/UCenter-API-For-DotNet

 

 

什么是UCenter呢,其实我也不太懂
简单的说,它也是个网站,可以管N个网站的用户

官方介绍

 

我简单说下同步登入流程

 

 

 

类库概况

类库分为以下几个部分

1. Api 用于提供给 UCenter 调用的结构
2. Client 用于调用 UCenter 的接口,网站程序调用的
3. Model 调用过程中的一些数据封装
4. UcConfig 静态类，读取上面的配置文件(App.config或Web.config)信息
5. UcUtility 一些常用函数
6. App.config 配置文件示例

 

如果Discuz安装成功,你能在UCenter的的应用管理看到你的Discuz

 

现在添加一个网站,并让UCenter管理这个网站

 

 

新建一个空的Asp.Net Web应用程序,记得引用类库

 

 

 

 

右键网站项目-->属性--->Web发现我找到项目URL,记住这个URL等会用

 

 

 

 

 

到这里当然不能进行同步登入

现在你的新网站和UCenter还是老死不相往来状态

 

网站与UCenter关联

 

 

 

 

提交完后会在最下面生成配置信息

define('UC_CONNECT', 'mysql');

define('UC_DBHOST', 'localhost');

define('UC_DBUSER', 'root');

define('UC_DBPW', '123456');

define('UC_DBNAME', 'ultrax');

define('UC_DBCHARSET', 'gbk');

define('UC_DBTABLEPRE', '`ultrax`.pre_ucenter_');

define('UC_DBCONNECT', '0');

define('UC_KEY', 'FD144298AF7E4797A66ACC0C18C97EA3');

define('UC_API', 'http://localhost:8080/uc_server');

define('UC_CHARSET', 'gbk');

define('UC_IP', '');

define('UC_APPID', '2');

define('UC_PPP', '20');

 

返回应用中心你会发现你刚刚添加的通信失败,这很正常,因为你的网站还没配置

 

 

这些PHP配置信息要填到Web.config中,下面给你个模板填

一一对应填入,可能上面有的下面没有,没事.上面红色标注的是,上面与下面都有的项

 <configuration>
   <system.web>
     <compilation debug="true" targetFramework="4.0"/>
     <pages controlRenderingCompatibilityVersion="3.5" clientIDMode="AutoID"/>
   </system.web>
   <appSettings>
     <!--客户端版本-->
     <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="FD144298AF7E4797A66ACC0C18C97EA3"/>
     <!--[必填]UCenter地址-->
     <add key="UC_API" value="http://localhost:8080/uc_server"/>
     <!--[必填]默认编码-->
     <add key="UC_CHARSET" value="gbk"/>
     <!--[非必填]UCenter IP-->
     <add key="UC_IP" value=""/>
     <!--[必填]应用ID-->
     <add key="UC_APPID" value="2"/>
   </appSettings>
 </configuration>

 

这样以后,我的网站就能更UCenter交流

但是具体怎么交流?

这里我就创建一个ashx做示范

 

Talk is cheap.Show you the code

 public void ProcessRequest(HttpContext context)
 {
     context.Response.ContentType = "text/html";
     IUcClient client = new UcClient();
     ");//登陆
     var js=client.UserSynlogin(user.Uid);//返回一个js代码,这是同步登入的关键
     if (user.Result==LoginResult.Success)
     {
         context.Response.Write(js);
         context.Response.Write(user.UserName);
     }
 }

这是一段通知UCenter,us1用户登入,同时通知被UCenter管理的其他应用登入的代码

上面可以认为是我的网站去找UCenter,但是UCenter怎么找我,所谓通信必须是你来我往

添加一个API文件夹,在下面添加一个uc.ashx(是不是很眼熟,没错刚刚在UCenter应用管理中心就是设置了这个)

让uc继承UcApiBase,实现其抽象方法

删除 uc.ashx的ProcessRequest 方法 因为UcApiBase里面有了

好启动你的网站

• 确保你的iis启动着
• wampserver正常运行,要绿绿的(MySQL启动着,本来是一篇文章被我拆成两篇,所以这里有点突兀)
• 确保你的Discuz能访问
• 确保UCenter中的配置与Web.Config正确
• 确保你的新网站在服务器运行

启动后你会发现UCenter应用中心,原本的通信失败变成成功

 

 

访问TestHandler.ashx

如果成功页面会显示这个用户的用户名

 

跳转到Discuz,你会发现你的用户已登入

 

 

接下来解释下这过程

这个图能解释TestHandler.ashx的ProcessRequest

返回的js将再浏览器中执行

它会请求discuz网站下的UCenterApi,它会告诉Discuz是谁登入了

这段js也解释了为什么uc.ashx必须放在一个api文件夹下

 

这样同步登入就大致说完了

 

下面说说

discuz同步登入你的网站

 

到你的discuz网站下的uc_client\data\cache

找到apps.php

 

 <?php
 $_CACHE['apps'] = array (
   1 =>
   array (
     'appid' => '1',
     'type' => 'DISCUZX',
     'name' => 'Discuz! Board',
     'url' => 'http://localhost:8080',
     'ip' => '',
     'viewprourl' => '',
     'apifilename' => 'uc.php',
     'charset' => '',
     'dbcharset' => '',
     'synlogin' => '1',
     'recvnote' => '1',
     'extra' => false,
     'tagtemplates' => '',
     'allowips' => '',
   ),
  );
  ?>

 

造它的样子抄一份,注意适当得修改

 

 <?php
 $_CACHE['apps'] = array (
    =>
   array (
     ',
     'type' => 'DISCUZX',
     'name' => 'Discuz! Board',
     'url' => 'http://localhost:8080',
     'ip' => '',
     'viewprourl' => '',
     'apifilename' => 'uc.php',
     'charset' => '',
     'dbcharset' => '',
     ',
     ',
     'extra' => false,
     'tagtemplates' => '',
     'allowips' => '',
   ),
    =>
   array (
     ',
     'type' => 'OTHER',
     'name' => 'MyWebSite',
     'url' => 'http://localhost:7067',
     'ip' => '',
     'viewprourl' => '',
     'apifilename' => 'uc.ashx',
     'charset' => '',
     'dbcharset' => '',
     ',
     ',
     'extra' => false,
     'tagtemplates' => '',
     'allowips' => '',
   ),
   );
 ?>

 

问我为什么要做这个,其实我也不知道,反正如果不这样改的话,你在discuz登入时候,不会像上面一样返回一段js给你,更别说同步登入

 

这样就能同步登入了

当在discuz登入的时候,将触发你的网站的uc.asxh的public override ApiReturn SynLogin(int uid)方法

你可以在这里写你的操作

比如