> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 项目管理

> 将 Alforse 连接到 Linear 或 Jira，使质量措施任务和变更通知作为问题在工程团队自己的工具中被跟踪，并让状态、负责人和备注双向保持一致。

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

## 关联如何工作

每项集成按公司在 **设置 → 集成** 下启用，两者都出现在 **项目管理** 类别中。连接之后，你可以将措施任务或变更通知关联到一个问题，Alforse 会让这两条记录保持一致。

变更朝两个方向传递，每个方向有各自的连接：

| 方向 | 传递方式 | Linear | Jira |
| - | - | - | - |
| Alforse → 跟踪器 | Alforse 调用跟踪器的 API | API 密钥 | OAuth 授权 |
| 跟踪器 → Alforse | 跟踪器调用 Alforse 的 Webhook URL | Webhook，可选签名密钥 | 可选 Webhook，可选密钥 |

Webhook URL 专属于你的公司，会显示在集成的设置说明中，可直接复制：`/api/webhook/linear/<your company id>` 或 `/api/webhook/jira/<your company id>`。

## 连接 Linear

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

### 在 Linear 中创建 Webhook

在 Linear 中打开 API 设置页面。在 **Webhooks** 下选择 **New Webhook**，为其起一个描述性的标签，并把 Alforse 设置说明中的 Webhook URL 粘贴到 **URL** 字段。Linear 的变更就是通过它到达 Alforse 的。

### 复制签名密钥

保存 Webhook 后，Linear 会在其详情页显示一个 **signing secret**（签名密钥）。把它粘贴到 Alforse 的 **Webhook 签名密钥**（Webhook Signing Secret）中。从此以后，Alforse 只接受由 Linear 签名且不超过一分钟的 Webhook 请求。

### 添加你的 API 密钥

在 Linear 中进入 **Security and access** 并生成一个 API 密钥。把它粘贴到 Alforse 的 **API 密钥** 中。不带 `lin_api` 前缀的密钥会被拒绝，并提示 *"Linear API Key must start with 'lin\_api'"*（Linear API 密钥必须以 'lin\_api' 开头）。

### 关联你的第一个措施任务

将一个不合格品措施任务关联到 Linear 问题。状态、负责人和备注现在会双向同步。

| 设置 | 必填 | 控制内容 |
| - | - | - |
| **API 密钥** | 是 | Alforse 调用 Linear 所用的密钥。必须以 `lin_api` 开头。 |
| **Webhook 签名密钥** | 否 | 设置后，Alforse 会拒绝任何未携带有效 Linear 签名的 Webhook 请求。 |

## 连接 Jira

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

### 授权 Alforse

选择 **连接**，并使用你的 Atlassian 账户授权 Alforse。

### 在 Jira 中创建 Webhook（可选）

Webhook 可让 Alforse 实时接收 Jira 的变更。要添加，请在 Jira 中进入 **System → WebHooks**，使用 Alforse 设置说明中的 URL 创建 Webhook，并订阅 **Issue updated** 和 **Issue deleted**。

### 共享密钥

在 Jira Webhook 的 **Secret** 字段中，输入一个较长的随机值，或让 Jira 自动生成。把同一个值粘贴到 Alforse 的 **Webhook 密钥**（Webhook Secret）中，这样 Alforse 只会接受由 Jira 签名的请求。

### 关联你的第一个措施任务

将一个不合格品措施任务关联到 Jira 问题。状态、负责人和备注现在会双向同步。

| 设置 | 必填 | 控制内容 |
| - | - | - |
| **Webhook 密钥** | 否 | 设置后，Alforse 会拒绝任何未携带有效 Jira 签名的 Webhook 请求。 |

## 保护 Webhook 安全

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

HEADS UP

**为每个 Webhook 设置密钥**

请把签名密钥视为设置的一部分，而不是额外选项。Webhook URL 只包含你的公司 ID，因此只要有人得知它，就可以向其发送请求，除非已设置密钥。

## 故障排查

### "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 中重新保存。

## 相关内容

**质量**

这些集成将其措施任务交给工程团队的不合格品。

[Open](https://docs.alforse.com/zh/docs/reference/quality.md)

**集成**

如何查找、安装和配置任何集成。

[Open](https://docs.alforse.com/zh/docs/integrations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.