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 服务的鉴权。

登录示例

调用初始化接口(initSDK)初始化 SDK:

await CRIM.iMManager.initSDK(
  sdkServer: "http://www.xxxx.com",
  dataDir: "/path/to/data",
  logLevel: 3,
  isLogStandardOutput: true,
  listener: OnConnectListener(  // 设置连接监听器:
    onConnecting: () {
      // SDK 正在连接服务器
    },
    onConnectFailed: (code, errorMsg) {
      // SDK 连接服务器失败
    },
    onConnectSuccess: () {
      // SDK 已成功连接到服务器
    },
    onKickedOffline: () {
      // 当前用户被踢下线
    },
    onUserTokenExpired: () {
      // 登录票据过期,需要重新登录
    },
  ),
);

相关 API 请参考:

使用 appID、appSecret、userID 登录 SDK:

try {
  final userInfo = await CRIM.iMManager.login(
    appID: "your_app_id",
    appSecret: "your_app_secret",
    userID: "user_id",
  );
  // 登录成功,userInfo 为登录用户信息
} catch (e) {
  // 登录失败
}

或使用 token 方式登录:

try {
  final userInfo = await CRIM.iMManager.login(
    appID: "your_app_id",
    token: "your_token",
    userID: "user_id",
  );
  // 登录成功
} catch (e) {
  // 登录失败
}

相关 API 请参考: