跳转到主要内容
项目管理集成把始于 Alforse 的工作与 Linear 或 Jira 中的问题关联起来。质量团队用它把的措施任务和变更通知交给工程团队,而无需重新录入;状态、负责人和备注随后会双向保持一致。

关联如何工作

每项集成按公司在 设置 → 集成 下启用,两者都出现在 项目管理 类别中。连接之后,你可以将措施任务或变更通知关联到一个问题,Alforse 会让这两条记录保持一致。 变更朝两个方向传递,每个方向有各自的连接: Webhook URL 专属于你的公司,会显示在集成的设置说明中,可直接复制:/api/webhook/linear/<your company id> 或 /api/webhook/jira/<your company id>。

连接 Linear

Linear 使用 API 密钥进行身份验证,密钥必须以 lin_api 开头。

连接 Jira

Jira 通过 OAuth 连接,因此无需粘贴密钥。唯一的设置是可选的 Webhook 密钥。

保护 Webhook 安全

两个密钥都是可选的,以便在签名功能出现之前设置的集成继续工作。这种兼容性是有代价的:没有保存密钥时,Alforse 无法区分来自 Linear 或 Jira 的真实请求与发送到同一 URL 的伪造请求。

故障排查

”Linear API Key must start with ‘lin_api’”

原因: API 密钥 中的值不是 Linear 个人 API 密钥,或者粘贴时缺少字符。解决办法: 在 Linear 的 Security and access 下生成新密钥并完整粘贴。

在 Jira 中所做的更改没有出现在 Alforse 中

原因: 没有 Jira Webhook,或者它没有订阅正确的事件。解决办法: 在 System → WebHooks 下使用 Alforse 设置说明中的 URL 创建 Webhook,并订阅 Issue updated 和 Issue deleted。

添加密钥后 Webhook 请求被拒绝

原因: Alforse 中保存的密钥与跟踪器中的不一致,因此签名无法通过验证。解决办法: 从 Linear 的 Webhook 详情页或 Jira Webhook 的 Secret 字段复制密钥,并在 Alforse 中重新保存。

相关内容