Discuz!nt整合心得

最近研究了下Discuz!nt的整合,因为是网上找的实例,有个地方的写错了,导致纠结了一整天,这里分享出来.

Discuz!nt提供了整合工具DiscuzToolkit,用于调用Discuz!nt API的一款工具,网上能够很轻松的找到源码,但是项目中需要引用几个DLL,如图

这里附上代码

  //登录
         protected void btnLogin_Click(object sender, EventArgs e)
         {
             string username = un.Value.Trim();
             string password = pwd.Value.Trim();

             string apikey = "3b8ccea63030e2747abf5740b2f57350";//有Discuz后台管理扩展->通行证设置获得
             string secret = "7d0a34cfa6f7e2175e03aead1c52fe4c";//同上
             string url = "http://bbs.oyytv.com/";//你的bbs路径
             string cookieDomain = "oyytv.com";//你的域名
             DiscuzSession ds = new DiscuzSession(apikey, secret, url);
             int id = ds.GetUserID(username);//根据用户名获取用户ID
             //用户名存在
             if (id > )
             {
                 //取得用户数据库中的密码
                 string dbpassword = ds.GetUserInfo(id).Password;
                 //判断数据库中的密码和输入的密码是否一致
                 if (dbpassword == FormsAuthentication.HashPasswordForStoringInConfigFile(password, "MD5").ToLower())
                 {
                     //输入密码正确，则登录
                     ds.Login(id, dbpassword, true, , cookieDomain);

                     Discuz.Config.GeneralConfigInfo config = Discuz.Config.GeneralConfigs.GetConfig();

                     //删除之前的错误登录信息
                     LoginLogs.DeleteLoginLog(DNTRequest.GetIP());
                     //根据积分公式刷新用户总积分
                     UserCredits.UpdateUserCredits(id);
                     //写入用户登录后的cookie
                     ForumUtils.WriteUserCookie(id, Utils.StrToInt(DNTRequest.GetString("expires"), -), config.Passwordkey, DNTRequest.GetInt("templateid", ), DNTRequest.GetInt("loginmode", -));

                     Response.Redirect("http://bbs.oyytv.com");
                     //更新用户最后动作，如不需要可不执行
                     //OnlineUsers.UpdateAction(olid, UserAction.Login.ActionID, 0, config.Onlinetimeout);
                     //更新该用户最后访问时间
                     // Users.UpdateUserLastvisit(id, DNTRequest.GetIP());
                 }
                 else
                 {

                 }
             }
             else
             {

             }

         }

这里有几个存在误解的地方

整合,因为Discuz!nt是用cookie来保存用户状态,通过设置cookie的Domain来进行子站间的跨域,这里整合说的统一登录,注册...,只是针对于子站间的跨域,就是说将一个论坛,包含在你现有系统上

代码第10行,设置的其实就是Domain值.

第22行 ds.Login(id, dbpassword, true, 10000, cookieDomain);

 /// <summary>
         /// 登录
         /// </summary>
         /// <param name="uid"></param>
         /// <param name="password"></param>
         /// <param name="isMD5Passwd"></param>
         /// <param name="expires"></param>
         /// <param name="cookieDomain"></param>
         public void Login(int uid, string password, bool isMD5Passwd, int expires, string cookieDomain)
         {
             User user = GetUserInfo(uid);
             HttpCookie cookie = new HttpCookie("dnt");
             cookie.Values["userid"] = user.UId.ToString();
             cookie.Values["password"] = EncodePassword(password, isMD5Passwd);
             cookie.Values["avatar"] = HttpUtility.UrlEncode(user.Avatar.ToString());
             cookie.Values["tpp"] = user.Tpp.ToString();
             cookie.Values["ppp"] = user.Ppp.ToString();
             cookie.Values["invisible"] = user.Invisible.ToString();
             cookie.Values["referer"] = "index.aspx";
             cookie.Values["expires"] = expires.ToString();
             if (expires > )
             {
                 cookie.Expires = DateTime.Now.AddMinutes(expires);
             }
             cookie.Domain = cookieDomain;
             cookie.Path = "/";
             HttpContext.Current.Response.AppendCookie(cookie);
         }

这里的登录只是存一个子站间可以互相访问的cookie而已,要注意的是22行的密码,应该保存加密后的密码而不是明文密码,否则会导致你存的cookie在discuz!nt验证失败.

这里我说说discuz!nt的验证方式,所有页面都继承于PageBase,在它的构造函数里面会获取用户信息,来判断用户是否是游客,还是普通用户,这里的判断标识是以userid来判断,-1表示游客

  public PageBase()
         {
             if (recordPageView)
                 PageViewStatistic(pagename);

             config = GeneralConfigs.GetConfig();
             if (SpacePluginProvider.GetInstance() == null)
                 config.Enablespace = ;
             if (AlbumPluginProvider.GetInstance() == null)
                 config.Enablealbum = ;
             if (MallPluginProvider.GetInstance() == null)
                 config.Enablemall = ;

             LoadUrlConfig();
             userid = Utils.StrToInt(ForumUtils.GetCookie("userid"), -);
             //清空当前页面查询统计
 #if DEBUG
             Discuz.Data.DbHelper.QueryCount = ;
             Discuz.Data.DbHelper.QueryDetail = "";
 #endif
             // 如果启用游客页面缓存，则对游客输出缓存页
             if (userid == - && config.Guestcachepagetimeout >  && GetUserCachePage(pagename))
                 return;

             AddMetaInfo(config.Seokeywords, config.Seodescription, config.Seohead);

             if (config.Nocacheheaders == )
             {
                 System.Web.HttpContext.Current.Response.BufferOutput = false;
                 System.Web.HttpContext.Current.Response.ExpiresAbsolute = DateTime.Now.AddDays(-);
                 System.Web.HttpContext.Current.Response.Cache.SetExpires(DateTime.Now.AddDays(-));
                 System.Web.HttpContext.Current.Response.Expires = ;
                 System.Web.HttpContext.Current.Response.CacheControl = "no-cache";
                 System.Web.HttpContext.Current.Response.Cache.SetNoStore();
             }

             //当为forumlist.aspx或forumindex.aspx,可能出现在线并发问题,这时系统会延时2秒
             if ((pagename != "forumlist.aspx") && (pagename != "forumindex.aspx"))
                 oluserinfo = OnlineUsers.UpdateInfo(config.Passwordkey, config.Onlinetimeout);
             else
             {
                 try
                 {
                     oluserinfo = OnlineUsers.UpdateInfo(config.Passwordkey, config.Onlinetimeout);
                 }
                 catch
                 {
                     System.Threading.Thread.Sleep();
                     oluserinfo = OnlineUsers.UpdateInfo(config.Passwordkey, config.Onlinetimeout);
                 }
             }

代码15行,先获取用户id,这里是从cookie里面获取的,然后再根据id,pwd获取用户信息(代码44行).

这里我们看看UpdateInfo函数,代码如下:

 /// <summary>
         /// 用户在线信息维护。判断当前用户的身份(会员还是游客),是否在在线列表中存在,如果存在则更新会员的当前动,不存在则建立.
         /// </summary>
         /// <param name="passwordkey">用户密码</param
         /// <param name="timeout">在线超时时间</param>
         public static OnlineUserInfo UpdateInfo(string passwordkey, int timeout)
         {
             return UpdateInfo(passwordkey, timeout, -, "");
         }

在这里,它又重载了一次,重载代码如下:

         /// <summary>
         /// 用户在线信息维护。判断当前用户的身份(会员还是游客),是否在在线列表中存在,如果存在则更新会员的当前动,不存在则建立.
         /// </summary>
         /// <param name="passwordkey">论坛passwordkey</param>
         /// <param name="timeout">在线超时时间</param>
         /// <param name="passwd">用户密码</param>
         public static OnlineUserInfo UpdateInfo(string passwordkey, int timeout, int uid, string passwd)
         {
             lock (SynObject)
             {
                 OnlineUserInfo onlineuser = new OnlineUserInfo();
                 string ip = DNTRequest.GetIP();
                 int userid = TypeConverter.StrToInt(ForumUtils.GetCookie("userid"), uid);
                 string password = (Utils.StrIsNullOrEmpty(passwd) ? ForumUtils.GetCookiePassword(passwordkey) : ForumUtils.GetCookiePassword(passwd, passwordkey));

                 // 如果密码非Base64编码字符串则怀疑被非法篡改, 直接置身份为游客
                 if (password.Length ==  || !Utils.IsBase64String(password))
                     userid = -;

                 if (userid != -)
                 {
                     onlineuser = GetOnlineUser(userid, password);

                     //更新流量统计
                     if (!DNTRequest.GetPageName().EndsWith("ajax.aspx") && GeneralConfigs.GetConfig().Statstatus == )
                         Stats.UpdateStatCount(false, onlineuser != null);

                     if (onlineuser != null)
                     {
                         if (onlineuser.Ip != ip)
                         {
                             UpdateIP(onlineuser.Olid, ip);
                             onlineuser.Ip = ip;
                             return onlineuser;
                         }
                     }
                     else
                     {
                         // 判断密码是否正确
                         userid = Users.CheckPassword(userid, password, false);
                         if (userid != -)
                         {
                             Discuz.Data.OnlineUsers.DeleteRowsByIP(ip);
                             CheckIp(ip);
                             return CreateUser(userid, timeout);
                         }
                         else
                         {
                             CheckIp(ip);
                             // 如密码错误则在在线表中创建游客
                             onlineuser = GetOnlineUserByIP(-, ip);
                             if (onlineuser == null)
                                 return CreateGuestUser(timeout);
                         }
                     }
                 }
                 else
                 {
                     onlineuser = GetOnlineUserByIP(-, ip);
                     //更新流量统计
                     if (!DNTRequest.GetPageName().EndsWith("ajax.aspx") && GeneralConfigs.GetConfig().Statstatus == )
                         Stats.UpdateStatCount(true, onlineuser != null);

                     if (onlineuser == null)
                         return CreateGuestUser(timeout);
                 }

                 //onlineuser.Lastupdatetime = Utils.GetDateTime();  为了客户端能够登录注释此句，如有问题再修改。
                 return onlineuser;
             }
         }

在这块,会产生极大的误解,因为前文已经说过,-1是判断是游客的userid,然而它直接将用户id赋值为-1,会让我在看到第一个函数时,就以为它要获取的是游客信息,导致后面登录失败,当跳入到这个方法后(13行),我才发现它又从新在cookie里面获取了用户id,

这里的密码有个小细节

 /// <summary>
        /// 返回论坛用户密码cookie明文
        /// </summary>
        /// <param name="key">密钥</param>
        /// <returns></returns>
        public static string GetCookiePassword(string key)
        {
            return DES.Decode(GetCookie("password"), key).Trim();
        }

返回的是密码明文,也就是我最开始说的那个密码要保存加密后的,Discuz!nt会将你保存在cookie里的密码解密,它的实现方式是这样的,先将 123456用md5加密成密文,再将密文跟passwordkey,混合加密,然后把这段存入cookie的pwd,Discuz!nt再将cookie里

的pwd取出,解密,根据uderid和pwd,获取用户信息.

到这里Discuz!nt整合登录就实现了.