通过阅读此文，你可了解如何在飞书上配置 Jira 大师并与 Jira Software Server 建立连接，以便你的团队可在飞书内直接查看、创建与管理 Jira 问题。

一、功能简介

•关于 Jira Software Server

Jira 是 Atlassian 公司开发的项目与问题追踪工具，被广泛用于软件问题追踪和敏捷项目管理等工作领域。Jira Software Server 是 Jira 的一个版本，由企业通过本地私有化部署的方式进行使用。

•关于 Jira 大师

Jira 大师是飞书团队开发的实用工具。通过 Jira 大师，你可以实现飞书与 Jira 的结合，可以在飞书中第一时间获取所有开发动态，让跟踪管理、沟通交流更顺畅。

二、配置前提

•配置流程必须在电脑上操作

•请确认你的企业所使用的 Jira 服务支持外网访问

•IP 白名单配置：若企业 Jira 外网不可访问，可设置 IP 白名单允许 Jira 大师访问企业私有Jira 系统，可用的 IP 出口地址如下:

◦220.243.131.248

◦220.243.131.249

◦123.58.10.224

◦123.58.10.225

三、配置流程

注：使用前必须完成配置。未配置的情况下打开会报错。

1. 进入 Jira 大师管理后台

在飞书管理后台的工作台 > 应用列表内找到应用 Jira 大师。进入应用详情页，点击打开管理后台进行配置。

2. 建立企业 Jira 地址与 Jira 大师的连接

•在管理后台中，点击左侧的连接 Jira

•在企业 Jira 地址填入企业内使用的 Jira 网址，格式是一个以“https://”开头的链接

•在 Jira 产品类别中选择 Jira Software Server

•确认地址无误后选择下一步

3. 配置应用程序链接

•进入企业 Jira 的设置管理页面

•复制页面中的 Jira 大师地址

•如示例图所示，打开企业 Jira 并创建新的应用程序链接，将复制下来的链接粘贴到相应的区域，然后点击继续

备注：

1.不同的 Jira 版本中，配置应用程序链接的具体操作路径或有差异，本文和应用界面中所提供的路径仅供参考

2.关于如何在企业 Jira 中创建应用程序的链接，详见下文“应用程序链接设置页面”部分

•回到 Jira 大师管理后台页面，点击 下一步

4. 填写 Jira 连接应用程序表单

•在 Jira 大师管理后台中，复制应用程序名称 Jira Master

•按照示例图中的提示，在企业 Jira 网页中的对应位置应用程序名称中粘贴上一步中复制的内容

•在应用类型中选择通用应用，勾选创建进入的连接，并点击继续

•操作成功后，回到 Jira 大师管理后台页面，点击下一步

5. 在 Jira 中录入应用程序的安全数据

•按照示例图的提示，分别将 Jira 大师管理后台页面中的消费方标识键、消费方名称和公钥复制并粘贴到企业 Jira 配置界面对应的位置（备注：不同的Jira版本中，具体的字段名称或有差异。请结合实际情况进行填写）

•点击继续，即可看到企业 Jira 配置页面出现处理中的提示，之后企业 Jira 的连接就配置完成了

•在 Jira 大师管理后台中点击下一步

6. 完成配置流程

•在 Jira 大师管理后台中，点击保存连接

•依照提示，在弹出的 Jira 页面中点击允许，完成整个流程配置

四、应用程序链接设置页面

下面将介绍如何通过 Jira 操作进入应用程序链接的设置页面。

1. 进入企业 Jira 网址，点击右上角的设置按钮

2. 选择产品 > 集成 > 应用程序链接

3. 填入 Jira 大师管理后台提供的 URL 链接

4. 点击创建新的链接即可

五、获取配置 webhook 的 URL

在 Jira 大师管理后台的左侧导航栏中，点击配置通知。此处的 webHook URL 即为在 Jira 中配置 webhook 时填入的 URL。关于如何在 Jira 中配置 webhook，详见 Jira 官方文档

六、常见问题

问：Jira 大师配置失败的常见原因有哪些？

答：

•Jira 地址填写有误。正确的填写方式为：https://jira.company.com；常见的错误填写方式如：https://jira.company.com/secure/Dashboard.jspa

•在重新配置过程中没有同步删除 Jira 端的公钥。Jira 大师配置过程实际为配置公私钥的过程，假如要重新配置，则需要 Jira 大师端和 Jira 服务端同时删除匹配的公私钥。

•Jira服务器的时间设置错误。请检查你的Jira服务器时间，并校准为与网络时间一致。

关联阅读

•如何使用 Jira 大师

•配置 Jira 大师（Jira Software Cloud 版）

•如何在文档中插入 Jira 过滤器？

•如何解除个人账户与 Jira 大师的绑定？