喧喧集成 分享链接

说明：本文档仅适用于禅道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