0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

claude + cve-lite-cli + LEVでフロントエンドの脆弱性優先度判断を更に高める

0
Posted at
  • 前回の記事で、OWASPのcve-lite-cliの優先度(CVSS × EPSS)をClaude Skillへ渡し、最上位の1パッケージをAIに修正させる仕組みを作りました。
  • ただしEPSSは「今後30日で悪用される確率」であり、「既に悪用されているか」は表しません。
  • そこでNIST提案の LEV(Likely Exploited Vulnerabilities) を加え、「未来(EPSS)」と「過去(LEV)」の両面から優先度を決める方法を記録いたします。

概要

  • 前回導入したcve-lite-cliの検出結果に、脆弱性ごとの「LEV」を書き足します。
  • ClaudeにまずEPSSで緊急度を分類させて、その中ではLEVが高いものを先に選びます。
  • 選んだ1パッケージだけを修正し、最終確認は人間が行います。

LEVとは

  • NIST CSWP 41で提案された「脆弱性が過去に悪用された確率」の下限推定です。
  • LEVには、「30日おきのEPSSを使うLEV」と「毎日のEPSSを使うLEV2」があり、本記事では以下の理由からLEV2を利用します。
    • 取りこぼしがない: 30日おきの計算では、その間に一時的に跳ね上がったEPSSを見逃します。毎日の値を使うLEV2なら拾えます。
    • APIと相性が良い: EPSS APIのscope=time-seriesは日次の値を返すため、そのまま計算に使えます。
    • 計算が軽い: 本記事では当日 + 直近30日分に絞った簡易版とし、1リクエストで済ませます。
指標 問い 時間軸
EPSS これから悪用されるか 未来30日
LEV 既に悪用されたか 過去(本記事では直近31日)

環境

  • Node.js 18以上
  • cve-lite-cli v1.33.0 以上
  • Claude Code

前提

  • Node.jsプロジェクトがあること
  • 前回の記事を読んでおくことを推奨します

手順

スクリプト作成

  • 対象プロジェクトにscripts/lev.mjsを作成して、以下の内容を記述します。
#!/usr/bin/env node

// cve-lite のスキャン結果へ LEV を付与し、標準出力へ流す
import { spawnSync } from 'node:child_process';
import { mkdtempSync, readdirSync, readFileSync, rmSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';

// FIRST提供のEPSS API
const EPSS_API = 'https://api.first.org/data/v1/epss';

// cve-lite の --json はファイル出力のみのため、一時ディレクトリ経由で読む
const scan = () => {
  const dir = mkdtempSync(join(tmpdir(), 'cve-lite-'));
  try {
    spawnSync('cve-lite', ['.', '--check-maintenance', '--json', '--output', dir], { stdio: 'ignore' });
    return JSON.parse(readFileSync(join(dir, readdirSync(dir)[0]), 'utf8'));
  } finally {
    rmSync(dir, { recursive: true, force: true });
  }
};

// LEV2 = 1 − Π(1 − EPSS_d / 30)  NIST CSWP 41: https://doi.org/10.6028/NIST.CSWP.41
const lev2 = (daily) => 1 - daily.reduce((p, epss) => p * (1 - epss / 30), 1);

const fetchLevs = async (cves) => {
  if (!cves.length) return new Map();
  const url = `${EPSS_API}?cve=${cves.join(',')}&scope=time-series&limit=${cves.length}`;
  const { data } = await (await fetch(url)).json();
  // time-series は当日を含まない過去30日分のため、当日値 d と連結する
  return new Map(data.map((d) => [d.cve, +lev2([d, ...d['time-series']].map((p) => +p.epss)).toFixed(5)]));
};

const report = scan();
const levs = await fetchLevs([...new Set(report.findings.flatMap((f) => f.cves))]);
const withLev = (s) => ({ ...s, lev: levs.get(s.cve) ?? null });

const findings = report.findings.map((f) => {
  const epssScores = f.epssScores.map(withLev);
  return { ...f, epssScores, levMax: Math.max(0, ...epssScores.map((s) => s.lev ?? 0)) };
});

console.log(JSON.stringify({ ...report, findings }, null, 2));

scripts追加

  • package.json のscriptsに以下を追加します。
"cve:lev": "node scripts/lev.mjs"
  • npm run cve:levを実行して以下のように「lev」や「levMax」が追加されていることを確認。
{
   "cve": "CVE-xxx-xxx",
   "epss": 0.xxx,
   "percentile": 0.xxx,
   "lev": 0.xxx
 },
 {
   "cve": "CVE-xxx-xxx",
   "epss": 0.xxx,
   "percentile": 0.xxx,
   "lev": 0.xxx
 }

"levMax": 0.xxx

スキル作成

  • .claude/skills/cve-lev/SKILL.mdを作成して、以下の内容を記述します。
---
name: cve-lev
description: cve-lite-cliのJSON出力にLEVを付与し、EPSS優先度とLEVで最上位の1パッケージを修正する
argument-hint: "[<package名> | --all | --dry-run]"
---

- 引数
  - 引数なし:優先度最上位の1パッケージを修正
  - `<package名>`:指定したパッケージだけを修正
  - `--all`:優先度順に全パッケージを修正
  - `--dry-run`:修正はせず、判定結果だけ報告

### やること
- `npm run cve:lev`の出力(cve-lite-cliのJSON + LEV)を読み込み、**優先度が一番高い脆弱性を1つだけ**修正する。
- 1回の実行で1パッケージだけ直す。

### 指標
- `prioritySignal`:cve-lite-cliのEPSS優先度。これから悪用される見込み。
- `levMax`:finding内CVEのLEV最大値。過去30日で既に悪用された見込み。
- `epssScores[].lev`:CVEごとのLEV。取れない場合は`null`。

### 優先度の決め方
- まず`prioritySignal`で4段階に分ける。
  - `fix_now`:危険度高 + 悪用される確率も高い → 即修正
  - `fix_soon`:危険度高、悪用確率は低い → 修正
  - `monitor` / `low_priority`:危険度低め → メジャーバージョンが変わらない範囲で修正
  - EPSSが取れない場合は、深刻度だけで代わりに判断する
- 同じ段階の中では`levMax`の高い順に並べる。

### 修正のやり方は3パターン
- **自動**:メジャーバージョンが変わらない → 提示された修正コマンド(`runnableFixCommand`)をそのまま実行
- **手動**:メジャーバージョンが変わる → 変更履歴を確認し、壊れる箇所をコードごと直す
- **保留**:直せる修正版がない → 内容だけ報告

### 報告
- 対象パッケージ、`prioritySignal`、`levMax`と該当CVE、修正パターン、実行コマンドを箇条書きで簡潔に。

### 修正後
- テスト・ビルド・`npm run cve:lev`の再実行で確認する。
  • ※前回からの差分は「指標」と「同じ段階の中ではlevMaxの高い順」の2点のみです。

スキル実行

  • Claude Codeを開き、以下を入力して実行します。実際の修正は行わず、修正結果の確認のみです。
/cve-lev --dry-run
  • 実行後、優先度最上位の1パッケージについて、判定内容と修正案が提示されることを確認します。
    • ※結果は対象プロジェクトによって変わります。以下は自身のサンプルプロジェクトでの結果です

cve-lev.png

  • 実際の修正は/cve-levを引数なしで実行することで行えます。

まとめ

  • 未来(EPSS)と過去(LEV)の2軸で優先度判断をより効率的にできるようになりました。
  • これら以外にも判断材料はありますが、「検知→優先度判断→修正」の仕組みは変わらないので、より楽で安全な仕組みを適宜作成しようと感じました。

参考

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?