差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
im:other:integrationcases:usersandfriends [2018/12/25 11:34] jk |
im:other:integrationcases:usersandfriends [2022/07/22 02:33] (当前版本) jennifer.zeng [客户端集成] |
||
---|---|---|---|
行 1: | 行 1: | ||
- | ====== 已上线的应用导入到环信 ====== | + | ====== 已上线应用的用户体系导入到环信 ====== |
---- | ---- | ||
行 5: | 行 5: | ||
===== 集成概述 ===== | ===== 集成概述 ===== | ||
- | 环信和用户体系的集成主要发生在2个地方,服务器端集成和客户端集成。参考[[im:server:ready:user|用户和好友体系集成]] | + | 环信和用户体系的集成主要发生在2个地方,服务器端集成和客户端集成。参考 [[ccim:rest:accountsystem|用户体系集成 REST API]]。 |
{{ ::image001.png?nolink |}} | {{ ::image001.png?nolink |}} | ||
行 18: | 行 18: | ||
要使用环信,只需要为每一个 APP 用户创建一个环信账号。创建环信账号仅需要以下信息: | 要使用环信,只需要为每一个 APP 用户创建一个环信账号。创建环信账号仅需要以下信息: | ||
^名称 ^字段名 ^数据类型 ^描述^ | ^名称 ^字段名 ^数据类型 ^描述^ | ||
- | |环信 ID |username |String |在 AppKey 的范围内唯一用户名,也是第三方用户体系中的primarykey。| | + | |环信 ID |username |String |在 AppKey 的范围内唯一用户名,也是第三方用户体系中的 primarykey。| |
- | |用户密码 |password |String |用户登录环信使用的密码。为保证第三方用户体系中的账号密码不必要的泄露给环信,建议对第三方用户体系的账号密码做一次hash算法。然后在手机端登录环信时,客户端同样使用hash后的密码登录。| | + | |用户密码 |password |String |用户登录环信使用的密码。为保证第三方用户体系中的账号密码不必要的泄露给环信,建议对第三方用户体系的账号密码做一次 hash 算法。然后在手机端登录环信时,客户端同样使用 hash 后的密码登录。| |
==== 服务器端集成 ==== | ==== 服务器端集成 ==== | ||
- | **将已上线的 APP 的现有用户集成到环信**[[im:server:ready:user|用户管理 REST API]] 提供了一个创建环信账号的 REST 方法。这个方法很简单,只需要提供账号 ID 和密码2个参数,就可以创建一个环信账号。对一个已经上线,已经有很多现有用户的 APP 来说,要集成环信,只需要写一个脚本,循环调用创建环信用户的 REST 方法即可。 | + | **将已上线的 APP 的现有用户集成到环信** [[ccim:rest:accountsystem|用户体系集成 REST API]] 提供了一个创建环信账号的 REST 方法。这个方法很简单,只需要提供账号 ID 和密码 2 个参数,就可以创建一个环信账号。对一个已经上线,已经有很多现有用户的 APP 来说,要集成环信,只需要写一个脚本,循环调用创建环信用户的 REST 方法即可。 |
环信账号中的 username 可以和已有的 APP 用户体系的用户的 primarykey 相同。这样做的好处是不需要对现有 APP 后台的数据库的用户表做任何修改(比如不需要给用户表增加一个叫环信账号 ID 的字段)。 | 环信账号中的 username 可以和已有的 APP 用户体系的用户的 primarykey 相同。这样做的好处是不需要对现有 APP 后台的数据库的用户表做任何修改(比如不需要给用户表增加一个叫环信账号 ID 的字段)。 | ||
- | **APP 创建新用户时创建环信账号 **为保证安全,强烈建议只在服务器端调用创建环信账号的 REST 方法。具体方法见[[im:server:ready:user|用户管理 REST API]]。即每次当APP客户端调用APP自己的业务后台创建新用户时,也在环信上为该 APP 用户创建一个环信账号。 | + | **APP 创建新用户时创建环信账号 **为保证安全,强烈建议只在服务器端调用创建环信账号的 REST 方法。具体方法见 [[ccim:rest:accountsystem|用户体系集成 REST API]]。即每次当APP客户端调用APP自己的业务后台创建新用户时,也在环信上为该 APP 用户创建一个环信账号。 |
通常的做法是在自己 APP 创建用户成功后调用创建环信账号的 REST 方法来创建环信账号。因为这个方法是服务器对服务器的调用,所以因为网络不稳定原因失败的可能很小。但开发者仍旧需要对该方法的返回结果做处理,如果该方法失败,应该做个 retry,如果仍旧失败,应该回滚在自己 APP 创建用户的操作。否则会导致 APP 的用户账号和环信账号不一致的问题。 | 通常的做法是在自己 APP 创建用户成功后调用创建环信账号的 REST 方法来创建环信账号。因为这个方法是服务器对服务器的调用,所以因为网络不稳定原因失败的可能很小。但开发者仍旧需要对该方法的返回结果做处理,如果该方法失败,应该做个 retry,如果仍旧失败,应该回滚在自己 APP 创建用户的操作。否则会导致 APP 的用户账号和环信账号不一致的问题。 | ||
- | **APP 删除用户时删除环信账号**为保证安全,强烈建议只在服务器端调用删除环信账号的 REST 方法。具体方法见[[im:server:ready:user|用户管理 REST API]]。即每次当APP客户端调用APP自己的业务后台删除新用户时,也在环信上将该 APP 用户对应的环信账号删除。 | + | **APP 删除用户时删除环信账号**为保证安全,强烈建议只在服务器端调用删除环信账号的 REST 方法。具体方法见 [[ccim:rest:accountsystem|用户体系集成 REST API]]。即每次当APP客户端调用 APP 自己的业务后台删除新用户时,也在环信上将该 APP 用户对应的环信账号删除。 |
- | **APP 修改用户密码时更新环信账号的密码**为保证安全,强烈建议只在服务器端调用修改环信账号密码的 REST 方法。具体方法见[[im:server:ready:user|用户管理 REST API]]。即每次当 APP 用户的密码被修改时,也要更新该 APP 用户对应的环信账号的密码。 | + | **APP 修改用户密码时更新环信账号的密码**为保证安全,强烈建议只在服务器端调用修改环信账号密码的 REST 方法。具体方法见 [[ccim:rest:accountsystem|用户体系集成 REST API]]。即每次当 APP 用户的密码被修改时,也要更新该 APP 用户对应的环信账号的密码。 |
==== 客户端集成 ==== | ==== 客户端集成 ==== | ||
- | **客户端登录集成**APP 客户端在登录自己的 APP 服务器后台成功后,需要调用环信客户端 SDK 的登录方法。 | + | **客户端登录集成** APP 客户端在登录自己的 APP 服务器后台成功后,需要调用环信客户端 SDK 的登录方法。 |
- | **客户端退出登录集成**APP 客户端在退出登录自己的 APP 服务器后台成功后,需要调用环信客户端 SDK 的退出登录方法。 | + | **客户端退出登录集成** APP 客户端在退出登录自己的 APP 服务器后台成功后,需要调用环信客户端 SDK 的退出登录方法。 |
===== 好友体系导入环信 ===== | ===== 好友体系导入环信 ===== | ||
- | 所谓好友体系,是指谁是谁的好友的关系体系。环信提供好友体系,但不是必须使用的。比如对一个企业内部移动办公 APP 来说,因为企业内部同事是彼此认识的,那么此 APP 可能是不需要消息发送权限控制的。即任何人都可以给任何人发消息。但一个交友类的 APP 就必须要控制只有我的好友才能给我发消息,不是我的好友的人需要向我发送加好友邀请,我批准后才能给我发消息。这种情况下,就需要启用环信提供的好友体系。 | + | 所谓好友体系,是指谁是谁的好友的关系体系。环信提供好友体系,但不是必须使用的。 |
==== 服务器端集成 ==== | ==== 服务器端集成 ==== | ||
行 69: | 行 68: | ||
<WRAP group> | <WRAP group> | ||
<WRAP half column> | <WRAP half column> | ||
- | 上一章:[[im:extensions:value:rtmsgcallback|增值服务]] | + | 上一页:[[im:other:integrationcases:robmic|抢麦模式]] |
</WRAP> | </WRAP> | ||