> ## 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 が 2 つのレコードの整合を保ちます。

変更は 2 つの方向に伝わり、方向ごとに別々の接続を使います。

| 方向 | 伝わり方 | 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 は詳細ページに**署名シークレット**を表示します。それを Alforse の **Webhook署名シークレット**に貼り付けます。以後、Alforse は Linear が署名した、送信から 1 分以内の 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 だけなので、シークレットがなければ、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 に保存し直します。

## 関連

**品質**

これらの連携がエンジニアリングに引き渡す、アクションタスクを持つ不適合です。

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

**連携**

連携の探し方、インストール方法、設定方法です。

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


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