【ASP.NET】UCenter实现多站点同步登录退出
利用UCenter实现discuz论坛和应用网站同步登录和退出功能
测试环境：Discuz! X3.2、UCenter 1.6、.Net Framework 4.0
进入Discuz 后台的UCenter应用管理页面
UCenter
添加新应用
安装方式选择自定义安装、应用类型为其他。通信密钥可以自定义。开启同步登录和通知
添加新应用
集成UCenter API For DotNet
UC配置信息
把DS.Web.UCenter添加到项目中
修改项目App.Config配置信息:
UC_KEY 添加新应用时填写的通信密钥
UC_API UCenter地址
UC_APPID 应用网站在UCenter中的id
配置完毕后将网站运行起来，刷新一下应用列表界面
通信成功
如果上述配置信息正确，就可以看到应用通信成功了。
调用UCenter API
以登录为例，实例化一个UcClient对象，调用UserLogin方法
IUcClient client = new UcClient();
var user = client.UserLogin("admin", "admin"); //登陆
if (user.Success) //判断是否登陆成功
{
client.PmSend(0, 0, "公告", "测试公告", user.Uid); //给该用户发送系统消息
}
其他相关的API
using System.Collections.Generic;
namespace DS.Web.UCenter.Client
{
///<summary>
/// UcApi客户端
///</summary>
public interface IUcClient
{
/// <summary>
/// 用户注册
/// </summary>
/// <param name="userName">用户名</param>
/// <param name="passWord">密码</param>
/// <param name="email">Email</param>
/// <param name="questionId">登陆问题</param>
/// <param name="answer">答案</param>
/// <returns></returns>
UcUserRegister UserRegister(string userName, string passWord, string email, int questionId = 0, string answer = "");
/// <summary>
/// 用户登陆
/// </summary>
/// <param name="userName">用户名/Uid/Email</param>
/// <param name="passWord">密码</param>
/// <param name="loginMethod">登录方式</param>
/// <param name="checkques">需要登陆问题</param>
/// <param name="questionId">问题ID</param>
/// <param name="answer">答案</param>
/// <returns></returns>
UcUserLogin UserLogin(string userName, string passWord, LoginMethod loginMethod = LoginMethod.UserName, bool checkques = false, int questionId = 0, string answer = "");
/// <summary>
/// 得到用户信息
/// </summary>
/// <param name="userName">用户名</param>
/// <returns></returns>
UcUserInfo UserInfo(string userName);
/// <summary>
/// 得到用户信息
/// </summary>
/// <param name="uid">Uid</param>
/// <returns></returns>
UcUserInfo UserInfo(int uid);
/// <summary>
/// 更新用户信息
/// 更新资料需验证用户的原密码是否正确，除非指定 ignoreoldpw 为 1。
/// 如果只修改 Email 不修改密码，可让 newpw 为空；
/// 同理如果只修改密码不修改 Email，可让 email 为空。
/// </summary>
/// <returns></returns>
UcUserEdit UserEdit(string userName, string oldPw, string newPw, string email, bool ignoreOldPw = false, int questionId = 0, string answer = "");
/// <summary>
/// 删除用户
/// </summary>
/// <param name="uid">Uid</param>
/// <returns></returns>
bool UserDelete(params int[] uid);
/// <summary>
/// 删除用户头像
/// </summary>
/// <param name="uid">Uid</param>
void UserDeleteAvatar(params int[] uid);
/// <summary>
/// 同步登陆
/// </summary>
/// <param name="uid">Uid</param>
/// <returns>同步登陆的 Html 代码</returns>
string UserSynlogin(int uid);
/// <summary>
/// 同步登出
/// </summary>
/// <returns>同步登出的 Html 代码</returns>
string UserSynLogout();
/// <summary>
/// 检查 Email 格式
/// </summary>
/// <param name="email">Email</param>
/// <returns></returns>
UcUserCheckEmail UserCheckEmail(string email);
/// <summary>
/// 增加受保护用户
/// </summary>
/// <param name="admin">操作管理员</param>
/// <param name="userName">用户名</param>
/// <returns></returns>
bool UserAddProtected(string admin, params string[] userName);
/// <summary>
/// 删除受保护用户
/// </summary>
/// <param name="admin">操作管理员</param>
/// <param name="userName">用户名</param>
/// <returns></returns>
bool UserDeleteProtected(string admin, params string[] userName);
/// <summary>
/// 得到受保护用户
/// </summary>
/// <returns></returns>
UcUserProtecteds UserGetProtected();
/// <summary>
/// 合并用户
/// </summary>
/// <param name="oldUserName">老用户名</param>
/// <param name="newUserName">新用户名</param>
/// <param name="uid">Uid</param>
/// <param name="passWord">密码</param>
/// <param name="email">Email</param>
/// <returns></returns>
UcUserMerge UserMerge(string oldUserName, string newUserName, int uid, string passWord, string email);
/// <summary>
/// 移除重名用户记录
/// </summary>
/// <param name="userName">用户名</param>
void UserMergeRemove(string userName);
/// <summary>
/// 得到用户积分
/// </summary>
/// <param name="appId">应用程序Id</param>
/// <param name="uid">Uid</param>
/// <param name="credit">积分编号</param>
/// <returns></returns>
int UserGetCredit(int appId, int uid, int credit);
/// <summary>
/// 检查新消息
/// </summary>
/// <param name="uid">Uid</param>
/// <returns></returns>
UcPmCheckNew PmCheckNew(int uid);
/// <summary>
/// 发送短消息
/// </summary>
/// <param name="fromUid">发件人用户 ID，0 为系统消息</param>
/// <param name="replyPmId">回复的消息 ID，0:发送新的短消息，大于 0:回复指定的短消息</param>
/// <param name="subject">消息标题</param>
/// <param name="message">消息内容</param>
/// <param name="msgTo">收件人ID</param>
/// <returns></returns>
UcPmSend PmSend(int fromUid, int replyPmId, string subject, string message, params int[] msgTo);
/// <summary>
/// 发送短消息
/// </summary>
/// <param name="fromUid">发件人用户 ID，0 为系统消息</param>
/// <param name="replyPmId">回复的消息 ID，0:发送新的短消息，大于 0:回复指定的短消息</param>
/// <param name="subject">消息标题</param>
/// <param name="message">消息内容</param>
/// <param name="msgTo">收件人用户名</param>
/// <returns></returns>
UcPmSend PmSend(int fromUid, int replyPmId, string subject, string message, params string[] msgTo);
/// <summary>
/// 删除短消息
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="folder">文件夹</param>
/// <param name="pmIds">短消息ID</param>
/// <returns>删除的数量</returns>
int PmDelete(int uid, PmDeleteFolder folder, params int[] pmIds);
/// <summary>
/// 删除会话
/// </summary>
/// <param name="uid">发件人</param>
/// <param name="toUids">收件人</param>
/// <returns>删除的数量</returns>
int PmDelete(int uid, params int[] toUids);
/// <summary>
/// 修改阅读状态
/// </summary>
/// <param name="uid">发件人</param>
/// <param name="toUids">收件人</param>
/// <param name="pmIds">短消息ID</param>
/// <param name="readStatus">阅读状态</param>
void PmReadStatus(int uid, int toUids, int pmIds = 0, ReadStatus readStatus = ReadStatus.Readed);
/// <summary>
/// 修改阅读状态
/// </summary>
/// <param name="uid">发件人</param>
/// <param name="toUids">收件人数组</param>
/// <param name="pmIds">短消息ID数组</param>
/// <param name="readStatus">阅读状态</param>
void PmReadStatus(int uid, IEnumerable<int> toUids, IEnumerable<int> pmIds, ReadStatus readStatus = ReadStatus.Readed);
/// <summary>
/// 获取短消息列表
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="page">当前页编号，默认值 1</param>
/// <param name="pageSize">每页最大条目数，默认值 10</param>
/// <param name="folder">短消息所在的文件夹</param>
/// <param name="filter">过滤方式</param>
/// <param name="msgLen">截取短消息内容文字的长度，0 为不截取，默认值 0</param>
/// <returns></returns>
UcPmList PmList(int uid, int page = 1, int pageSize = 10, PmReadFolder folder = PmReadFolder.NewBox, PmReadFilter filter = PmReadFilter.NewPm, int msgLen = 0);
/// <summary>
/// 获取短消息内容
/// 本接口函数用于返回指定用户的指定消息 ID 的消息，返回的数据中包含针对这个消息的回复。
/// 如果指定 touid 参数，那么短消息将列出所有 uid 和 touid 之间的短消息，daterange 可以指定返回消息的日期范围。
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="pmId">短消息ID</param>
/// <param name="toUid">收件人ID</param>
/// <param name="dateRange">日期范围</param>
/// <returns></returns>
UcPmView PmView(int uid, int pmId, int toUid = 0, DateRange dateRange = DateRange.Today);
/// <summary>
/// 获取单条短消息内容
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="type">类型</param>
/// <param name="pmId">短消息ID</param>
/// <returns></returns>
UcPm PmViewNode(int uid, ViewType type = ViewType.Specified, int pmId = 0);
/// <summary>
/// 忽略未读消息提示
/// </summary>
/// <param name="uid">Uid</param>
void PmIgnore(int uid);
/// <summary>
/// 得到黑名单
/// </summary>
/// <param name="uid">Uid</param>
/// <returns></returns>
UcPmBlacklsGet PmBlacklsGet(int uid);
/// <summary>
/// 设置黑名单为禁止所有人（清空原数据）
/// </summary>
/// <param name="uid">Uid</param>
/// <returns></returns>
bool PmBlacklsSetAll(int uid);
/// <summary>
/// 设置黑名单（清空原数据）
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="userName">黑名单用户名</param>
/// <returns></returns>
bool PmBlacklsSet(int uid, params string[] userName);
/// <summary>
/// 添加黑名单为禁止所有人
/// </summary>
/// <param name="uid">Uid</param>
/// <returns></returns>
bool PmBlacklsAddAll(int uid);
/// <summary>
/// 增加黑名单
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="userName">黑名单用户名</param>
/// <returns></returns>
bool PmBlacklsAdd(int uid, params string[] userName);
/// <summary>
/// 删除黑名单中的禁止所有人
/// </summary>
/// <param name="uid">Uid</param>
/// <returns></returns>
void PmBlacklsDeleteAll(int uid);
/// <summary>
/// 删除黑名单
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="userName">黑名单用户名</param>
void PmBlacklsDelete(int uid, params string[] userName);
/// <summary>
/// 增加好友
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="friendId">好友ID</param>
/// <param name="comment">备注</param>
/// <returns></returns>
bool UcFriendAdd(int uid, int friendId, string comment = "");
/// <summary>
/// 删除好友
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="friendIds">好友ID</param>
/// <returns></returns>
bool UcFriendDelete(int uid, params int[] friendIds);
/// <summary>
/// 获取好友总数
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="direction">方向</param>
/// <returns>好友数目</returns>
int UcFriendTotalNum(int uid, FriendDirection direction = FriendDirection.All);
/// <summary>
/// 好友列表
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="page">当前页编号</param>
/// <param name="pageSize">每页最大条目数</param>
/// <param name="totalNum">好友总数</param>
/// <param name="direction">方向</param>
/// <returns></returns>
UcFriends UcFriendList(int uid, int page = 1, int pageSize = 10, int totalNum = 10, FriendDirection direction = FriendDirection.All);
/// <summary>
/// 积分兑换请求
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="from">原积分</param>
/// <param name="to">目标积分</param>
/// <param name="toAppId">目标应用ID</param>
/// <param name="amount">积分数额</param>
/// <returns></returns>
bool UcCreditExchangeRequest(int uid, int from, int to, int toAppId, int amount);
///<summary>
/// 修改头像
///</summary>
///<param name="uid">Uid</param>
///<param name="type"></param>
///<returns></returns>
string Avatar(int uid, AvatarType type = AvatarType.Virtual);
/// <summary>
/// 得到头像地址
/// </summary>
/// <param name="uid">Uid</param>
/// <param name="size">大小</param>
/// <param name="type">类型</param>
/// <returns></returns>
string AvatarUrl(int uid,AvatarSize size,AvatarType type = AvatarType.Virtual);
/// <summary>
/// 检查头像是否存在
/// </summary>
/// <param name="uid"></param>
/// <param name="size"></param>
/// <param name="type"></param>
/// <returns></returns>
bool AvatarCheck(int uid, AvatarSize size = AvatarSize.Middle, AvatarType type = AvatarType.Virtual);
/// <summary>
/// 获取标签数据
/// </summary>
/// <param name="tagName">标签名</param>
/// <param name="number">应用程序ID对应的数量</param>
/// <returns></returns>
UcTags TagGet(string tagName, IEnumerable<KeyValuePair<string, string>> number);
/// <summary>
/// 添加事件
/// </summary>
/// <param name="icon">图标类型，如：thread、post、video、goods、reward、debate、blog、album、comment、wall、friend</param>
/// <param name="uid">Uid</param>
/// <param name="userName">用户名</param>
/// <param name="titleTemplate">标题模板</param>
/// <param name="titleData">标题数据数组</param>
/// <param name="bodyTemplate">内容模板</param>
/// <param name="bodyData">模板数据</param>
/// <param name="bodyGeneral">相同事件合并时用到的数据：特定的数组，只有两项：name、link，保留</param>
/// <param name="targetIds">保留</param>
/// <param name="images">相关图片的 URL 和链接地址。一个图片地址，一个链接地址</param>
/// <returns></returns>
int FeedAdd(FeedIcon icon, int uid, string userName, string titleTemplate, string titleData, string bodyTemplate, string bodyData, string bodyGeneral, string targetIds, params string[] images);
/// <summary>
/// 得到Feed
/// </summary>
/// <param name="limit">数量限制</param>
/// <returns></returns>
UcFeeds FeedGet(int limit);
/// <summary>
/// 得到应用列表
/// </summary>
/// <returns></returns>
UcApps AppList();
/// <summary>
/// 添加邮件到队列
/// </summary>
/// <param name="subject">标题</param>
/// <param name="message">内容</param>
/// <param name="uids">Uid</param>
/// <returns></returns>
UcMailQueue MailQueue(string subject, string message,params int[] uids);
/// <summary>
/// 添加邮件到队列
/// </summary>
/// <param name="subject">标题</param>
/// <param name="message">内容</param>
/// <param name="emails">目标Email</param>
/// <returns></returns>
UcMailQueue MailQueue(string subject, string message, params string[] emails);
/// <summary>
/// 添加邮件到队列
/// </summary>
/// <param name="subject">标题</param>
/// <param name="message">内容</param>
/// <param name="uids">Uid</param>
/// <param name="emails">目标email</param>
/// <returns></returns>
UcMailQueue MailQueue(string subject, string message, int[] uids, string[] emails);
/// <summary>
/// 添加邮件到队列
/// </summary>
/// <param name="subject">标题</param>
/// <param name="message">内容</param>
/// <param name="fromMail">发信人，可选参数，默认为空，uc后台设置的邮件来源作为发信人地址</param>
/// <param name="charset">邮件字符集，可选参数，默认为gbk</param>
/// <param name="htmlOn">是否是html格式的邮件，可选参数，默认为FALSE，即文本邮件</param>
/// <param name="level">邮件级别，可选参数，默认为1，数字大的优先发送，取值为0的时候立即发送，邮件不入队列</param>
/// <param name="uids">Uid</param>
/// <param name="emails">目标email</param>
/// <returns></returns>
UcMailQueue MailQueue(string subject,string message,string fromMail,string charset,bool htmlOn,int level,int[] uids,string[] emails);
}
}
供UCenter调用的接口
在站点新建一个路径为/API/uc.ashx的文件 （文件夹名称要大写）
添加以下代码
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using DS.Web.UCenter.Api;
namespace DS.Web.UCenter.Website.API
{
/// <summary>
/// Summary description for uc
/// </summary>
public class uc:UcApiBase
{
// 用户被删除
public override ApiReturn DeleteUser(IEnumerable<int> ids)
{
throw new NotImplementedException();
}
// 修改了用户名
public override ApiReturn RenameUser(int uid, string oldUserName, string newUserName)
{
throw new NotImplementedException();
}
public override UcTagReturns GetTag(string tagName)
{
throw new NotImplementedException();
}
// 同步登录
public override ApiReturn SynLogin(int uid)
{
throw new NotImplementedException();
}
// 同步退出
public override ApiReturn SynLogout()
{
throw new NotImplementedException();
}
// 密码更新
public override ApiReturn UpdatePw(string userName, string passWord)
{
throw new NotImplementedException();
}
public override ApiReturn UpdateBadWords(UcBadWords badWords)
{
throw new NotImplementedException();
}
public override ApiReturn UpdateHosts(UcHosts hosts)
{
throw new NotImplementedException();
}
public override ApiReturn UpdateApps(UcApps apps)
{
throw new NotImplementedException();
}
public override ApiReturn UpdateClient(UcClientSetting client)
{
throw new NotImplementedException();
}
public override ApiReturn UpdateCredit(int uid, int credit, int amount)
{
throw new NotImplementedException();
}
public override UcCreditSettingReturns GetCreditSettings()
{
throw new NotImplementedException();
}
public override ApiReturn GetCredit(int uid, int credit)
{
throw new NotImplementedException();
}
public override ApiReturn UpdateCreditSettings(UcCreditSettings creditSettings)
{
throw new NotImplementedException();
}
}
}
这些是提供给UCenter调用的接口，例如当用户在discuz登录时，UCenter会发送一个通知（请求uc.ashx），把登录的用户uid等信息传递过来，我们要做的就是在自己的SynLogin中写登录的cookie或session等操作。
同时，在SynLogout中加上清除cookie和session的处理。就实现了同步登录和退出功能。
注意点
- 添加应用时一定要勾选 开启同步登录 和 接受通知
- 需要正确填写UC各项必填的配置信息
- 确保在bbs站点存在
/uc_client/data/cache/apps.php文件，没有的话从/uc_server/data/cache/apps.php拷贝一份 - 要将上述配置信息放到站点的
Web.config中
同步注册
如果你的网站还需要同步注册功能，请参考[【ASP.Net】UCenter实现多站点同步登录退出】(http://www.jianshu.com/p/1caa425ef24b)
作者：lancely
链接：https://www.jianshu.com/p/1a6c8ba2c003
來源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。
【ASP.NET】UCenter实现多站点同步登录退出的更多相关文章
- Ucenter整合Thinkphp 双向同步登录退出
1.整合初步工作: 1,安装Ucenter,完成后添加应用,填写要对接的网站地址 2,api , uc_client目录放置对接项目的根目录 3,通信对接,新建Ucenter组,confi文件填写在u ...
- 【ASP.NET】UCenter实现多站点同步注册
问题描述 上一篇文章写了[ASP.Net]UCenter实现多站点同步登录退出 在整合论坛的时候,同步注册也是相当必要的一个功能:将论坛注册的用户同步到自己的网站,自己网站注册的用户同步到论坛. 官方 ...
- Yii2 多域名跨域同步登录退出
在平台开发过程中,项目分为前台(frontend)www.xxx.com和后台(backend) yun.xxx.com两部分,绑定两个域名, 我们知道在没有绑定域名的时候前后台可以同步登录和退出,但 ...
- ucenter通信实现同步登录、同步退出(详细)
首先,需要去官网下载一个ucenter的包.然后解压下来. 先把ucenter/ucenter这个文件夹复制到你的项目根目录下改名为uc_server;(这里只是我建议修改,以便于我下面写的配置); ...
- ucenter 整合同步登录的内部实现原理及thinkphp整合ucenter
1.用户登录discuz,通过logging.php文件中的函数uc_user_login对post过来的数据进行验证,也就是对username和password进行验证.2.如果验证成功,将调用位于 ...
- 【转】 Ucenter同步登录原理解析
应用中调用函数us_user_synlogin并输出 echo uc_user_synlogin($uid); 解析: 1. 该函数位于client.PHP中 2. 作用实质上是调用ucenter u ...
- ucenter 同步登录总结
部署: discuz默认安装后就安装了uc_server应用 各应用根目录必须有uc_client文件夹. 下载ucenter程序查看范例程序 应用管理中,应用的主 URL必须指向到应用的根目录,应用 ...
- ucenter 整合同步登录的内部实现原理
1.用户登录discuz,通过logging.php文件中的函数uc_user_login对post过来的数据进行验证,也就是对username和password进行验证. 2.如果验证成功,将调用位 ...
- UCENTER同步登录工作原理和配置要点
ucenter的同步登录原理: 1)Ucenter是和uc_client同步的.每个PHP应用,加入了UCENTER后,都会在主目录下有个UC_CLIENT目录.这个目录里,都有一个client.PH ...
随机推荐
- PDB文件详解
原文地址:http://blog.csdn.net/feihe0755/article/details/54233714 PDB文件的介绍 PDB(Program Data Base),意即程序的基本 ...
- Linux inode与文件系统关系
inode只有在linux文件系统的概念(ext3,ext4) .inode节点数量与文件存储的关系. 二.在文件系统初始化时设置合适的节点数量. linux服务器在存储文件小而数量多的情况下,需要考 ...
- web页面加载、解析、渲染过程
仅做学习参考,侵权删 原文链接:风吹De麦浪 https://www.cnblogs.com/CandyManPing/p/6635008.html 一.浏览器 浏览器的主要功能是将用户选择的we ...
- [1]字符串按中文符占3位进行指定长度剪切[2]Double类型截取指定长度（指定长度=整数位+小数位）
/** 将中文字符串剪切为在当前db2(编码GBK)中所占用的长度*/ public String cutStringForDb2(String src,Integer size) { int len ...
- Django 笔记（二） 新建 ~ 渲染
新建APP python manange.py startapp app_name 然后右键 pycharm 的项目目录,将新建的目录从服务器上下载进来 URL(Uniform Resoure Loc ...
- inode索引详解
理解inode inode是一个重要概念,是理解Unix/Linux文件系统和硬盘储存的基础. 我觉得,理解inode,不仅有助于提高系统操作水平,还有助于体会Unix设计哲学,即如何把底层的复杂性抽 ...
- 在 Confluence 6 中禁用 workbox 应用通知
如果你选择 不提供应用通知(does not provide in-app notifications): Confluence workbox 图标将不会可见同时用户也不能在这个服务器上访问 wor ...
- Swift Write to file 到电脑桌面
(arr as NSArray).write(toFile: "Users/你的用户名/Desktop/mian.plist", atomically: true)
- leetcode(js)算法之17电话号码的字母组合
给定一个仅包含数字 2-9 的字符串,返回所有它能表示的字母组合. 给出数字到字母的映射如下(与电话按键相同).注意 1 不对应任何字母 示例: 输入:"23" 输出:[" ...
- Spark-SQL之DataFrame操作
Spark SQL中的DataFrame类似于一张关系型数据表.在关系型数据库中对单表或进行的查询操作,在DataFrame中都可以通过调用其API接口来实现.可以参考,Scala提供的DataFra ...