用户注册与登录
大约 3 分钟
产品介绍
用户注册与登录
本文介绍用户注册模式与登录方式。
用户注册模式
用户注册模式分为以下两种:
- 开放注册:一般在体验 Demo 和测试环境时使用,正式环境中不推荐使用该方式注册环信账号。要使用开放注册,需要在环信即时通讯云控制台的即时通讯 > 服务概览的设置区域,将用户注册模式设置为开放注册。只有打开该开关,才能使用客户端或 REST API开放注册用户。
- 授权注册:通过环信提供的 REST API 注册环信用户账号,注册后保存到你的服务器或返给客户端。要使用授权注册,你需要在环信即时通讯云控制台的即时通讯 > 服务概览的设置区域,将用户注册模式设置为授权注册。相关的 REST API 介绍,详见授权注册单个用户和批量授权注册用户的接口介绍。
除此以外,可以在环信即时通讯云控制台创建用户,详见创建用户相关介绍。
用户登录
初始化环信即时通讯 IM SDK 后,你需要调用登录接口进行登录。只有登录成功后,你才能正常使用 IM 的各种功能,例如消息和会话。
目前登录服务器支持主动和自动登录。主动登录有两种方式:
- 用户 ID + 密码
- 用户 ID + token
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
username | String | 是 | 用户 ID,长度不可超过 64 个字节。不可设置为空。支持以下字符集: - 26 个小写英文字母 a-z; - 26 个大写英文字母 A-Z; - 10 个数字 0-9; - “_”, “-”, “.”。 注意
|
token | String | 是 | token 可以通过调用 REST API 获取,即传入用户 ID (或用户 ID + 密码)和 token 有效期参数获取,详见 环信用户 token 的获取。 注意
|
password | String | 是 | 用户的登录密码,长度不可超过 64 个字符。 |
登录流程
- 用户 ID + 密码
- 用户 ID + Token
提示
- 关于获取 token,详见获取 App Token和获取 User Token。
- 获取 token 时,token 有效期
ttl
以传入的值为准。若不传该参数,以环信即时通讯云控制台的用户认证页面的 token 有效期的设置为准,默认为 60 天。若设置为0
,则 token 永久有效。