> ## 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 簽署密鑰**。從此，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 密鑰**，讓 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'"（Linear API 金鑰必須以 '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-Hant/docs/reference/quality.md)

**整合**

如何尋找、安裝與設定任何整合。

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


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