ワークフロー
Jira と Linear
修正タスクを開発者が使う課題管理ツールに送ります。後のスキャンで修正が確認されると課題がクローズされ、誰かが課題をクローズするとタスクもクローズされます。
Team または Enterprise プランが必要です。チームのオーナーまたは管理者が連携ページでツールを接続すると、タスクを編集できる人なら誰でも送信できます。
Jira Cloud を接続
- 1
API トークンを作成
Atlassian アカウントで API トークンを開いて作成します。トークンはあなたとして動作するため、プロジェクトで課題を作成できるアカウントを使ってください。 - 2
Scanverra で接続
- 3
Scanverra が確認
保存する前にトークンとプロジェクトをテストします。トークンは暗号化され、再表示されることはありません。
Linear を接続
- 1
個人 API キーを作成
Linear で Security and access を開き、個人 API キーを作成します。 - 2
Scanverra で接続
連携で「Linear を接続」をクリックし、キーとチームキー (例:ENG) を入力します。
オプション
| フィールド | 説明 |
|---|---|
検出結果が割り当てられたら課題を作成オンまたはオフ任意 | 既定はオフです。オンにすると、検出結果を誰かに割り当てたときに課題も作成されます。 |
対象とする重大度critical、high、medium、low任意 | この重大度以上の検出結果だけが自動で課題になります。手動ならどれでも送信できます。 |
タスクが修正されたら課題をクローズオンまたはオフ任意 | 既定はオンです。課題は完了状態に移り、理由がコメントされます。 |
同期のしくみ
同期は1日1回、またはチームの管理者が連携ページで「今すぐ同期」をクリックしたときに実行されます。
スキャンで修正が確認された
タスクは Scanverra でクローズされ、次の同期で課題がコメント付きで完了になります。
誰かが課題をクローズした
次の同期で Scanverra のタスクがクローズされます。Remediation Hub では、他の変更と同じようにワークフローに沿って進みます。
手動で送信
タスクを開き、「Jira に送信」または「Linear に送信」を使います。1つのタスクに作成される課題は、ツールごとに最大1件です。
課題の内容
検出結果のタイトル、重大度、対象、説明と、レポート内の検出結果へのリンク。Jira の課題には
scanverraやseverity-highなどのラベルが、Linear の課題には対応する優先度が付きます。
トラブルシューティング
「認証情報が拒否されました」
トークンが無効化されたか、メールアドレスが一致していません。接続を解除し、新しいトークンで接続し直してください。
「Jira Cloud サイトを入力してください」
.atlassian.netで終わる Jira Cloud サイトのみ対応しています。「そのプロジェクトまたはチームが見つかりませんでした」
Jira のプロジェクトキー (SEC-12 のような課題キーに含まれます) または Linear のチーム設定にあるチームキーを確認してください。
「リクエストが制限されています」
短時間の呼び出しが多すぎます。そのツールの同期は停止し、次回に再試行されます。