攻撃を知り、防ぐ

サプライチェーン攻撃

依存パッケージに仕込まれる、インストール時に動くコードと、名前の似た偽パッケージを見つけ、スクリプトをサンドボックスで動かす方法を学びます。

  • レベル: 基礎
  • 約45分
  • 2026-11-13

#依存パッケージという入口

いまのアプリは、自分で書いたコードより、他人が書いたパッケージのほうが多くなりがちです。npm install を実行すると、自分で指定したパッケージだけでなく、そのパッケージが使う別のパッケージも、芋づる式に入ってきます。攻撃者は、その連なりのどこか 1 か所に入り込めば、それを使う人すべてに届きます。入り込み方は、おもに次の 3 つです。

手口起きること
乗っ取り正規のパッケージの公開権限を奪い、悪意ある版を公開する
偽物有名なパッケージに似せた名前(expresss など)で、偽のパッケージを公開する
仕込み正規に見えるパッケージに、インストール時に動くコードを入れる

実際にあった例です。2021 年 10 月、npm の人気パッケージ ua-parser-js の 3 つの版(0.7.29、0.8.0、1.0.0)で、悪意のあるコードが公開されました。修正版は 0.7.30、0.8.1、1.0.1 です(GitHub Advisory)。使う側の操作に誤りがあったわけではありません。いつもどおりに更新しただけで、入り込むおそれがありました。

なぜインストール時が狙われるのか

npm のパッケージは、preinstall、install、postinstall、prepare などの「ライフサイクルスクリプト」を持てます。これは、npm install を実行した人の権限で、インストールの途中に自動で実行されます。アプリを起動する前、コードを一行も読まないうちに、実行が終わります。

#インストール時に動くコードを一覧する

RoamSwitch の インストール時に動くコードの点検 は、node_modules の中にあるパッケージのライフサイクルスクリプトを、一覧にして見せます。何も実行しません。

スクリプトを持つパッケージを探す

無害なダミーを作ります。demo-helper はインストール時に動くスクリプトを持ち、plain-lib は持ちません。スクリプトが指す setup.js は存在しないので、実行されることもありません。

mkdir -p app/node_modules/demo-helper app/node_modules/plain-lib
echo '{ "name": "demo-helper", "version": "1.0.0", "scripts": { "postinstall": "node setup.js" } }' > app/node_modules/demo-helper/package.json
echo '{ "name": "plain-lib", "version": "2.0.0" }' > app/node_modules/plain-lib/package.json

# 確認済みの記録は ~/.config/roamswitch/ に保存されます。演習では、使い捨てのホームフォルダを使います
LAB_HOME=$(mktemp -d)
HOME=$LAB_HOME roamswitch scan-scripts ./app
出力の抜粋
  依存パッケージの取得元と公開直後の版に関する設定
  (…読む範囲の説明…)

  該当する設定は見つかりませんでした。

  これは脅威判定ではなく一覧表示です。何も実行しません。⚠️は誤検知を含む軽量ヒューリスティックです。

    demo-helper 1.0.0 [postinstall]
    node setup.js

  確認済みの状態がまだありません。今のインストールスクリプトを確認したら、roamswitch scan-scripts --accept を実行してください。次回からは、増えた分だけを知らせます。

スクリプトを持つ demo-helper だけが出て、持たない plain-lib は出ません。判定ではなく一覧なので、悪意があるかどうかは、人が見て判断します。終了コードは、一覧に何が出ても 0 です。

最初の段は、取得元と公開直後の版に関する設定の点検です。ロックファイルがないフォルダーなので、ここでは何も出ません。出る例は、「守りを組み立てる」の演習で見ます。

「増えた分」だけを知る

一覧を確認したら、その状態を確認済みとして記録します。次の更新で、スクリプトを持つパッケージが増えたときだけ、知らせが出ます。

HOME=$LAB_HOME roamswitch scan-scripts --accept ./app

# 更新で、新しいパッケージが入ったと仮定します
mkdir -p app/node_modules/new-helper
echo '{ "name": "new-helper", "version": "1.0.0", "scripts": { "install": "node build.js" } }' > app/node_modules/new-helper/package.json
HOME=$LAB_HOME roamswitch scan-scripts ./app
出力の抜粋
  確認済みの状態を記録しました。次回からは、増えた分だけを知らせます。

(…2 回目の一覧…)

    demo-helper 1.0.0 [postinstall]
    node setup.js

    new-helper 1.0.0 [install]
    node build.js

  確認済みにした日(2026-11-13)の後で、インストール時に動くコードが増えたパッケージが 1 件あります。

  ● new-helper  - → 1.0.0  新しいパッケージがインストール時のコードを持っています (install)

--accept を付けた実行でも、一覧はいつもどおり出て、最後に記録した旨の 1 行が加わります。

数百のパッケージがあるのに、毎回一覧を読み直すのは現実的ではありません。「前回から増えたか」だけを見るようにすると、ua-parser-js のように、いつもどおりの更新に紛れた変化に気づきやすくなります。

#名前の似たパッケージを見つける

偽物は、有名なパッケージの名前に似せて作られます。打ち間違いを狙うので、typosquatting(綴り違いを狙う攻撃)と呼ばれます。名前の似たパッケージの判定 は、package.json に書かれた依存パッケージの名前を、有名な名前と比べます。

綴りの違いを調べる
cat > app/package.json <<'EOF'
{ "name": "demo-app", "version": "1.0.0",
  "dependencies": { "express": "^4.0.0", "expresss": "^4.0.0", "reakt": "^18.0.0", "lodahs": "^4.17.0" } }
EOF
roamswitch scan-typosquat ./app
出力の抜粋
  これは静的な参考情報であり断定ではありません。ネットワーク接続は一切行いません。正規の類似パッケージが誤検知されることもあります。

  ⚠️  expresss は次に似ています: "express" (distance 1)  [./app]
  ⚠️  reakt は次に似ています: "react" (distance 1)  [./app]

expresss と reakt は見つかりました。express は正規の名前なので、出ません。一方、lodahs(lodash の綴りを入れ替えたもの)は出ていません。

ほかの綴り違いも、1 つずつ package.json に書いて試しました。見つからないときは「疑わしい依存関係名は見つかりませんでした。」と出ます。

名前本物との違い見つかったか
expresss1 文字の追加(express)見つかった
reakt1 文字の置き換え(react)見つかった
recat隣り合う 2 文字の入れ替え(react)見つからない
axois隣り合う 2 文字の入れ替え(axios)見つからない
loadsh隣り合う 2 文字の入れ替え(lodash)見つからない
lodahs隣り合う 2 文字の入れ替え(lodash)見つからない

試した範囲では、1 文字の追加・置き換えは見つかり、隣り合う文字の入れ替えは見つかりませんでした。「見つからなかった」ことは、安全の証明にはなりません。

#守りを組み立てる

RoamSwitch の一覧と検知は、対策の一部です。次のような対策を組み合わせます。

  • インストールを制御する: npm ci でロックファイルのとおりに入れます。スクリプトを実行したくないときは --ignore-scripts を付け、必要なパッケージにだけ、スクリプトを許します
  • 新しい版を、すぐには使わない: 公開された直後の版は使わず、数日待ちます。乗っ取られた版は、気づかれて取り下げられるまでの間が、いちばん危険です
  • スクリプトを閉じ込める: roamswitch install は、npm や pnpm の install を包みます。スクリプトは、~/.ssh などを空にしたサンドボックスの中だけで動きます(次の演習)
  • 増えた分を見る: 更新のたびに、「スクリプトを持つパッケージが増えたか」を確かめます
スクリプトから ~/.ssh が見えるかを比べる

roamswitch install は、まずスクリプトを止めて取得し(--ignore-scripts)、次にスクリプトだけを bwrap(bubblewrap)の中で動かします。中では ~/.ssh・~/.aws・~/.gnupg などが空のフォルダーに見えます。通信は許します(--help の説明)。

~/.ssh の中身を書き出すだけのダミーのパッケージを作り、ふつうの npm install と比べます。npm が要ります(Ubuntu では sudo apt-get install -y npm)。~/.ssh には、ダミーのメモを 1 つ置きます。この演習の VM では、roamswitch-server を一度も起動していません(理由は、失敗の例のあとに書きます)。

mkdir -p demo-pkg site ~/.ssh
echo 'dummy-not-a-key' > ~/.ssh/demo_note.txt
cat > demo-pkg/package.json <<'J'
{ "name": "demo-pkg", "version": "1.0.0",
  "scripts": { "postinstall": "ls -A ~/.ssh > seen.txt 2>&1 || true" } }
J
(cd demo-pkg && npm pack --silent >/dev/null)
cat > site/package.json <<'J'
{ "name": "site", "version": "1.0.0", "dependencies": { "demo-pkg": "file:../demo-pkg/demo-pkg-1.0.0.tgz" } }
J
cd site
npm install --silent; echo "npm install:"; cat node_modules/demo-pkg/seen.txt
rm -rf node_modules package-lock.json
roamswitch install --yes
echo "終了コード: $?"
ls
実行結果
npm install:
authorized_keys
demo_note.txt
=====================================================
  📦 サンドボックス実行付きインストール
=====================================================

  bwrap でサンドボックスを作れませんでした: bwrap: setting up uid map: Permission denied
  この OS では、AppArmor が一般ユーザーの名前空間の作成を止めています(kernel.apparmor_restrict_unprivileged_userns=1。Ubuntu 23.10 以降の既定)。bwrap に名前空間を許す AppArmor のプロファイルを入れるか、管理者が制限を外してください(sudo sysctl kernel.apparmor_restrict_unprivileged_userns=0。OS 全体でこの制限がなくなります)。
  サンドボックス無しでのライフサイクルスクリプト実行は行いません。
終了コード: 1
package.json

ふつうの npm install では、スクリプトから ~/.ssh の 2 つのファイルが見えました。roamswitch install は、Ubuntu 24.04 の既定では、サンドボックスを作れませんでした。AppArmor が、特権のない利用者の名前空間を制限しているためです。

このとき roamswitch install は、ダウンロードの前に止まり、終了コード 1 で終わります。ls のとおり、node_modules もできていません。サンドボックスなしでスクリプトを動かすことはしません。

Server Edition が動いているホストでは、事情が違います。roamswitch-server は、起動のときに kernel.unprivileged_userns_clone=0 を書きます(harden_userns_enabled、既定 true)。特権のない名前空間を使うカーネルの不具合への備えです。そのため、サービスが動いているホストでは、下のプロファイルを入れても、サンドボックスを作れません。

出力の抜粋
  bwrap でサンドボックスを作れませんでした: bwrap: No permissions to create new namespace, likely because the kernel does not allow non-privileged user namespaces. See <https://deb.li/bubblewrap> or <file:///usr/share/doc/bubblewrap/README.Debian.gz>.
  原因は RoamSwitch Server の設定です。harden_userns_enabled(既定でオン)により、roamswitch-server が起動のたびに kernel.unprivileged_userns_clone=0 を書き、一般ユーザーの名前空間の作成を止めています(CVE-2026-53362 の暫定策)。サンドボックスを使うには、sudo roamswitch server config set harden_userns_enabled false のあと sudo sysctl kernel.unprivileged_userns_clone=1 を実行します(OS の再起動でも戻ります。roamswitch-server の再起動では戻りません)。すでに false にしてあれば、sysctl だけで足ります。
  サンドボックス無しでのライフサイクルスクリプト実行は行いません。

上は、プロファイルを入れたあと、サービスを起動してから roamswitch install --yes を実行した出力の抜粋です。終了コードは 1 でした。案内は、原因が RoamSwitch Server の harden_userns_enabled であることと、戻し方を言います。

案内のとおり、設定を false にして sysctl で 1 に戻すと(変更を伴う操作です)、サンドボックスは動きました。そのあと sudo roamswitch server restart をしても、値は 1 のままでした。元に戻すには、sudo roamswitch server config set harden_userns_enabled true のあと sudo roamswitch server restart を実行します。値は 0 に戻りました。サービスを止めても、0 のままです。依存パッケージの組み立ては、本番のサーバーではなく、開発やビルドのマシンで行います。

bwrap にだけ名前空間を許す AppArmor のプロファイルを置き、もう一度入れます(変更を伴う操作です)。

sudo tee /etc/apparmor.d/bwrap >/dev/null <<'P'
abi <abi/4.0>,
include <tunables/global>

profile bwrap /usr/bin/bwrap flags=(unconfined) {
  userns,
}
P
sudo apparmor_parser -r /etc/apparmor.d/bwrap
rm -rf node_modules package-lock.json
roamswitch install --yes | sed -n '/②/,$p'
echo "seen:"; cat node_modules/demo-pkg/seen.txt; echo "(end)"
実行結果
  ② スクリプト実行フェーズ (サンドボックス内・ファイルシステム制限)…

rebuilt dependencies successfully
  ✓ 完了しました。
seen:
(end)

スクリプトは動きましたが、~/.ssh は空に見えました。同じ ls でも、サンドボックスの中からは、鍵の置き場所が読めません。

ロックファイルができたので、scan-scripts の最初の段にも指摘が出ます。

roamswitch scan-scripts . | grep -A1 'package-lock.json$'
実行結果
  ⚠ ./package-lock.json
    npm に、公開から日の浅い版を取り込まないための設定がありません(設定名: min-release-age (.npmrc))。悪意のある版が公開から数日のうちに見つかって取り下げられた例があり、一定の日数が過ぎた版だけを入れる設定があれば、その間は入らずに済みます。入っているパッケージに問題があるという指摘ではありません。

site/.npmrc に min-release-age=7 と書くと、この指摘は消え、「該当する設定は見つかりませんでした。」に戻ります。上の「新しい版を、すぐには使わない」を、設定として残せます。

元に戻すには、プロファイルを外して消し、ダミーを消します。

sudo apparmor_parser -R /etc/apparmor.d/bwrap && sudo rm /etc/apparmor.d/bwrap
cd ~ && rm -rf demo-pkg site ~/.ssh/demo_note.txt
やってはいけないこと
  • 一覧に出たからといって、すべてを悪意のあるものと決めつける。ビルドに必要な正規のスクリプトも、たくさんあります
  • 一覧に出ないからといって、安全だと決めつける(下の「見えない部分」を読んでください)

#見えない部分

点検が見つけられないもの
  • スクリプトの良し悪しは、判定しません。一覧に出るのは、スクリプトがあるという事実と、そのコマンドだけです。curl … | sh などの形に ⚠️ を付けるのは、誤検知を含む目安です
  • 入れ子の node_modules には、降りません(--help の説明)。一覧に出るのは、指定したフォルダーの node_modules の直下のパッケージです
  • サンドボックスは、bwrap が名前空間を作れるときだけです。作れないとき、roamswitch install はダウンロードの前に止まり、終了コード 1 で終わります。Server Edition が動いているホストでは、harden_userns_enabled のために作れません
  • スクリプトを使わない攻撃は、一覧に出ません。パッケージを読み込んだとき(require したとき)に動くコードは、ライフサイクルスクリプトではないので、対象外です
  • 名前の比較で見つかるのは、1 文字の追加と置き換えです(試した範囲)。隣り合う文字の入れ替えは、見つかりませんでした
  • 比べる相手は、有名なパッケージの名前の一覧です。その一覧にない名前に似せた偽物は、比べようがありません
確認問題

更新後に scan-scripts を実行しても、増えたパッケージは何も表示されませんでした。確実に言えるのはどれですか

解説を見る

見ているのは、「インストール時に動くコードを持つパッケージが増えたか」だけです。読み込み時に動くコードや、すでにスクリプトを持つパッケージの中身が変わったことは、この点検では分かりません。

#次に学ぶこと

扱う機能

対応する攻撃手法 (ATT&CK): T1195.001

確認した内容

2026-11-13に確認しました。対象は Linux 1.17.41 です。公開版 1.17.41 の入った使い捨ての Ubuntu 24.04 の VM で、無害なダミーの node_modules とダミーの npm パッケージに対して scan-scripts・scan-typosquat・roamswitch install を本文の順に日英で実行し、roamswitch-server を起動したときの roamswitch install の案内と、その案内どおりの戻し方も確かめました。

コマンドの出力は、製品の版や環境によって変わります。違いが出たら、まず製品の版を確かめてください。