はじめに
自作の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で返すツールです。
補足
- 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自体に安全上の注記を常時含める設計にした
