Skip to main content
CorgeaのLinear連携により、コードベースや依存関係で見つかったセキュリティ上の問題に対して自動的にLinear問題を作成できます。この連携により、既存のLinearワークフロー内でのセキュリティ脆弱性の追跡と管理プロセスが効率化されます。

​
前提条件

Linear連携を設定する前に、次の要件を確認してください。
  • アクセス可能なLinearワークスペース
  • LinearのSettings > APIで作成した個人APIキー（Linear APIキーの作成方法）
  • Corgeaで連携を追加、編集、削除するためのManage Integrations権限と、設定済みの連携を表示するためのView Integrations権限（権限グループを参照）
Linearの個人APIキーには、ワークスペース内でキー作成者が持つ権限が継承されます。Corgeaに付与する権限と一致するアカウントでキーを作成してください。Corgeaはキーを暗号化して保存し、保存後に再表示することはありません。サポートされているのは個人用APIキーのみです。OAuthは現在利用できません。
Linear連携はスタータープラン以上で利用可能です。無料プランでは、CorgeaはLinear連携ページを開く代わりにアップグレードを促します。

​
連携の設定

1

Integrationsページを開く

CorgeaアカウントにログインしてIntegrationsページに移動し、Ticketing IntegrationsでLinearを見つけます。
Ticketing IntegrationsにJIRAと並んで表示されたLinear
2

Linear連携を開く

AddをクリックしてLinear連携ページを開きます。連携を1つ以上設定すると、このボタンはEditに変わり、設定済みの件数が表示されます。
連携を追加する前のLinear連携ページ
3

連携の設定

Add Integrationをクリックし、次の情報を入力します。
  • Name:連携を識別しやすい名前（例:「My Linear Workspace」）
  • API Key:Linearの個人APIキー
  • Team Default（任意）:問題作成時に事前選択するLinearチームのID
  • Project Default（任意）:問題作成時に事前選択するLinearプロジェクトのID
どちらのデフォルトにも、名前ではなくLinear IDを指定します。チケット作成時に毎回チームとプロジェクトを選択する場合は、空欄にします。
Add Linear Integrationダイアログ
4

設定を保存

Saveをクリックして連携設定を完了します。Corgeaは保存前にLinearでAPIキーを検証するため、無効なキーは即座に拒否され、設定は保存されません。
無効なAPIキーエラーを表示するAdd Linear Integrationダイアログ

​
Linear問題の作成

1

問題を開く

Corgeaでコードの問題または依存関係の問題に移動し、問題の詳細ページを開きます。
2

Linearチケット作成画面を開く

問題のサイドバーで、道標アイコンのボタン（ツールチップ:Create Linear Ticket）を選択します。JIRAも接続している場合は、JIRAのボタンが隣に表示されます。
問題のサイドバーにあるCreate Linear Ticketボタン
3

チケットの設定

チケットの作成先となる連携を選択し、次にチームを選択します。連携設定でチームとプロジェクトのデフォルト値を指定していない場合は、ここで指定します。Corgeaがチームを自動取得し、チームを選択すると、そのチームのプロジェクトが読み込まれます。プロジェクトは任意です。No projectを選択すると、プロジェクトを指定せずにチームへ問題を作成できます。また、選択済みのプロジェクトを解除する場合にも使用します。
連携、チーム、プロジェクトの選択欄を含むCreate Linear Ticketダイアログ
4

チケット作成

Create Ticketボタンをクリックします。Corgeaが関連情報を含む新しいLinear問題を作成します。
5

作成確認

新しい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連携ページで、変更したい連携の鉛筆アイコンを選択します。
Linear連携の編集ボタン
既存のAPIキーを維持する場合はAPIキー欄を空欄にし、置き換える場合は新しいキーを入力します。Corgeaは保存済みのキーをブラウザに返さないため、この欄には現在の値が表示されず、常に空欄で開きます。
Linear連携の編集ダイアログ

​
連携を削除する

削除したい連携のゴミ箱アイコンを選択してください。
Linear連携の削除ボタン
Corgeaは連携名を示す確認画面を表示し、確認後に削除します。連携を削除しても、ワークスペースとCorgeaの接続が解除されるだけで、作成済みのLinear問題はそのまま残ります。
Linear連携を削除する前に表示された確認ページ
CorgeaをLinearと連携することで、セキュリティ脆弱性管理プロセスを効率化し、既存のワークフロー内で重要な問題を追跡・対処できます。