2022年tigase开发指南.pdf

《2022年tigase开发指南.pdf》由会员分享，可在线阅读，更多相关《2022年tigase开发指南.pdf（12页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、tigase开发指南tigase开发指南tigase组件插件配置tigase 启动时会初始化并启动相关组件与插件,启动的组件或开通监听端口号或访问数据库或者创建线程池 ,默认有些组件与插件非必须,我们也用不到 ,为了避免资源浪费 ,需要在配置中注释这些组件。组件如下表格所示 ,红字的组件说明 :tigase 组件说明Amp高级消息处理Bosh提供客户端http 长连接c2s提供客户端tcp 连接cl-comp内置集群组件eventbus事件总线 ,内部处理message-archive消息归档monitor监控muc聊天室proxy代理pubsub发布订阅s2stigase 服务端节点之间交互

2、sess-man会话管理配置文件配置启动组件 : 修改init、properties message-router/components/msg-receivers/id-namess=bosh,cl-comp,eventbus, s2s,sess-man精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 1 页，共 12 页 - - - - - - - - - - tigase开发指南插件如下表格所示 ,红字的插件说明 :tigas 插件说明参数说明jabber:iq:register注册服务message

3、-archive-xep-0136消息归档jabber:iq:auth简单用户认证urn:ietf:params:xml:ns:xmpp-saslSASL 协商urn:ietf:params:xml:ns:xmpp-bind资源绑定urn:ietf:params:xml:ns:xmpp-sessionsession 绑定jabber:iq:roster联系人名单管理presence-statexmpp 顶级元素 ,上线广播jabber:iq:privacy隐身协议jabber:iq:version客户端版本就是否发送统计信息 ,指向 jabber 、org 发送startlstls 加密msg

4、offline离线消息vcard-temp临时的 vCard管理 virtual domains的特别命令jabber:iq:private私有数据存储urn:xmpp:ping心跳检测presence-subscription发布订阅插件domain-filter(basic-filter)domain拦截器amp(basic-filter)高级消息处理zlib(basic-filter)zlib 压缩message-carbons(basic-filter)将 stanzas 投递到用户指定的资源disco(basic-filter)服务发现配置文件配置启动组件 : 修改init、prop

5、erties sess-man/pluginss=session-close,session-open,default-handler, urn:ietf:params:xml:ns:xmpp-sasl,urn:ietf:params:xml:ns:xmpp-bind, urn:ietf:params:xml:ns:xmpp-session,jabber:iq:roster,精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 2 页，共 12 页 - - - - - - - - - - tigase开发指南j

6、abber:iq:privacy, jabber:iq:version, , starttls, vcard-temp, ,jabber:iq:private, urn:xmpp:ping,amp , disco,domain-filter, zlib,message-carbons,vcard-xep-0292,urn:xmpp:timeTigase数据库表Tigase 用户信息、权限信息、离线消息信息、在线离线状态信息都存储在数据库中,但有些数据我们不需要让tigagse 存储、更新 ,比如在线离线状态信息 ,如果每个用户登录、登出都让 tigase 更新表的字段 ,并发高了 ,显然数据库

7、承受不了。为了避免资源浪费也需要避免这些操作。登录状态上线更新上线状态更新就是在验证用户名与密码时更新,验证功能就是需要我们自定义的,仅需修改tigase 验证模块的一小块代码即可。下图贴出tigase 源码修改方式。登录状态下线更新下线状态更新就是在用户退出、连接断开等时更新,修改代码也比较简单。精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 3 页，共 12 页 - - - - - - - - - - tigase开发指南tigase 权限验证云果登陆流程时需要验证权限,权限验证需要分匿名用户与企业客

8、服两种,匿名用户默认验证都可以通过 ,企业客服需要验证就是否在用户中心登陆成功。企业客服登陆1、登陆用户中心 ,登陆成功后 ,用户中心会保存 cookieid 至缓存中2、带着用户名、 cookieid 同 tigase 服务端建立连接3、从缓存中获取验证信息4、如果认证通过与tigase 连接上tigase 的验证就是需要我们自定义开发的,只需要在 tigase 权限验证模块修改即可 。精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 4 页，共 12 页 - - - - - - - - - - tiga

9、se开发指南tigase 在线坐席获取匿名用户登陆需要根据客户名分配一个在线坐席会话。tigase roster 插件就是用于返回好友列表,可以修改用来分配坐席列表。插件的调用就是在SessionManager中调用 : 客户端获取好友列表: var iq = $iq( type: get, id: getmyroster ) 、c(query, xmlns: Strophe、NS、ROSTER) 、tree(); 精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 5 页，共 12 页 - - - - -

10、- - - - - tigase开发指南 connection、send(iq); tigase消息转发流程用户在发消息给客服时,如果客服不在线 ,需要分配给机器人客服,机器人客服就是以tigase 客户端方式使用的 ,并且为了负载均衡会有多个机器人客服,所以还需要分配。分配这块功能需要修改tigase sessionmanage组件处理消息模块的一段代码。Tigase 所有的消息都会经sessionmanager进行处理。Packet 类中没有 setStanzaTo方法需要修改加入精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - -

11、 - - - - - -第 6 页，共 12 页 - - - - - - - - - - tigase开发指南tigase离线消息存储tigase 在用户不在线时,会把消息存储在数据库中,默认就是关系型数据库,这块我们就是需要存储到hbase 等 nosql 数据库中的 ,这块功能需要修改下源码tigase 已经写好的离线消息插件。此外 tigase 默认的离线消息存储就是有条数限制的,需要修改配置文件tigase用户连接断开通知客服client 与 server 连接断开 ,SessionManager会接收到断开消息,会话断开就是通过SessionCloseProc插件实现。断开通知客服需

12、要在连接断开时,发一条消息给客服JID 通知。精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 7 页，共 12 页 - - - - - - - - - - tigase开发指南Packet 类中没有 setStanzaTo方法需要修改加入精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 8 页，共 12 页 - - - - - - - - - - tigase开发指南tigase组件插件开发tigase 组件插件开发

13、,官方开发文档有详细介绍,可直接阅读 tigase-DevelopmentGuide、pd ,已上传上传到 svn。云果以后需要自定义一些组件、插件实现自定义功能。tigase配置文件云果基于 tigase 源码开发功能时,需要增加一些自定义的配置,关于配置文件模块,tigase 就是作为一个组件开发的 ,所以我们仅需要简单修改一下配置文件模块。tigase ssl SSL(Secure Sockets Layer 安全套接层 ),及其继任者传输层安全(Transport Layer Security,TLS)就是为网络通信提供安全及数据完整性的一种安全协议。TLS 与 SSL 在传输层对网络

14、连接进行加密。Tigase 支持 ssl 通信功能 ,底层使用 NIO+JSSE 实现。1、启用 ssl 修改 init、properties, 增加配置-bosh-ports=5280,5281bosh/connections/5281/socket=sslbosh/connections/5281/type= accept注:5280 端口号用于正常通信,5281 端口号用于ssl 通信精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 9 页，共 12 页 - - - - - - - - - - tig

15、ase开发指南2、js 连接 tigase ssl 由原来的访问地址改为即可正常访问。注:由于 https 请求浏览器需要可信证书才允许访问,否则会拒绝访问 ,需要把访问的https 地址设置为可信才能访问或者加入可信证书。导入pem 文件至浏览器下面3 会介绍。3、ssl 证书tigase 发布的包解压后,在 certs/ 目录中包含了密钥与证书,其中后缀名位、 pem 就是 ssl 钥匙包含了公钥与私钥匙 ,tigase 启动时会为每个domain 生成一个 domain 、pem 文件 ,如果不配置 domain 使用default 、pem 文件。 pem 文件也可以使用openssl

16、 生成 ,上线系统建议自己生成。pem 文件可以导入至浏览器证书中,这样浏览器才不会禁止您的https 请求。证书如下所示: 注:上线系统外网使用ssl 一般采用第三方的收费的商用证书,客户端导入证书非常shan 麻烦 ,浏览器内部会有一些CA ROOT 证书 ,一般包含了常用的商用证书。tigase 负载均衡Tigase 从 5、2、0 版开始 ,引入了负载均衡功能,可以把终端访问用户重定向到最适合的集群节点上。此负载均衡功能依赖于see-other-host的 XMPP 流错误消息 (stream error message)。此机制背后的基本原则就是如果用户当前正尝试连接的节点与返回消息

17、的节点不就是集群中的同一个节点,那么用户将被重定向。此原则需要获得用户的JID 实现重定向。一、可用的实现此 Tigase 的实现跟其她实现一样,就是可扩展的 ,支持不同的、可插拨的重定向策略,实现了SeeOtherHostIfc接口。当前有三种可用的策略: 1)SeeOtherHost策略此策略就是最基本的实现,它会返回 init、properties 配置文件中的单个主机名或当前的主机名。精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 10 页，共 12 页 - - - - - - - - - - t

18、igase开发指南2)SeeOtherHostHashed策略这就是 Tigase 默认使用的策略,它对用户的 JID 值的进行哈希计算,根据哈希值来把终端连接重定向到 SeeOtherHostIfc的集群环境中的节点。所有有效的节点就是根据默认的集群组成与所有连接到集群并工作的节点共同决定,也可以把所有的节点配置到init、properties 中。3)SeeOtherHostDB策略此策略就是SeeOtherHost策略的扩展实现 ,它根据 Tigase 数据库的user_id 与 node_id 配对的形式来决定终端用户应该被重定向到哪一个节点。二、配置选项下面就是实际的负载均衡重定向最

19、基本的相关配置: cm-see-other-host= 它可能的值包括 : tigase 、server 、xmppclient 、SeeOtherHost tigase 、server 、xmppclient 、SeeOtherHostHashed tigase 、server 、xmppclient 、SeeOtherHostDB none - disables redirection 说明 :前三行为三种重定向策略,最后一种就是不使用重定向策略。其余的所有选项都就是以连接管理器per-connection-manager为基础进行配置的,因此这些选项都需要加上相应的连接管理器ID 作为前

20、缀 ,比如 c2s、bosh 、ws 的配置 ,下面以 c2s 配置为例 : c2s/cm-see-other-host/default-host=host1;host2;host3 用分号来间隔重定向的主机节点名c2s/cm-see-other-host/active=OPEN;LOGIN 用分号来间隔终端用户可以被重定向的阶段当前可使用的值包括: OPEN 它表示打开XMPP stream期间可以进行重定向LOGIN 它表示在授权认证用户会话期间可以进行重定向Tigase 默认的重定向阶段就是OPEN 阶段。SeeOtherHostDB策略附加的选项包括: 精品资料 - - - 欢迎下载

21、- - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 11 页，共 12 页 - - - - - - - - - - tigase开发指南c2s/cm-see-other-host/db-url JDBC 连接的 URI,用于查询重定向信息;如果没有配置 ,那么会使用user-db-uri 的值。c2s/cm-see-other-host/get-host-query SQL 查询语句 ,它应该能返回重定向的主机名。c2s/cm-see-other-host/get-all-data-query SQL 辅助器查询语句,它能够返回来自数据库所

22、有的重定向数据。c2s/cm-see-other-host/get-all-query-timeout 设置执行查询的超时时间。注:tigase 默认的负载均衡实现比较简单,负载的方式就是客服端向任意服务端请求,服务端内部通过一些负载方式 ,分配一台服务端 ,然后把分配这台服务器连接信息返回给客户端,客户端在连接分配的这台服务端 ,使得客户端多了个一个步骤。建议使用LVS 负载均衡器实现负载功能。精品资料 - - - 欢迎下载 - - - - - - - - - - - 欢迎下载 名师归纳 - - - - - - - - - -第 12 页，共 12 页 - - - - - - - - - -