用户注册与登录

大约 3 分钟

用户注册与登录

本文介绍用户注册模式与登录方式。

用户注册模式

用户注册模式分为以下两种:

  • 开放注册:一般在体验 Demo 和测试环境时使用,正式环境中不推荐使用该方式注册环信账号。要使用开放注册,需要在环信即时通讯云控制台open in new window即时通讯 > 服务概览设置区域,将用户注册模式设置为开放注册。只有打开该开关,才能使用客户端或 REST API开放注册用户。
  • 授权注册:通过环信提供的 REST API 注册环信用户账号,注册后保存到你的服务器或返给客户端。要使用授权注册,你需要在环信即时通讯云控制台open in new window即时通讯 > 服务概览设置区域,将用户注册模式设置为授权注册。相关的 REST API 介绍,详见授权注册单个用户批量授权注册用户的接口介绍。

除此以外,可以在环信即时通讯云控制台open in new window创建用户,详见创建用户相关介绍

用户登录

初始化环信即时通讯 IM SDK 后,你需要调用登录接口进行登录。只有登录成功后,你才能正常使用 IM 的各种功能,例如消息和会话。

目前登录服务器支持主动和自动登录。主动登录有两种方式:

  • 用户 ID + 密码
  • 用户 ID + token
参数类型是否必需描述
usernameString用户 ID,长度不可超过 64 个字节。不可设置为空。支持以下字符集:
- 26 个小写英文字母 a-z;
- 26 个大写英文字母 A-Z;
- 10 个数字 0-9;
- “_”, “-”, “.”。

注意


- 该参数不区分大小写,因此 Aaaa 为相同的用户 ID。
- 请确保同一个 app 下,用户 ID 唯一;
- 用户 ID 为公开信息,请勿使用 UUID、邮箱地址、手机号等敏感信息。

tokenStringtoken 可以通过调用 REST API 获取,即传入用户 ID (或用户 ID + 密码)和 token 有效期参数获取,详见 环信用户 token 的获取

注意


- 你可以在调用 REST API 获取 token 时,传入 ttl 参数,设置 token 的有效期。此外,你也可以通过环信即时通讯云控制台open in new window用户认证页面设置 token 的有效期。该参数值以最新设置为准。
- 环信服务器完全信赖用户 token,为避免业务受影响,你需要确保 token 的安全。

passwordString用户的登录密码,长度不可超过 64 个字符。

登录流程

  • 用户 ID + 密码

img

  • 用户 ID + Token

img

提示

  1. 关于获取 token,详见获取 App Token获取 User Token
  2. 获取 token 时,token 有效期 ttl 以传入的值为准。若不传该参数,以环信即时通讯云控制台open in new window用户认证页面的 token 有效期的设置为准,默认为 60 天。若设置为 0,则 token 永久有效。