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?

ServiceNow MCPにおいて、Update Setに対するSCAチェックを行う機能を実装してみた

0
Last updated at Posted at 2026-08-26

はじめに

自作のServiceNow MCPサーバー(tedorigawa001/ServiceNow-MCP、npm公開中)に、**Update Set SCA(Software Composition Analysis)**という新機能を実装しました。

Update Setには、Business RuleやClient ScriptなどのカスタムJavaScriptが大量に詰め込まれます。その中に、CDNから読み込んだ古いバージョンのライブラリがそのまま埋め込まれていても、通常のServiceNow運用フローでは気づく手段がありません。
scan_update_set_sca は、Update Set内のスクリプトを読み取り専用で走査し、含まれる第三者コンポーネントとその既知の脆弱性を、AIが解釈しやすいJSONで返すツールです。

image.png

補足

  • BR、Script Include、Script Action などサーバー側
    npm install や URL の require/import はできません。
    ServiceNow のサーバー実行環境へ任意の Node.js パッケージを追加する方式ではありません。
  • UI Script、Client Script、Service Portal Widget などクライアント側
    ブラウザで実行されるため、技術的に外部 CDN の JavaScript を読み込んで利用可能です。

Client Script(Isolateオフを選択)

function onLoad() {
  var script = document.createElement('script');
  script.src = 'https://cdn.jsdelivr.net/npm/lodash@4.17.21/lodash.min.js';
  script.onload = function () {
    g_form.addInfoMessage('MCP CDN test: lodash ' + window._.VERSION + ' loaded');
  };
  script.onerror = function () {
    g_form.addErrorMessage('MCP CDN test: lodash could not be loaded');
  };
  document.head.appendChild(script);
}

全体の流れ

安全設計: 「ソースコードは一切返さない」

このツールが扱うのはカスタムスクリプトの中身なので、実装の最初から「何を返さないか」を強く意識しました。

  • payload本文・抽出したスクリプトテキストは一切結果に含めない。
    返すのはバイト数とSHA-256ハッシュのみ
  • コンポーネント名・バージョンという「識別に必要な最小限の情報」だけは平文で返す(これがSCAの目的そのものなので)が、マッチした周辺のソースコードはハッシュ化するだけ
  • 512KiB超のpayloadはスキップ(内容を読み込む前にサイズだけ確認)
  • OSVからのレスポンスもストリーミングで読みながら2MiB超で即座に打ち切り(Content-Lengthヘッダーの詐称・欠落どちらにも耐える)
async function readBoundedResponse(response: Response): Promise<string> {
  const reader = response.body.getReader();
  const chunks: Uint8Array[] = [];
  let totalBytes = 0;
  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    totalBytes += value.byteLength;
    if (totalBytes > MAX_OSV_RESPONSE_BYTES) {
      await reader.cancel();
      throw new Error('OSV response exceeds size limit');
    }
    chunks.push(value);
  }
  return Buffer.concat(chunks).toString('utf8');
}

実機E2E: 本物のlodash脆弱性を検出する

PDI上の実在するUpdate Setに対して読み取り専用でスキャンし、preview_update_set の結果と整合するかを確認する自動テストを追加しました。
さらに、意図的に古いバージョンのlodashをCDN参照で仕込んだBusiness Ruleと、dayjsを仕込んだUI Scriptを含むテスト用Update Setを実機に作成し、実際にスキャンしてみました。

{
  "components": [
    { "name": "dayjs", "version": "1.11.13", "purl": "pkg:npm/dayjs@1.11.13" },
    { "name": "lodash", "version": "4.17.21", "purl": "pkg:npm/lodash@4.17.21" }
  ],
  "findings": [
    {
      "component": "lodash", "installed_version": "4.17.21",
      "advisory_id": "GHSA-r5fr-rjxr-66jc", "severity": "high",
      "summary": "lodash vulnerable to Code Injection via `_.template` imports key names",
      "fixed_versions": ["4.18.0"]
    }
    // ... 他2件のadvisory(prototype pollution系)
  ],
  "summary": {
    "assessment": "completed_with_bounded_coverage",
    "safety_note": "No findings does not prove the Update Set or its dependencies are free of vulnerabilities."
  }
}

lodash@4.17.21(執筆時点で最新に近いが、いくつかのCVEが未修正のまま残っているバージョン)に対して、OSVから実際に3件のadvisoryが返ってきました。高severityの _.template コードインジェクション(CVE-2021-23337)を含みます。一方 dayjs@1.11.13 は既知の脆弱性なしと判定されています。パイプライン全体が「本物の脆弱なコンポーネント」に対して意図通りに動作することを確認できました。

「見つからない」は「安全」ではない

結果のJSONには常に summary.safety_note として「findings が空でも、Update Setやその依存関係に脆弱性が無いことを証明するものではない」という一文を含めています。理由は複数あります。

  • OSV照会は1スキャンあたり最大50コンポーネント、1コンポーネントあたり5秒でタイムアウトするため、超過分は unqueried_components として明示され、assessment は自動的に incomplete_coverage になる
  • バージョン範囲・CDN alias・バージョンなしのモジュール参照は unresolved_references に分離され、そもそもOSVに照会しない
  • このツールはあくまでSCA(依存コンポーネントのバージョン照合)であり、ServiceNowカスタムスクリプト自体の安全でないAPI利用・権限設計・クエリインジェクションなどを検出するSAST(静的解析)の代替にはならない

README側では、AIに報告させる際のプロンプト例として「summary.assessment・lookup.status・errors・unresolved_references・truncated を必ず確認し、対象外・未照会・失敗を『脆弱性なし』と表現しない」ことを明記し、AIが結果を都合よく丸めてしまわないよう釘を刺しています。

まとめ

  • Update Set内のスクリプトから、npmコンポーネントとその既知の脆弱性を、ソースコードを一切返さずに検出するツールを実装した
  • 実機に意図的に脆弱なコンポーネントを仕込んだUpdate Setを用意してスキャンし、本物のCVE(lodashの高severity advisory)を検出できることを確認した
  • 「検出0件 = 安全」という誤読を防ぐため、結果JSON自体に安全上の注記を常時含める設計にした
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?