IM即时通讯

登录鉴权

SDK登录鉴权的目的

确保只有合法的身份才能使用sdk接入到服务器。

SDK登录鉴权方案

  1. 密码鉴权方案: 此方案简单,配合https通信,适用于一般的安全要求;
  2. 动态token鉴权方案: 此方案每次登录token都不一样,并且可自定义token的有效期,具有更高的安全性;

密码鉴权方案说明

pswd_authen

  1. 应用服务器调用im服务器的register,注册IM用户得到UserID;
  2. 注册成功后,应用服务器将UserID保存;
  3. 客户端发起登陆请求,走应用自有的登录验证逻辑,如验证账号密码;
  4. 验证成功后,应用服务器下发UserID、AppID、AppSecret给客户端;
  5. 客户端使用UserID、AppID、AppSecret通过IM SDK登录IM服务;
  6. 认证成功后客户端登录IM服务成功,之后就可以正常使用IM SDK的各项功能;
说明:
  • 这里需要注意,应用自有的登录验证的帐号和密码,与SDK登录IM Server使用的UserID、AppID、AppSecret是完全独立的。

密码鉴权方案说明

token_authen

  1. 应用服务器调用im服务器的register,注册IM用户得到UserID;
  2. 注册成功后,应用服务器将UserID保存;
  3. 客户端发起登陆请求,走应用自有的登录验证逻辑,如验证账号密码;
  4. 验证成功后,应用服务器下发UserID和Token(调用token生成器生成)给客户端;
  5. 客户端使用UserID和Token通过IM SDK登录IM服务;
  6. Token认证成功后客户端登录IM服务成功,之后就可以正常使用IM SDK的各项功能;
说明:
  • 这里需要注意,应用自有的登录验证的帐号和密码,与SDK登录IM Server使用的UserID和Token是完全独立的。

登录示例

创建并初始化SDK

CRIMSDK::CRIMManager* imsdk = new CRIMSDK::CRIMManager();

QVariantMap varMap;
varMap["platformID"] = CRIM_WIN; //windows
varMap["sdkServer"] = apiUrl;
varMap["dataDir"] = storageDir;
varMap["logFilePath"] = logDir;
varMap["logLevel"] = CRIM_DEBUGLEVEL;
QByteArray byStr = QJsonDocument::fromVariant(variant).toJson(QJsonDocument::Compact);
bool bSuccess = imsdk->initSDK(byStr.constData());
if( !bSuccess )
{
	//初始化失败
}
else
{
	//初始化成功, 注册消息回调
	//CRIMCallbacker* pCallBack;
	imsdk->addCallBack(pCallBack);
}

相关API请参考:

密码方式登录

从自身业务服务器获取到userID、IM SDK APPID、IM SDK AppSecret, 然后进行登录:

//登录处理:
string appID = "";
string appSecret = "";
string userID = "";
imsdk->loginWithAppID(userID.c_str(), appID.c_str(), appSecret.c_str());
//登录成功回调
virtual void CRIMCallbacker::loginSuccess(const char *data, const char *cookie)
{
}
//登录失败回调
virtual void CRIMCallbacker::loginFailure(int errCode, const char *errMsg, const char *cookie)
{
}

相关API请参考:

Token方式登录

//登录处理:
string userID = "";
string token = "";
imsdk->loginWithToken(userID.c_str(), token.c_str());
//登录成功回调
virtual void CRIMCallbacker::loginSuccess(const char *data, const char *cookie)
{
}
//登录失败回调
virtual void CRIMCallbacker::loginFailure(int errCode, const char *errMsg, const char *cookie)
{
}

相关API请参考: