プロジェクト管理

プロジェクト管理連携は、Alforse で始まった作業を Linear または Jira の課題に結び付けます。品質チームはこれを使って、のアクションタスクや変更通知を再入力なしでエンジニアリングに引き渡します。ステータス、担当者、メモは双方向で同期されます。

​

連携のしくみ

各連携は設定 → 連携で会社ごとにオンにします。どちらもプロジェクト管理カテゴリに表示されます。接続後、アクションタスクまたは変更通知を課題にリンクすると、Alforse が 2 つのレコードの整合を保ちます。 変更は 2 つの方向に伝わり、方向ごとに別々の接続を使います。 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 に保存し直します。

​

関連