IM即时通讯

登录鉴权

SDK登录鉴权的目的

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

动态token鉴权方案说明

token_authen

  1. 应用服务器调用register注册IM用户;
  2. 注册成功后,应用服务器调用token生成器,基于appid+appsecret+userid生成一个token并保存起来;
  3. 应用客户端发起登陆请求,走应用自有的登录验证逻辑,如验证账号密码;
  4. 验证成功后,应用服务器下发userid和token,应用客户端保存起来;
  5. 应用客户端需要使用IM服务时,进行token认证并登录IM服务;
  6. token认证成功,应用客户端登录IM服务成功,之后就可以正常使用IM的各项功能;
说明:
  • 这里需要注意,应用的用户帐号和密码,与SDK登录IM使用的userid和token是完全独立的,userid和token只用于IM服务的鉴权。

登录示例

设置消息监听

import { IMEvents} from "crimsdk";

IMSDK.on(IMEvents.OnConnectSuccess, () => {
	// 连接成功
})
IMSDK.on(IMEvents.OnConnectFailed, () => {
	// 连接失败
})   
IMSDK.on(IMEvents.OnKickedOffline, () => {
	// 被踢下线
})
IMSDK.on(IMEvents.OnUserTokenExpired, () => {
	// token过期
})

相关API请参考:

使用userID、token登录SDK

try {
    await IMSDK.login({
        userID: 'xxxx',
        appId: 'xxxx',
        appSecret: 'xxxx',
        sdkServer: 'xxxx',
    });
    // 登录成功
} catch(e) {
    // 登录失败
}

相关API请参考: