喧喧集成 分享链接

作者:先知 最后编辑:苏萌 于 2023-12-20 09:00:10 浏览量:18873

说明:本文档仅适用于禅道10.2版本至10.6版本。

禅道11.0版本,新增了客户端集成功能,禅道深度与客户端集成,带了更好的信息共享和沟通协作的便捷体验。

禅道11.0及以上版本下载:http://www.zentao.net/download.html

禅道客户端集成文档:http://www.zentao.net/book/zentaopmshelp/302.html

禅道开源版10.2版本,新增了喧喧集成功能。

禅道和喧喧集成后,禅道是喧喧的服务器端,可使用禅道的用户名和密码登录喧喧。后面将逐步完善禅道集成喧喧的功能,增加其他信息的共享功能。

喧喧是一款免费、开源、安全、跨平台的企业即时通讯工具。

喧喧官网:http://xuan.im

下面我们来介绍一下具体的喧喧集成步骤。

一、下载安装禅道、喧喧客户端、喧喧xxd服务器

1、禅道开源版10.2以上版本下载地址:http://www.zentao.net/download.html

2、喧喧2.0.0以上版本客户端下载地址:https://xuan.im/page/download.html

3、喧喧2.0.0以上版本xxd服务器下载地址:https://xuan.im/page/download.html

二、喧喧集成

下面以windows的版本为示例,介绍具体的喧喧集成步骤。

1、安装禅道开源版10.2以上版本,并保证禅道可以正常使用和访问。

备注:

如果你使用的是禅道windows一键安装包,那么禅道运行控制面板里是否启用 Apache用户访问验证,这一项必须关闭掉,否则喧喧客户端登录不上。

禅道windows一键安装包,Apache用户访问验证默认是开启的,记得一定要手动关闭,不勾选即可。

到禅道后台---喧喧集成,查看喧喧的设置。

具体需要注意的是密钥,默认的密钥是32位的8。安全建议,请点击重新生成密钥,生成新的密钥。

注:禅道10.6后,喧喧集成设置位置做了调整,由原来的后台——喧喧集成改为后台——集成——喧喧集成

2、到喧喧的xxd服务器里,修改配置文件。

xxd服务器的windows版本,下载后解压会有两个文件: config 和 xxd.exe。

我们要修改的是config文件夹里的xxd.conf文件。

可以根据实际情况,阅读注释来修改。

需要注意:

1、禅道集成喧喧,那么禅道是喧喧的默认的唯一服务器。那么服务器的配置里,必须加上default。

2、服务器的配置里的密钥,必须和禅道后台--喧喧集成里的密钥一致。

3、服务器的名称,就是你访问禅道的地址。

例如:我本地访问禅道的地址为:http://127.0.0.1/zentao

示例为:localhost=http://127.0.0.1/xxb/xuanxuan.php,88888888888888888888888888888888

那么我的实际配置为:xuanxuan=http:127.0.0.1/zentao/xuanxuan.php,myanris5vpthvvghuo33mtqepxqs3eq7,default

配置完成后,保存,并启动xxd.exe。

三、登录喧喧客户端

使用禅道的用户名和密码登录喧喧。

登录页面的服务器端地址就是xxd的监听地址。

备注:

1、禅道和xxd,在同一服务器,服务器地址写禅道访问地址也没问题。

2、禅道和xxd,不在同一服务器,服务器地址必须写xxd的监听地址。

3、监听地址为内网地址,但连接时要用外网IP连接。那么服务器地址要写外网地址。

4、云主机外网一定要在防火墙开放11444和11443的监听端口访问。

登录成功后,即可使用喧喧和小伙伴们即时沟通了。

禅道和喧喧集成成功后,用户名和密码是共用的,禅道是喧喧的服务器端。

喧喧和禅道的其他信息和内容的共享,将会逐步开发,敬请期待。

四、注意事项

1、添加xuanxuan.php和upgradexuanxuan.php的解析

如果你是从禅道10.2以下的windows一键安装包(linux一键安装包)版本升级到10.2以上版本的,你需要在服务器的配置里加上针对xuanxuan.php和upgradexuanxuan.php的解析。

windows一键安装包:

在 xampp/runner/res/apache/conf/httpd.conf文件中setting for zentaopms和setting for zentaopro里加上以下代码。

如果你用的是禅道企业版,需要在setting for zentaobiz里加上这段代码。

加上代码后,保存,并重启禅道服务。

<Files "xuanxuan.php">
    SetHandler application/x-httpd-php
  </Files>
  <Files "upgradexuanxuan.php">
    SetHandler application/x-httpd-php
  </Files>

linux一键安装包:

 /opt/zbox/etc/apache/httpd.conf 文件中的setting for zentaopms和setting for zentaopro里加上以下代码。

如果你用的是禅道企业版,需要在setting for zentaobiz里加上这段代码。

加上代码后,保存,并重启禅道服务。

<Files "xuanxuan.php">
    SetHandler application/x-httpd-php
  </Files>
  <Files "upgradexuanxuan.php">
    SetHandler application/x-httpd-php
  </Files>

2、关闭windows一键安装包的Apache用户访问验证

如果你使用的是禅道windows一键安装包,那么禅道运行控制面板里是否启用Apache用户访问验证,这一项必须关闭掉,否则喧喧客户端登录不上。

禅道windows一键安装包,Apache用户访问验证默认是开启的,记得一定要手动关闭,不勾选即可。

3、禅道用户名和密码登录喧喧失败

如果配置好喧喧集成后,使用禅道用户名和密码登录喧喧失败。

3.1请先逐一排查禅道、喧喧、喧喧xxd是否都正常运行。

3.2禅道、喧喧、喧喧xxd都运行正常的话,需要检查xxd.conf的配置。服务器名是否写对,密钥是否一致,是否加上了default。

3.3服务器操作失败,提示500错误,请先到后台--集成--喧喧集成里查看喧喧配置里是否是打开状态。

4、其他问题

可以评论留言,论坛反馈,禅道问答,加我们的技术支持QQ群提问。

4.1论坛反馈:http://www.zentao.net/forum/feedback.html

4.2加技术支持QQ群提问:http://www.zentao.net/book/zentaopmshelp/70.html

4.3禅道问答:http://www.zentao.net/ask