tigase开发指南

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

2、件配置启动组件：修改 pertiesmessage-router/components/msg-receivers/id-namess=bosh,cl-comp, eventbus, s2s,sess-man插件如下表格所示，红字的插件说明:Word 资料.tigas 插件说明参数说明jabber:iq:register注册服务message-archive-xep-0136消息归档jabber:iq:auth简单用户认证urn:ietf:params:xml:ns:xmpp-saslSASL协商urn:ietf:params:xml:ns:xmpp-bind资源绑定urn:i

3、etf:params:xml:ns:xmpp-sessionsession 绑定jabber:iq:roster联系人管理presence-statexmpp 顶级元素，上线广播jabber:iq:privacy隐身协议jabber:iq:version客户端版本/protocol/stats是否发送统计信息，指向 发送startlstls 加密msgoffline离线消息vcard-temp临时的 vCard/protocol/commands管理 virtual domains 的特别命令jabber:iq

4、: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)服务发现配置文件配置启动组件：修改 pertiessess-man/pluginss= session-close, session-open, default-

5、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, jabber:iq:privacy, jabber:iq:version, /protocol/stats, starttls, vcard-temp,Word 资料./protocol/commands,jabber:iq:private, urn:xmpp:ping,

6、 amp , disco,domain-filter,zlib, message-carbons, vcard-xep-0292,urn:xmpp:timeTigase 数据库表Tigase 用户信息、权限信息、离线消息信息、在线离线状态信息都存储在数据库中，但有些数据我们不需要让tigagse 存储、更新，比如在线离线状态信息，如果每个用户登录、登出都让 tigase 更新表的字段，并发高了，显然数据库承受不了。为了避免资源浪费也需要避免这些操作。登录状态上线更新上线状态更新是在验证用户名和密码时更新，验证功能是需要我们自定义的，仅需修改tigase 验证模块的一小块代码即可。下图贴出tig

7、ase 源码修改方式。登录状态下线更新下线状态更新是在用户退出、连接断开等时更新，修改代码也比较简单。Word 资料.tigase 权限验证云果登陆流程时需要验证权限，权限验证需要分匿名用户和企业客服两种，匿名用户默认验证都可以通过，企业客服需要验证是否在用户中心登陆成功。企业客服登陆1.登陆用户中心，登陆成功后，用户中心会保存cookieid 至缓存中2.带着用户名、 cookieid 同 tigase 服务端建立连接3.从缓存中获取验证信息4.如果认证通过和 tigase 连接上tigase 的验证是需要我们自定义开发的，只需要在tigase 权限验证模块修改即可。Word 资料.tiga

8、se 在线坐席获取匿名用户登陆需要根据客户名分配一个在线坐席会话。tigase roster 插件是用于返回好友列表，可以修改用来分配坐席列表。插件的调用是在SessionManager 中调用：客户端获取好友列表：var iq = $iq(type: 'get',id: 'getmyroster'.tree();connection.send(iq);Word 资料.tigase 消息转发流程用户在发消息给客服时，如果客服不在线，需要分配给机器人客服，机器人客服是以tigase 客户端方式使用的，并且为了负载均衡会有多个机器人客服，所以还需要分配。分配这块功能

9、需要修改tigase sessionmanage 组件处理消息模块的一段代码。Tigase 所有的消息都会经sessionmanager 进行处理。Packet 类中没有 setStanzaTo 方法需要修改加入Word 资料.tigase 离线消息存储tigase 在用户不在线时，会把消息存储在数据库中，默认是关系型数据库，这块我们是需要存储到hbase 等 nosql 数据库中的，这块功能需要修改下源码tigase 已经写好的离线消息插件。此外 tigase 默认的离线消息存储是有条数限制的，需要修改配置文件tigase 用户连接断开通知客服client 与 server 连接断开， Se

10、ssionManager 会接收到断开消息，会话断开是通过SessionCloseProc插件实现。断开通知客服需要在连接断开时，发一条消息给客服JID 通知。Word 资料.Packet 类中没有 setStanzaTo 方法需要修改加入Word 资料.tigase 组件插件开发tigase 组件插件开发，官方开发文档有详细介绍，可直接阅读tigase-DevelopmentGuide.pd，已上传上传到svn。云果以后需要自定义一些组件、插件实现自定义功能。tigase 配置文件云果基于 tigase 源码开发功能时，需要增加一些自定义的配置，关于配置文件模块，tigase 是作为一个组件

11、开发的，所以我们仅需要简单修改一下配置文件模块。tigase sslSSL(Secure Sockets Layer 安全套接层 ),及其继任者传输层安全（Transport Layer Security ，TLS）是为网络通信提供安全及数据完整性的一种安全协议。TLS 与 SSL在传输层对网络连接进行加密。Tigase 支持 ssl 通信功能，底层使用NIO+JSSE 实现。1. 启用 ssl修改 perties ，增加配置-bosh-ports=5280,5281bosh/connections/5281/socket=sslbosh/connections/5281/ty

12、pe=accept注： 5280 端口号用于正常通信，5281 端口号用于ssl 通信Word 资料.2. js 连接 tigase ssl由原来的访问地址http:/ip:5280改为 https:/ip:5281即可正常访问。注：由于 https 请求浏览器需要可信证书才允许访问，否则会拒绝访问，需要把访问的https 地址设置为可信才能访问或者加入可信证书。导入pem 文件至浏览器下面3 会介绍。3. ssl 证书tigase 发布的包解压后 ,在 certs/ 目录中包含了密钥和证书，其中后缀名位.pem 是 ssl 钥匙包含了公钥和私钥匙， tigase 启动时会为每个 domain

13、 生成一个 domain.pem 文件 ,如果不配置 domain 使用 default.pem 文件。 pem 文件也可以使用 openssl 生成，上线系统建议自己生成。pem 文件可以导入至浏览器证书中，这样浏览器才不会禁止你的https 请求。证书如下所示：注：上线系统外网使用ssl 一般采用第三方的收费的商用证书，客户端导入证书非常shan 麻烦，浏览器部会有一些CA ROOT 证书，一般包含了常用的商用证书。tigase 负载均衡Tigase 从版开始，引入了负载均衡功能，可以把终端访问用户重定向到最适合的集群节点上。此负载均衡功能依赖于see-other-host的 XMPP 流

14、错误消息（ stream error message）。此机制背后的基本原则是如果用户当前正尝试连接的节点与返回消息的节点不是集群中的同一个节点，那么用户将被重定向。此原则需要获得用户的JID 实现重定向。一、可用的实现此 Tigase 的实现跟其他实现一样，是可扩展的，支持不同的、可插拨的重定向策略，实现了SeeOtherHostIfc 接口。当前有三种可用的策略：1） SeeOtherHost 策略此策略是最基本的实现，它会返回perties配置文件中的单个主机名或当前的主机名。Word 资料.2） SeeOtherHostHashed 策略这是 Tigase 默认使用的策

15、略，它对用户的JID 值的进行哈希计算，根据哈希值来把终端连接重定向到 SeeOtherHostIfc 的集群环境中的节点。所有有效的节点是根据默认的集群组成和所有连接到集群并工作的节点共同决定，也可以把所有的节点配置到perties中。3） SeeOtherHostDB 策略此策略是 SeeOtherHost 策略的扩展实现，它根据Tigase 数据库的 user_id 和 node_id 配对的形式来决定终端用户应该被重定向到哪一个节点。二、配置选项下面是实际的负载均衡重定向最基本的相关配置：cm-see-other-host=它可能的值包括：none - disables

16、 redirection说明：前三行为三种重定向策略，最后一种是不使用重定向策略。其余的所有选项都是以连接管理器per-connection-manager为基础进行配置的，因此这些选项都需要加上相应的连接管理器ID 作为前缀，比如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 策略附加的选项包括：Word 资料LVS 负载均衡器实现负载功能。.c2s/cm-see-other-host/db-urlJDBC 连接的 URI，用于查询重定向信息；如果没有配置，那么会使用user-db-uri的值。c2s/cm-see-other-host/get-host-querySQL 查询语句