> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corgea.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Linear
> CorgeaでLinear連携を設定する方法
CorgeaのLinear連携により、コードベースや依存関係で見つかったセキュリティ上の問題に対して自動的にLinear問題を作成できます。この連携により、既存のLinearワークフロー内でのセキュリティ脆弱性の追跡と管理プロセスが効率化されます。
## 前提条件
Linear連携を設定する前に、次の要件を確認してください。
* アクセス可能なLinearワークスペース
* Linearの**Settings > API**で作成した個人APIキー（[Linear APIキーの作成方法](https://linear.app/docs/api-and-webhooks)）
* Corgeaで連携を追加、編集、削除するための**Manage Integrations**権限と、設定済みの連携を表示するための**View Integrations**権限（[権限グループ](/ja/permission_groups)を参照）
Linearの個人APIキーには、ワークスペース内でキー作成者が持つ権限が継承されます。Corgeaに付与する権限と一致するアカウントでキーを作成してください。Corgeaはキーを暗号化して保存し、保存後に再表示することはありません。
サポートされているのは個人用APIキーのみです。OAuthは現在利用できません。
Linear連携はスタータープラン以上で利用可能です。無料プランでは、CorgeaはLinear連携ページを開く代わりにアップグレードを促します。
## 連携の設定
Corgeaアカウントにログインして**Integrations**ページに移動し、**Ticketing Integrations**で**Linear**を見つけます。
**Add**をクリックしてLinear連携ページを開きます。連携を1つ以上設定すると、このボタンは**Edit**に変わり、設定済みの件数が表示されます。
**Add Integration**をクリックし、次の情報を入力します。
* **Name**:連携を識別しやすい名前（例:「My Linear Workspace」）
* **API Key**:Linearの個人APIキー
* **Team Default**（任意）:問題作成時に事前選択するLinearチームのID
* **Project Default**（任意）:問題作成時に事前選択するLinearプロジェクトのID
どちらのデフォルトにも、名前ではなくLinear IDを指定します。チケット作成時に毎回チームとプロジェクトを選択する場合は、空欄にします。
**Save**をクリックして連携設定を完了します。Corgeaは保存前にLinearでAPIキーを検証するため、無効なキーは即座に拒否され、設定は保存されません。
## Linear問題の作成
Corgeaでコードの問題または依存関係の問題に移動し、問題の詳細ページを開きます。
問題のサイドバーで、道標アイコンのボタン（ツールチップ:**Create Linear Ticket**）を選択します。JIRAも接続している場合は、JIRAのボタンが隣に表示されます。
チケットの作成先となる連携を選択し、次にチームを選択します。連携設定でチームとプロジェクトのデフォルト値を指定していない場合は、ここで指定します。Corgeaがチームを自動取得し、チームを選択すると、そのチームのプロジェクトが読み込まれます。
プロジェクトは任意です。**No project**を選択すると、プロジェクトを指定せずにチームへ問題を作成できます。また、選択済みのプロジェクトを解除する場合にも使用します。
**Create Ticket**ボタンをクリックします。Corgeaが関連情報を含む新しいLinear問題を作成します。
新しいLinear問題が別のブラウザタブで開き、Corgeaに確認通知が表示されます。その後、問題の詳細ページにLinear問題への**View Ticket**リンクが表示されます。
チケットを作成すると、検出結果の説明、ファイルパス、修正案がLinearに送信されます。そのため、チケット作成には検出結果自体と同じアクセス制御が適用され、検出結果の表示権限と、その検出結果が属するプロジェクトへのアクセス権が必要です。Corgeaで検出結果を開けない場合は、Linear問題を作成できません。
CorgeaからLinearに接続できない場合や、APIキーに問題作成権限がない場合は、ダイアログにエラーが表示され、チケットは記録されません。
Linearで問題が作成されたものの、Corgeaから検出結果にリンクできない場合、ダイアログに**Open in Linear**リンクが表示されます。再試行による重複作成を防ぐため、**Create Ticket**は無効になります。Linear問題を確認したら、問題の詳細ページを再読み込みしてください。
Corgeaがチームやプロジェクトを読み込んでいる間も**Create Ticket**は無効です。そのため、デフォルトプロジェクトが適用される前にチケットが作成されることはありません。
## Linearの問題の詳細カスタマイズ
デフォルトで、CorgeaはLinear問題に以下の情報を表示します。
* **タイトル**:
* コード問題:問題分類とファイル位置
* 依存関係の問題:CVE、影響を受けたパッケージ、影響を受けたバージョン
* **説明**:
* 脆弱性の詳細(場所/パッケージ、カテゴリ、重大度)
* 問題の説明
* 修正案。Corgeaが生成した場合はコード差分も含まれます。長い差分は省略され、修正がない場合は「Corgea couldn't generate an auto-fix」と表示されます
* プロジェクト情報:プロジェクト名、スキャンID、スキャン日(コード問題)
* 参照先:MITREのCWEエントリ、CorgeaのCWEデータベース、利用可能な場合はGitHubまたはGitLab上の該当ファイルへのリンク（コードの問題）
* Corgeaの問題詳細ページへのリンク
説明はMarkdownで書かれているため、Linearは見出し、リンク、差分ブロックをネイティブにレンダリングします。
追加フィールドが必要な場合や問題の詳細をカスタマイズする場合は、作成後にLinearワークスペースで問題を編集できます。
## 複数のLinear連携を管理
複数のLinearワークスペースがあれば、Corgeaで複数のLinear連携を設定できます。Linear問題を作成する際には、適切な連携を選択するよう求められます。
### 連携の編集
Linear連携ページで、変更したい連携の鉛筆アイコンを選択します。
既存のAPIキーを維持する場合はAPIキー欄を空欄にし、置き換える場合は新しいキーを入力します。Corgeaは保存済みのキーをブラウザに返さないため、この欄には現在の値が表示されず、常に空欄で開きます。
### 連携を削除する
削除したい連携のゴミ箱アイコンを選択してください。
Corgeaは連携名を示す確認画面を表示し、確認後に削除します。連携を削除しても、ワークスペースとCorgeaの接続が解除されるだけで、作成済みのLinear問題はそのまま残ります。
CorgeaをLinearと連携することで、セキュリティ脆弱性管理プロセスを効率化し、既存のワークフロー内で重要な問題を追跡・対処できます。