集成 Jira
与 Jira 集成以跟踪问题,并获取任何设备、内部网或信使上任务的自动更新。
使用以下过程启用与 Jira 的集成。完成此过程后,您的现有审核日志记录级别将持续存在,包括使用 Citrix 微应用执行的任何操作。
有关现成的 Jira 微应用的完整列表,请参阅使用 Jira 微应用。
检查必备项
要通过此集成使用的所有用户帐户必须在设置为任何人的帐户设置中对其电子邮件具有可见性。这意味着服务帐户以及用户通过 OAuth 登录到 Citrix Workspace 的帐户。导航到 https://id.atlassian.com/manage-profile/profile-and-visibility,如果需要,请登录,在联系人部分和电子邮件帐户旁边选择谁可以看到此内容? 菜单下的任何人。
在 Jira 中准备此集成后,您将需要这些工件在 Citrix Workspace 微应用中添加集成:
- URL
- 用户名
- 密码 - 将集成添加到 Citrix Workspace 微应用时,必须输入 API 令牌作为密码
- 身份验证方法(凭据或 OAuth2)
对于 OAuth 2.0,您还需要:
- 客户端 ID
- 客户端密钥
注意: 建议您始终使用 OAuth 2.0 作为服务身份验证方法(如果可用)。OAuth 2.0 可确保您的集成符合您配置的微应用的最大安全合规性。
在开始集成过程之前,必须满足以下必备条件:
-
具有浏览项目访问您要管理的 Jira 项目的专用用户帐户。
有关管理用户的详细信息,请参阅https://www.atlassian.com/software/jira/guides#ManagingUsers-Addingusers。
有关如何将用户添加到 Jira 项目的权限方案的详细信息,请参阅管理项目权限。
-
将 Citrix Gateway 配置为支持 Jira 的单点登录,以便在用户登录后,他们将自动重新登录,而无需再次输入凭据。请按照 Jira 单点登录配置 中的说明进行操作。有关配置 SSO 的详细信息,请参阅Citrix Gateway 服务。
启用 OAuth 2.0(3LO)
在实现 OAuth 2.0 (3LO) 之前,您需要在 Jira 应用管理中为您的应用启用它。
- 导航到 应用程序管理。
- 创建新应用程序,方法是选择创建新应用程序,输入名称,同意条款,然后选择创建。
- 复制客户端 ID 和密码以供以后使用
- 在侧面导航的 API 和功能部分,单击 + 添加
- 在 API 和功能页面的“功能”部分中,找到 OAuth 2.0 (3LO),选择添加,然后选择配置。
- 输入回调 URL。将此 URL 设置为应用程序可访问的任何 URL。 当您在应用程序中实现 OAuth 2.0 (3LO) 时(请参阅下一节),redirect_uri 必须匹配此 URL。
- 单击“保存更改”。
您的屏幕将如下所示:
创建 API 令牌
脚本或其他进程可以使用 API 令牌对 Jira Cloud 应用程序或 Confluence Cloud 执行基本身份验证。如果您使用身份验证的 Atlassian 账户启用了两步验证,则必须使用 API 令牌。如果您使用 API 令牌 登录,请直接转到 API 令牌页面和步骤 3。
- 单击左下角的用户配置文件。
- 选择配置文件 > 管理您的帐户 > 安全 > 创建和管理 API 令牌。
- 选择创建 API 令牌,然后在标签字段中输入令牌的名称。
- 复制到剪贴板并保存以备以后使用。
将集成添加到 Citrix Workspace 微应用时,必须输入 API 令牌作为密码。
添加 Jira 平台 REST API
如果您尚未添加 Jira 平台 REST API,请立即执行此操作。
- 在侧面导航的 API 和功能部分中,单击 + 添加。
- 在 API 和功能页面的 API 部分中,找到 OAuth 2.0 (3LO) ,选择添加,然后选择配置。
- 为您的应用添加所需的范围。
设置检索问题的持续时间
设置要在 Jira 中检索问题的持续时间。将集成添加到 Citrix Workspace 微应用时,可以通过应用负载过滤器来限制集成从 Jira 检索的数据量。
-
使用您的专用帐户和密码登录 Jira。
注意:
如果您使用的是现有帐户,则用户名不是该帐户的电子邮件。要查找帐户的用户名,请登录到您的 Jira 实例,选择配置文件缩略图,选择配置文件。
-
输入要检索的问题天数。
默认值:90 天。
添加回调 URL
向您的实例配置添加自定义 URL,以授予对私有数据的访问权限并启用OAuth 身份验证的用户操作。要查找您的微应用服务器 URL,请登录到 Citrix Cloud,然后选择微应用磁贴。在 URL 栏中,复制 URL 的第一部分。这是您的微应用服务器 URL。该部分 {yourmicroappserverurl}
由租户部分、区域部分和环境部分组成:https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com
。
以管理员身份登录 Jira,并为此集成添加以下授权的重定向 URL:
https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback
将集成添加到 Citrix Workspace 微应用
将 Jira 集成添加到 Citrix Workspace 微应用以连接到您的应用程序。这样可以提供现成的微应用,以及可以在 Workspace 内使用的预配置通知和操作。
请按照以下步骤进行操作:
-
从概览页面中,选择开始。
此时将打开“管理集成”页面。
- 选择添加新集成,然后选择从 Citrix 提供的模板中添加新集成。
- 选择要添加的 Jira 磁贴。
-
输入集成的名称。
- 输入作为必备条件收集的连接器参数。
- 输入您的 URL。
-
输入您的服务验证用户名和密码。
注意:
将集成添加到 Citrix Workspace 微应用时,输入上一步中收集的 API 令牌作为密码。
- 选择身份验证方法。使用 OAuth 2.0 安全协议为委派访问生成请求/授权令牌。
- 凭据 -凭据使用客户端的凭据。
- Oauth 2.0 - 输入您在必备条件过程中收集的 OAuth 客户端 ID 和 OAuth 客户端密钥。
- 选择要加载的更改票证周数。
- 选择添加。
微应用集成页面将打开,其中包含您添加的集成及其微应用。在这里,您可以添加另一个集成,继续设置现成的微应用,或者为此集成创建一个新的微应用。
现在,您可以设置和运行第一个数据同步。由于可以将大量数据从集成应用程序提取到 微应用平台,因此我们建议您使用表页面筛选第一次数据同步的实体,以加快同步速度。
有关详细信息,请参阅“配置集成”文章中的验证所需实体和设置数据同步。
有关 API 端点和表实体的更多详细信息,请参阅Jira 连接器规格。
使用 Jira 微应用
现有的应用程序集成带有现成的微应用。从这些微应用开始,并根据您的需求定制它们。
我们的 Jira 集成带有以下预配置的现成微应用:
创建票证: 创建一个包含详细信息的新 Jira 票证。
通知或页面 | 用例工作流 |
---|---|
“创建票证”页面 | 提供用于创建新的 Jira 票证的窗体,包括选择问题类型、项目和可选的受理人,以及用于添加描述的字段。 |
票证: 查看票证、添加注释、创建子任务以及更改状态和受让人。
通知或页面 | 用例工作流 |
---|---|
评论编辑(已分配票证)通知 | 在分配给用户的现有票证上编辑注释时,他们会在 Workspace 中收到已编辑注释的通知。 |
注释已编辑(已报告)通知 | 在用户报告的现有票证上编辑注释时,他们会收到 Workspace 中编辑注释的通知。 |
新评论(分配票证)通知 | 当新注释添加到分配给用户的现有票证中时,他们会收到通知。 |
“新建评论(已报告的票证)”通知 | 当新注释添加到用户报告的现有票证中时,他们会收到通知。 |
“分配给您的票证(更改)”通知 | 将现有票证分配给用户时,他们会收到通知。 |
“分配给您的票证(新)”通知 | 向用户分配新票证时,他们会收到通知。 |
票证受让人变更(已报告)通知 | 重新分配票证时,票证的报告人会收到通知。 |
票证状态更改(已分配票证)通知 | 当票证的状态发生变化时,票证的受让人会收到通知。 |
“票证状态更改(已报告)”通知 | 当票证状态发生变化时,票证报告员会收到通知。 |
“添加评论”页 | 提供用于向 Jira 票证添加注释的表单。 |
“更改受理人”页 | 提供更改 Jira 票证受让人的表单。 |
“更改状态”页 | 提供用于更改 Jira 票证状态的表单。 |
注释详细信息页面 | 提供含有详细信息的注释的只读视图。 |
“创建子任务”页 | 提供用于创建 Jira 票证子任务的窗体。 |
“票证详细信息”页面 | 提供包含详细信息的 Jira 票证的只读视图。 |
票证页面 | 允许用户搜索分配给他们、由他们报告或他们评论过的 Jira 票证。 |